1. Packages
  2. Ibm Provider
  3. API Docs
  4. getTgConnectionPrefixFilters
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm.getTgConnectionPrefixFilters

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

    Retrieve information of existing IBM Cloud infrastructure transit gateway connection prefix filters as a read only data source. For more information about Transit Gateway Prefix filters, see adding and deleting prefix filters.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const tgPrefixFilters = ibm.getTgConnectionPrefixFilters({
        gateway: ibm_tg_gateway.new_tg_gw.id,
        connectionId: ibm_tg_connection.test_ibm_tg_connection.connection_id,
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    tg_prefix_filters = ibm.get_tg_connection_prefix_filters(gateway=ibm_tg_gateway["new_tg_gw"]["id"],
        connection_id=ibm_tg_connection["test_ibm_tg_connection"]["connection_id"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.GetTgConnectionPrefixFilters(ctx, &ibm.GetTgConnectionPrefixFiltersArgs{
    			Gateway:      ibm_tg_gateway.New_tg_gw.Id,
    			ConnectionId: ibm_tg_connection.Test_ibm_tg_connection.Connection_id,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var tgPrefixFilters = Ibm.GetTgConnectionPrefixFilters.Invoke(new()
        {
            Gateway = ibm_tg_gateway.New_tg_gw.Id,
            ConnectionId = ibm_tg_connection.Test_ibm_tg_connection.Connection_id,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IbmFunctions;
    import com.pulumi.ibm.inputs.GetTgConnectionPrefixFiltersArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var tgPrefixFilters = IbmFunctions.getTgConnectionPrefixFilters(GetTgConnectionPrefixFiltersArgs.builder()
                .gateway(ibm_tg_gateway.new_tg_gw().id())
                .connectionId(ibm_tg_connection.test_ibm_tg_connection().connection_id())
                .build());
    
        }
    }
    
    variables:
      tgPrefixFilters:
        fn::invoke:
          function: ibm:getTgConnectionPrefixFilters
          arguments:
            gateway: ${ibm_tg_gateway.new_tg_gw.id}
            connectionId: ${ibm_tg_connection.test_ibm_tg_connection.connection_id}
    

    Using getTgConnectionPrefixFilters

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getTgConnectionPrefixFilters(args: GetTgConnectionPrefixFiltersArgs, opts?: InvokeOptions): Promise<GetTgConnectionPrefixFiltersResult>
    function getTgConnectionPrefixFiltersOutput(args: GetTgConnectionPrefixFiltersOutputArgs, opts?: InvokeOptions): Output<GetTgConnectionPrefixFiltersResult>
    def get_tg_connection_prefix_filters(connection_id: Optional[str] = None,
                                         gateway: Optional[str] = None,
                                         id: Optional[str] = None,
                                         opts: Optional[InvokeOptions] = None) -> GetTgConnectionPrefixFiltersResult
    def get_tg_connection_prefix_filters_output(connection_id: Optional[pulumi.Input[str]] = None,
                                         gateway: Optional[pulumi.Input[str]] = None,
                                         id: Optional[pulumi.Input[str]] = None,
                                         opts: Optional[InvokeOptions] = None) -> Output[GetTgConnectionPrefixFiltersResult]
    func GetTgConnectionPrefixFilters(ctx *Context, args *GetTgConnectionPrefixFiltersArgs, opts ...InvokeOption) (*GetTgConnectionPrefixFiltersResult, error)
    func GetTgConnectionPrefixFiltersOutput(ctx *Context, args *GetTgConnectionPrefixFiltersOutputArgs, opts ...InvokeOption) GetTgConnectionPrefixFiltersResultOutput

    > Note: This function is named GetTgConnectionPrefixFilters in the Go SDK.

    public static class GetTgConnectionPrefixFilters 
    {
        public static Task<GetTgConnectionPrefixFiltersResult> InvokeAsync(GetTgConnectionPrefixFiltersArgs args, InvokeOptions? opts = null)
        public static Output<GetTgConnectionPrefixFiltersResult> Invoke(GetTgConnectionPrefixFiltersInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetTgConnectionPrefixFiltersResult> getTgConnectionPrefixFilters(GetTgConnectionPrefixFiltersArgs args, InvokeOptions options)
    public static Output<GetTgConnectionPrefixFiltersResult> getTgConnectionPrefixFilters(GetTgConnectionPrefixFiltersArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getTgConnectionPrefixFilters:getTgConnectionPrefixFilters
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ConnectionId string
    The unique identifier of the gateway connection
    Gateway string
    The unique identifier of the gateway.
    Id string
    (String) The unique identifier of this prefix filter.
    ConnectionId string
    The unique identifier of the gateway connection
    Gateway string
    The unique identifier of the gateway.
    Id string
    (String) The unique identifier of this prefix filter.
    connectionId String
    The unique identifier of the gateway connection
    gateway String
    The unique identifier of the gateway.
    id String
    (String) The unique identifier of this prefix filter.
    connectionId string
    The unique identifier of the gateway connection
    gateway string
    The unique identifier of the gateway.
    id string
    (String) The unique identifier of this prefix filter.
    connection_id str
    The unique identifier of the gateway connection
    gateway str
    The unique identifier of the gateway.
    id str
    (String) The unique identifier of this prefix filter.
    connectionId String
    The unique identifier of the gateway connection
    gateway String
    The unique identifier of the gateway.
    id String
    (String) The unique identifier of this prefix filter.

    getTgConnectionPrefixFilters Result

    The following output properties are available:

    ConnectionId string
    Gateway string
    Id string
    (String) The unique identifier of this prefix filter.
    PrefixFilters List<GetTgConnectionPrefixFiltersPrefixFilter>
    (String) List of all prefix filters for the transit gateway connection
    ConnectionId string
    Gateway string
    Id string
    (String) The unique identifier of this prefix filter.
    PrefixFilters []GetTgConnectionPrefixFiltersPrefixFilter
    (String) List of all prefix filters for the transit gateway connection
    connectionId String
    gateway String
    id String
    (String) The unique identifier of this prefix filter.
    prefixFilters List<GetTgConnectionPrefixFiltersPrefixFilter>
    (String) List of all prefix filters for the transit gateway connection
    connectionId string
    gateway string
    id string
    (String) The unique identifier of this prefix filter.
    prefixFilters GetTgConnectionPrefixFiltersPrefixFilter[]
    (String) List of all prefix filters for the transit gateway connection
    connection_id str
    gateway str
    id str
    (String) The unique identifier of this prefix filter.
    prefix_filters Sequence[GetTgConnectionPrefixFiltersPrefixFilter]
    (String) List of all prefix filters for the transit gateway connection
    connectionId String
    gateway String
    id String
    (String) The unique identifier of this prefix filter.
    prefixFilters List<Property Map>
    (String) List of all prefix filters for the transit gateway connection

    Supporting Types

    GetTgConnectionPrefixFiltersPrefixFilter

    Action string
    (String) Whether to permit or deny the prefix filter
    Before string
    (String) Identifier of prefix filter that handles the ordering and follow semantics. When a filter reference another filter in it's before field, then the filter making the reference is applied before the referenced filter. For example: if filter A references filter B in its before field, A is applied before B.
    CreatedAt string
    (String) The date and time resource is created.
    Ge double
    (Int) The IP Prefix GE. The GE (greater than or equal to) value can be included to match all less-specific prefixes within a parent prefix above a certain length.
    Id string
    (String) The unique identifier of this prefix filter.
    Le double
    (Int) The IP Prefix LE. The LE (less than or equal to) value can be included to match all more-specific prefixes within a parent prefix up to a certain length.
    Prefix string
    (String) The IP Prefix
    UpdatedAt string
    (String) The date and time resource is last updated.
    Action string
    (String) Whether to permit or deny the prefix filter
    Before string
    (String) Identifier of prefix filter that handles the ordering and follow semantics. When a filter reference another filter in it's before field, then the filter making the reference is applied before the referenced filter. For example: if filter A references filter B in its before field, A is applied before B.
    CreatedAt string
    (String) The date and time resource is created.
    Ge float64
    (Int) The IP Prefix GE. The GE (greater than or equal to) value can be included to match all less-specific prefixes within a parent prefix above a certain length.
    Id string
    (String) The unique identifier of this prefix filter.
    Le float64
    (Int) The IP Prefix LE. The LE (less than or equal to) value can be included to match all more-specific prefixes within a parent prefix up to a certain length.
    Prefix string
    (String) The IP Prefix
    UpdatedAt string
    (String) The date and time resource is last updated.
    action String
    (String) Whether to permit or deny the prefix filter
    before String
    (String) Identifier of prefix filter that handles the ordering and follow semantics. When a filter reference another filter in it's before field, then the filter making the reference is applied before the referenced filter. For example: if filter A references filter B in its before field, A is applied before B.
    createdAt String
    (String) The date and time resource is created.
    ge Double
    (Int) The IP Prefix GE. The GE (greater than or equal to) value can be included to match all less-specific prefixes within a parent prefix above a certain length.
    id String
    (String) The unique identifier of this prefix filter.
    le Double
    (Int) The IP Prefix LE. The LE (less than or equal to) value can be included to match all more-specific prefixes within a parent prefix up to a certain length.
    prefix String
    (String) The IP Prefix
    updatedAt String
    (String) The date and time resource is last updated.
    action string
    (String) Whether to permit or deny the prefix filter
    before string
    (String) Identifier of prefix filter that handles the ordering and follow semantics. When a filter reference another filter in it's before field, then the filter making the reference is applied before the referenced filter. For example: if filter A references filter B in its before field, A is applied before B.
    createdAt string
    (String) The date and time resource is created.
    ge number
    (Int) The IP Prefix GE. The GE (greater than or equal to) value can be included to match all less-specific prefixes within a parent prefix above a certain length.
    id string
    (String) The unique identifier of this prefix filter.
    le number
    (Int) The IP Prefix LE. The LE (less than or equal to) value can be included to match all more-specific prefixes within a parent prefix up to a certain length.
    prefix string
    (String) The IP Prefix
    updatedAt string
    (String) The date and time resource is last updated.
    action str
    (String) Whether to permit or deny the prefix filter
    before str
    (String) Identifier of prefix filter that handles the ordering and follow semantics. When a filter reference another filter in it's before field, then the filter making the reference is applied before the referenced filter. For example: if filter A references filter B in its before field, A is applied before B.
    created_at str
    (String) The date and time resource is created.
    ge float
    (Int) The IP Prefix GE. The GE (greater than or equal to) value can be included to match all less-specific prefixes within a parent prefix above a certain length.
    id str
    (String) The unique identifier of this prefix filter.
    le float
    (Int) The IP Prefix LE. The LE (less than or equal to) value can be included to match all more-specific prefixes within a parent prefix up to a certain length.
    prefix str
    (String) The IP Prefix
    updated_at str
    (String) The date and time resource is last updated.
    action String
    (String) Whether to permit or deny the prefix filter
    before String
    (String) Identifier of prefix filter that handles the ordering and follow semantics. When a filter reference another filter in it's before field, then the filter making the reference is applied before the referenced filter. For example: if filter A references filter B in its before field, A is applied before B.
    createdAt String
    (String) The date and time resource is created.
    ge Number
    (Int) The IP Prefix GE. The GE (greater than or equal to) value can be included to match all less-specific prefixes within a parent prefix above a certain length.
    id String
    (String) The unique identifier of this prefix filter.
    le Number
    (Int) The IP Prefix LE. The LE (less than or equal to) value can be included to match all more-specific prefixes within a parent prefix up to a certain length.
    prefix String
    (String) The IP Prefix
    updatedAt String
    (String) The date and time resource is last updated.

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud