1. Packages
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. interconnect
  6. Connection

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

Viewing docs for AWS Cloud Control v1.62.0
published on Monday, Apr 20, 2026 by Pulumi
aws-native logo

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

Viewing docs for AWS Cloud Control v1.62.0
published on Monday, Apr 20, 2026 by Pulumi

    Resource Type definition for AWS::Interconnect::Connection. Creates a managed network connection between AWS and a partner cloud service provider.

    Create Connection Resource

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

    Constructor syntax

    new Connection(name: string, args: ConnectionArgs, opts?: CustomResourceOptions);
    @overload
    def Connection(resource_name: str,
                   args: ConnectionArgs,
                   opts: Optional[ResourceOptions] = None)
    
    @overload
    def Connection(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   attach_point: Optional[ConnectionAttachPointArgs] = None,
                   activation_key: Optional[str] = None,
                   bandwidth: Optional[str] = None,
                   description: Optional[str] = None,
                   environment_id: Optional[str] = None,
                   remote_owner_account: Optional[str] = None,
                   tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewConnection(ctx *Context, name string, args ConnectionArgs, opts ...ResourceOption) (*Connection, error)
    public Connection(string name, ConnectionArgs args, CustomResourceOptions? opts = null)
    public Connection(String name, ConnectionArgs args)
    public Connection(String name, ConnectionArgs args, CustomResourceOptions options)
    
    type: aws-native:interconnect:Connection
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args ConnectionArgs
    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 ConnectionArgs
    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 ConnectionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ConnectionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ConnectionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Connection 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 Connection resource accepts the following input properties:

    AttachPoint Pulumi.AwsNative.Interconnect.Inputs.ConnectionAttachPoint
    The logical attachment point in your AWS network where the managed connection will be connected.
    ActivationKey string
    The activation key for accepting a connection proposal from a partner CSP. Mutually exclusive with EnvironmentId.
    Bandwidth string
    The bandwidth of the connection (e.g., 50Mbps, 1Gbps). Required when creating a connection through AWS.
    Description string
    A description of the connection.
    EnvironmentId string
    The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
    RemoteOwnerAccount string
    The account ID of the remote owner. Required when creating a connection through AWS.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    An array of key-value pairs to apply to this resource.
    AttachPoint ConnectionAttachPointArgs
    The logical attachment point in your AWS network where the managed connection will be connected.
    ActivationKey string
    The activation key for accepting a connection proposal from a partner CSP. Mutually exclusive with EnvironmentId.
    Bandwidth string
    The bandwidth of the connection (e.g., 50Mbps, 1Gbps). Required when creating a connection through AWS.
    Description string
    A description of the connection.
    EnvironmentId string
    The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
    RemoteOwnerAccount string
    The account ID of the remote owner. Required when creating a connection through AWS.
    Tags TagArgs
    An array of key-value pairs to apply to this resource.
    attachPoint ConnectionAttachPoint
    The logical attachment point in your AWS network where the managed connection will be connected.
    activationKey String
    The activation key for accepting a connection proposal from a partner CSP. Mutually exclusive with EnvironmentId.
    bandwidth String
    The bandwidth of the connection (e.g., 50Mbps, 1Gbps). Required when creating a connection through AWS.
    description String
    A description of the connection.
    environmentId String
    The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
    remoteOwnerAccount String
    The account ID of the remote owner. Required when creating a connection through AWS.
    tags List<Tag>
    An array of key-value pairs to apply to this resource.
    attachPoint ConnectionAttachPoint
    The logical attachment point in your AWS network where the managed connection will be connected.
    activationKey string
    The activation key for accepting a connection proposal from a partner CSP. Mutually exclusive with EnvironmentId.
    bandwidth string
    The bandwidth of the connection (e.g., 50Mbps, 1Gbps). Required when creating a connection through AWS.
    description string
    A description of the connection.
    environmentId string
    The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
    remoteOwnerAccount string
    The account ID of the remote owner. Required when creating a connection through AWS.
    tags Tag[]
    An array of key-value pairs to apply to this resource.
    attach_point ConnectionAttachPointArgs
    The logical attachment point in your AWS network where the managed connection will be connected.
    activation_key str
    The activation key for accepting a connection proposal from a partner CSP. Mutually exclusive with EnvironmentId.
    bandwidth str
    The bandwidth of the connection (e.g., 50Mbps, 1Gbps). Required when creating a connection through AWS.
    description str
    A description of the connection.
    environment_id str
    The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
    remote_owner_account str
    The account ID of the remote owner. Required when creating a connection through AWS.
    tags Sequence[TagArgs]
    An array of key-value pairs to apply to this resource.
    attachPoint Property Map
    The logical attachment point in your AWS network where the managed connection will be connected.
    activationKey String
    The activation key for accepting a connection proposal from a partner CSP. Mutually exclusive with EnvironmentId.
    bandwidth String
    The bandwidth of the connection (e.g., 50Mbps, 1Gbps). Required when creating a connection through AWS.
    description String
    A description of the connection.
    environmentId String
    The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
    remoteOwnerAccount String
    The account ID of the remote owner. Required when creating a connection through AWS.
    tags List<Property Map>
    An array of key-value pairs to apply to this resource.

    Outputs

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

    Arn string
    The Amazon Resource Name (ARN) of the connection.
    BillingTier int
    The billing tier for the connection.
    ConnectionId string
    The unique identifier for the connection.
    Id string
    The provider-assigned unique ID for this managed resource.
    OwnerAccount string
    The AWS account ID of the connection owner.
    Provider Pulumi.AwsNative.Interconnect.Outputs.ConnectionProvider
    The partner cloud service provider.
    SharedId string
    The shared identifier for the connection pairing.
    State Pulumi.AwsNative.Interconnect.ConnectionState
    The current state of the connection.
    Type string
    The type of managed connection.
    Arn string
    The Amazon Resource Name (ARN) of the connection.
    BillingTier int
    The billing tier for the connection.
    ConnectionId string
    The unique identifier for the connection.
    Id string
    The provider-assigned unique ID for this managed resource.
    OwnerAccount string
    The AWS account ID of the connection owner.
    Provider ConnectionProvider
    The partner cloud service provider.
    SharedId string
    The shared identifier for the connection pairing.
    State ConnectionStateEnum
    The current state of the connection.
    Type string
    The type of managed connection.
    arn String
    The Amazon Resource Name (ARN) of the connection.
    billingTier Integer
    The billing tier for the connection.
    connectionId String
    The unique identifier for the connection.
    id String
    The provider-assigned unique ID for this managed resource.
    ownerAccount String
    The AWS account ID of the connection owner.
    provider ConnectionProvider
    The partner cloud service provider.
    sharedId String
    The shared identifier for the connection pairing.
    state ConnectionState
    The current state of the connection.
    type String
    The type of managed connection.
    arn string
    The Amazon Resource Name (ARN) of the connection.
    billingTier number
    The billing tier for the connection.
    connectionId string
    The unique identifier for the connection.
    id string
    The provider-assigned unique ID for this managed resource.
    ownerAccount string
    The AWS account ID of the connection owner.
    provider ConnectionProvider
    The partner cloud service provider.
    sharedId string
    The shared identifier for the connection pairing.
    state ConnectionState
    The current state of the connection.
    type string
    The type of managed connection.
    arn str
    The Amazon Resource Name (ARN) of the connection.
    billing_tier int
    The billing tier for the connection.
    connection_id str
    The unique identifier for the connection.
    id str
    The provider-assigned unique ID for this managed resource.
    owner_account str
    The AWS account ID of the connection owner.
    provider ConnectionProvider
    The partner cloud service provider.
    shared_id str
    The shared identifier for the connection pairing.
    state ConnectionState
    The current state of the connection.
    type str
    The type of managed connection.
    arn String
    The Amazon Resource Name (ARN) of the connection.
    billingTier Number
    The billing tier for the connection.
    connectionId String
    The unique identifier for the connection.
    id String
    The provider-assigned unique ID for this managed resource.
    ownerAccount String
    The AWS account ID of the connection owner.
    provider Property Map
    The partner cloud service provider.
    sharedId String
    The shared identifier for the connection pairing.
    state "available" | "requested" | "pending" | "down" | "deleting" | "deleted" | "failed"
    The current state of the connection.
    type String
    The type of managed connection.

    Supporting Types

    ConnectionAttachPoint, ConnectionAttachPointArgs

    The logical attachment point in your AWS network where the managed connection will be connected.
    Arn string
    The ARN of the resource to attach to.
    DirectConnectGateway string
    The ID of the Direct Connect Gateway to attach to.
    Arn string
    The ARN of the resource to attach to.
    DirectConnectGateway string
    The ID of the Direct Connect Gateway to attach to.
    arn String
    The ARN of the resource to attach to.
    directConnectGateway String
    The ID of the Direct Connect Gateway to attach to.
    arn string
    The ARN of the resource to attach to.
    directConnectGateway string
    The ID of the Direct Connect Gateway to attach to.
    arn str
    The ARN of the resource to attach to.
    direct_connect_gateway str
    The ID of the Direct Connect Gateway to attach to.
    arn String
    The ARN of the resource to attach to.
    directConnectGateway String
    The ID of the Direct Connect Gateway to attach to.

    ConnectionProvider, ConnectionProviderArgs

    The partner cloud service provider.
    CloudServiceProvider string
    The name of the cloud service provider.
    LastMileProvider string
    The name of the last mile provider.
    CloudServiceProvider string
    The name of the cloud service provider.
    LastMileProvider string
    The name of the last mile provider.
    cloudServiceProvider String
    The name of the cloud service provider.
    lastMileProvider String
    The name of the last mile provider.
    cloudServiceProvider string
    The name of the cloud service provider.
    lastMileProvider string
    The name of the last mile provider.
    cloud_service_provider str
    The name of the cloud service provider.
    last_mile_provider str
    The name of the last mile provider.
    cloudServiceProvider String
    The name of the cloud service provider.
    lastMileProvider String
    The name of the last mile provider.

    ConnectionState, ConnectionStateArgs

    Available
    available
    Requested
    requested
    Pending
    pending
    Down
    down
    Deleting
    deleting
    Deleted
    deleted
    Failed
    failed
    ConnectionStateAvailable
    available
    ConnectionStateRequested
    requested
    ConnectionStatePending
    pending
    ConnectionStateDown
    down
    ConnectionStateDeleting
    deleting
    ConnectionStateDeleted
    deleted
    ConnectionStateFailed
    failed
    Available
    available
    Requested
    requested
    Pending
    pending
    Down
    down
    Deleting
    deleting
    Deleted
    deleted
    Failed
    failed
    Available
    available
    Requested
    requested
    Pending
    pending
    Down
    down
    Deleting
    deleting
    Deleted
    deleted
    Failed
    failed
    AVAILABLE
    available
    REQUESTED
    requested
    PENDING
    pending
    DOWN
    down
    DELETING
    deleting
    DELETED
    deleted
    FAILED
    failed
    "available"
    available
    "requested"
    requested
    "pending"
    pending
    "down"
    down
    "deleting"
    deleting
    "deleted"
    deleted
    "failed"
    failed

    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 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

    Package Details

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

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

    Viewing docs for AWS Cloud Control v1.62.0
    published on Monday, Apr 20, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.