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

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.

    Create Tunnel Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Tunnel(name: string, args?: TunnelArgs, opts?: CustomResourceOptions);
    @overload
    def Tunnel(resource_name: str,
               args: Optional[TunnelArgs] = None,
               opts: Optional[ResourceOptions] = None)
    
    @overload
    def Tunnel(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               description: Optional[str] = None,
               destination_config: Optional[TunnelDestinationConfigArgs] = None,
               tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
               timeout_config: Optional[TunnelTimeoutConfigArgs] = None)
    func NewTunnel(ctx *Context, name string, args *TunnelArgs, opts ...ResourceOption) (*Tunnel, error)
    public Tunnel(string name, TunnelArgs? args = null, CustomResourceOptions? opts = null)
    public Tunnel(String name, TunnelArgs args)
    public Tunnel(String name, TunnelArgs args, CustomResourceOptions options)
    
    type: aws-native:iotsecuretunneling:Tunnel
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_iotsecuretunneling_tunnel" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args TunnelArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TunnelArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TunnelArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TunnelArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TunnelArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Tunnel Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Tunnel resource accepts the following input properties:

    Description string
    A short text description of the tunnel.
    DestinationConfig Pulumi.AwsNative.IoTSecureTunneling.Inputs.TunnelDestinationConfig
    The destination configuration for the tunnel.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    A collection of tag metadata.
    TimeoutConfig Pulumi.AwsNative.IoTSecureTunneling.Inputs.TunnelTimeoutConfig
    Timeout configuration for the tunnel.
    Description string
    A short text description of the tunnel.
    DestinationConfig TunnelDestinationConfigArgs
    The destination configuration for the tunnel.
    Tags TagArgs
    A collection of tag metadata.
    TimeoutConfig TunnelTimeoutConfigArgs
    Timeout configuration for the tunnel.
    description string
    A short text description of the tunnel.
    destination_config object
    The destination configuration for the tunnel.
    tags list(object)
    A collection of tag metadata.
    timeout_config object
    Timeout configuration for the tunnel.
    description String
    A short text description of the tunnel.
    destinationConfig TunnelDestinationConfig
    The destination configuration for the tunnel.
    tags List<Tag>
    A collection of tag metadata.
    timeoutConfig TunnelTimeoutConfig
    Timeout configuration for the tunnel.
    description string
    A short text description of the tunnel.
    destinationConfig TunnelDestinationConfig
    The destination configuration for the tunnel.
    tags Tag[]
    A collection of tag metadata.
    timeoutConfig TunnelTimeoutConfig
    Timeout configuration for the tunnel.
    description str
    A short text description of the tunnel.
    destination_config TunnelDestinationConfigArgs
    The destination configuration for the tunnel.
    tags Sequence[TagArgs]
    A collection of tag metadata.
    timeout_config TunnelTimeoutConfigArgs
    Timeout configuration for the tunnel.
    description String
    A short text description of the tunnel.
    destinationConfig Property Map
    The destination configuration for the tunnel.
    tags List<Property Map>
    A collection of tag metadata.
    timeoutConfig Property Map
    Timeout configuration for the tunnel.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Tunnel resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Status Pulumi.AwsNative.IoTSecureTunneling.TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    TunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    TunnelId string
    A unique alpha-numeric tunnel ID.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    TunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    TunnelId string
    A unique alpha-numeric tunnel ID.
    id string
    The provider-assigned unique ID for this managed resource.
    status "OPEN" | "CLOSED"
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tunnel_arn string
    The Amazon Resource Name (ARN) of the tunnel.
    tunnel_id string
    A unique alpha-numeric tunnel ID.
    id String
    The provider-assigned unique ID for this managed resource.
    status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tunnelArn String
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelId String
    A unique alpha-numeric tunnel ID.
    id string
    The provider-assigned unique ID for this managed resource.
    status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tunnelArn string
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelId string
    A unique alpha-numeric tunnel ID.
    id str
    The provider-assigned unique ID for this managed resource.
    status TunnelStatus
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tunnel_arn str
    The Amazon Resource Name (ARN) of the tunnel.
    tunnel_id str
    A unique alpha-numeric tunnel ID.
    id String
    The provider-assigned unique ID for this managed resource.
    status "OPEN" | "CLOSED"
    The status of the tunnel. Valid values are OPEN and CLOSED.
    tunnelArn String
    The Amazon Resource Name (ARN) of the tunnel.
    tunnelId String
    A unique alpha-numeric tunnel ID.

    Supporting Types

    Tag, TagArgs

    A set of tags to apply to the resource.
    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

    TunnelDestinationConfig, TunnelDestinationConfigArgs

    The destination configuration.
    Services List<string>
    A list of service names that identify the target application.
    ThingName string
    The name of the IoT thing to which you want to connect.
    Services []string
    A list of service names that identify the target application.
    ThingName string
    The name of the IoT thing to which you want to connect.
    services list(string)
    A list of service names that identify the target application.
    thing_name string
    The name of the IoT thing to which you want to connect.
    services List<String>
    A list of service names that identify the target application.
    thingName String
    The name of the IoT thing to which you want to connect.
    services string[]
    A list of service names that identify the target application.
    thingName string
    The name of the IoT thing to which you want to connect.
    services Sequence[str]
    A list of service names that identify the target application.
    thing_name str
    The name of the IoT thing to which you want to connect.
    services List<String>
    A list of service names that identify the target application.
    thingName String
    The name of the IoT thing to which you want to connect.

    TunnelStatus, TunnelStatusArgs

    Open
    OPEN
    Closed
    CLOSED
    TunnelStatusOpen
    OPEN
    TunnelStatusClosed
    CLOSED
    "OPEN"
    OPEN
    "CLOSED"
    CLOSED
    Open
    OPEN
    Closed
    CLOSED
    Open
    OPEN
    Closed
    CLOSED
    OPEN
    OPEN
    CLOSED
    CLOSED
    "OPEN"
    OPEN
    "CLOSED"
    CLOSED

    TunnelTimeoutConfig, TunnelTimeoutConfigArgs

    Tunnel timeout configuration.
    MaxLifetimeTimeoutMinutes int
    The maximum amount of time (in minutes) a tunnel can remain open.
    MaxLifetimeTimeoutMinutes int
    The maximum amount of time (in minutes) a tunnel can remain open.
    max_lifetime_timeout_minutes number
    The maximum amount of time (in minutes) a tunnel can remain open.
    maxLifetimeTimeoutMinutes Integer
    The maximum amount of time (in minutes) a tunnel can remain open.
    maxLifetimeTimeoutMinutes number
    The maximum amount of time (in minutes) a tunnel can remain open.
    max_lifetime_timeout_minutes int
    The maximum amount of time (in minutes) a tunnel can remain open.
    maxLifetimeTimeoutMinutes Number
    The maximum amount of time (in minutes) a tunnel can remain open.

    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