1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. iotsecuretunneling
  6. getTunnel

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.79.0
published on Monday, Sep 14, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.79.0
published on Monday, Sep 14, 2026 by Pulumi

    A connection between a source computer and a destination device using AWS IoT Secure Tunneling.

    Using getTunnel

    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 getTunnel(args: GetTunnelArgs, opts?: InvokeOptions): Promise<GetTunnelResult>
    function getTunnelOutput(args: GetTunnelOutputArgs, opts?: InvokeOutputOptions): Output<GetTunnelResult>
    def get_tunnel(tunnel_arn: Optional[str] = None,
                   opts: Optional[InvokeOptions] = None) -> GetTunnelResult
    def get_tunnel_output(tunnel_arn: pulumi.Input[Optional[str]] = None,
                   opts: Optional[InvokeOutputOptions] = None) -> Output[GetTunnelResult]
    func LookupTunnel(ctx *Context, args *LookupTunnelArgs, opts ...InvokeOption) (*LookupTunnelResult, error)
    func LookupTunnelOutput(ctx *Context, args *LookupTunnelOutputArgs, opts ...InvokeOption) LookupTunnelResultOutput

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

    public static class GetTunnel 
    {
        public static Task<GetTunnelResult> InvokeAsync(GetTunnelArgs args, InvokeOptions? opts = null)
        public static Output<GetTunnelResult> Invoke(GetTunnelInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetTunnelResult> Invoke(GetTunnelInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetTunnelResult> getTunnel(GetTunnelArgs args, InvokeOptions options)
    public static Output<GetTunnelResult> getTunnel(GetTunnelArgs args, InvokeOptions options)
    public static Output<GetTunnelResult> getTunnel(GetTunnelArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:iotsecuretunneling:getTunnel
      arguments:
        # arguments dictionary
    data "aws-native_iotsecuretunneling_get_tunnel" "name" {
        # arguments
    }

    The following arguments are supported:

    TunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    TunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    tunnel_arn string
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelArn String
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    tunnel_arn str
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelArn String
    The Amazon Resource Name (ARN) of the tunnel.

    getTunnel Result

    The following output properties are available:

    Status Pulumi.AwsNative.IoTSecureTunneling.TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    A collection of tag metadata.
    TunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    TunnelId string
    A unique alpha-numeric tunnel ID.
    Status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    Tags Tag
    A collection of tag metadata.
    TunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    TunnelId string
    A unique alpha-numeric tunnel ID.
    status "OPEN" | "CLOSED"
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tags list(object)
    A collection of tag metadata.
    tunnel_arn string
    The Amazon Resource Name (ARN) of the tunnel.
    tunnel_id string
    A unique alpha-numeric tunnel ID.
    status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tags List<Tag>
    A collection of tag metadata.
    tunnelArn String
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelId String
    A unique alpha-numeric tunnel ID.
    status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tags Tag[]
    A collection of tag metadata.
    tunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelId string
    A unique alpha-numeric tunnel ID.
    status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tags Sequence[root_Tag]
    A collection of tag metadata.
    tunnel_arn str
    The Amazon Resource Name (ARN) of the tunnel.
    tunnel_id str
    A unique alpha-numeric tunnel ID.
    status "OPEN" | "CLOSED"
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tags List<Property Map>
    A collection of tag metadata.
    tunnelArn String
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelId String
    A unique alpha-numeric tunnel ID.

    Supporting Types

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    TunnelStatus

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.79.0
    published on Monday, Sep 14, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial