We recommend new projects start with resources from the AWS provider.
published on Monday, Apr 20, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
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:
- Attach
Point Pulumi.Aws Native. Interconnect. Inputs. Connection Attach Point - The logical attachment point in your AWS network where the managed connection will be connected.
- Activation
Key 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.
- Environment
Id string - The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
- Remote
Owner stringAccount - The account ID of the remote owner. Required when creating a connection through AWS.
-
List<Pulumi.
Aws Native. Inputs. Tag> - An array of key-value pairs to apply to this resource.
- Attach
Point ConnectionAttach Point Args - The logical attachment point in your AWS network where the managed connection will be connected.
- Activation
Key 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.
- Environment
Id string - The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
- Remote
Owner stringAccount - The account ID of the remote owner. Required when creating a connection through AWS.
-
Tag
Args - An array of key-value pairs to apply to this resource.
- attach
Point ConnectionAttach Point - The logical attachment point in your AWS network where the managed connection will be connected.
- activation
Key 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.
- environment
Id String - The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
- remote
Owner StringAccount - The account ID of the remote owner. Required when creating a connection through AWS.
- List<Tag>
- An array of key-value pairs to apply to this resource.
- attach
Point ConnectionAttach Point - The logical attachment point in your AWS network where the managed connection will be connected.
- activation
Key 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.
- environment
Id string - The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
- remote
Owner stringAccount - The account ID of the remote owner. Required when creating a connection through AWS.
- Tag[]
- An array of key-value pairs to apply to this resource.
- attach_
point ConnectionAttach Point Args - 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_ straccount - The account ID of the remote owner. Required when creating a connection through AWS.
-
Sequence[Tag
Args] - An array of key-value pairs to apply to this resource.
- attach
Point Property Map - The logical attachment point in your AWS network where the managed connection will be connected.
- activation
Key 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.
- environment
Id String - The ID of the environment for the connection. Required when creating a connection through AWS. Mutually exclusive with ActivationKey.
- remote
Owner StringAccount - The account ID of the remote owner. Required when creating a connection through AWS.
- 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.
- Billing
Tier int - The billing tier for the connection.
- Connection
Id string - The unique identifier for the connection.
- Id string
- The provider-assigned unique ID for this managed resource.
- Owner
Account string - The AWS account ID of the connection owner.
- Provider
Pulumi.
Aws Native. Interconnect. Outputs. Connection Provider - The partner cloud service provider.
- string
- The shared identifier for the connection pairing.
- State
Pulumi.
Aws Native. Interconnect. Connection State - The current state of the connection.
- Type string
- The type of managed connection.
- Arn string
- The Amazon Resource Name (ARN) of the connection.
- Billing
Tier int - The billing tier for the connection.
- Connection
Id string - The unique identifier for the connection.
- Id string
- The provider-assigned unique ID for this managed resource.
- Owner
Account string - The AWS account ID of the connection owner.
- Provider
Connection
Provider - The partner cloud service provider.
- string
- The shared identifier for the connection pairing.
- State
Connection
State Enum - The current state of the connection.
- Type string
- The type of managed connection.
- arn String
- The Amazon Resource Name (ARN) of the connection.
- billing
Tier Integer - The billing tier for the connection.
- connection
Id String - The unique identifier for the connection.
- id String
- The provider-assigned unique ID for this managed resource.
- owner
Account String - The AWS account ID of the connection owner.
- provider
Connection
Provider - The partner cloud service provider.
- String
- The shared identifier for the connection pairing.
- state
Connection
State - The current state of the connection.
- type String
- The type of managed connection.
- arn string
- The Amazon Resource Name (ARN) of the connection.
- billing
Tier number - The billing tier for the connection.
- connection
Id string - The unique identifier for the connection.
- id string
- The provider-assigned unique ID for this managed resource.
- owner
Account string - The AWS account ID of the connection owner.
- provider
Connection
Provider - The partner cloud service provider.
- string
- The shared identifier for the connection pairing.
- state
Connection
State - 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
Connection
Provider - The partner cloud service provider.
- str
- The shared identifier for the connection pairing.
- state
Connection
State - The current state of the connection.
- type str
- The type of managed connection.
- arn String
- The Amazon Resource Name (ARN) of the connection.
- billing
Tier Number - The billing tier for the connection.
- connection
Id String - The unique identifier for the connection.
- id String
- The provider-assigned unique ID for this managed resource.
- owner
Account String - The AWS account ID of the connection owner.
- provider Property Map
- The partner cloud service provider.
- 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.
- Direct
Connect stringGateway - The ID of the Direct Connect Gateway to attach to.
- Arn string
- The ARN of the resource to attach to.
- Direct
Connect stringGateway - The ID of the Direct Connect Gateway to attach to.
- arn String
- The ARN of the resource to attach to.
- direct
Connect StringGateway - The ID of the Direct Connect Gateway to attach to.
- arn string
- The ARN of the resource to attach to.
- direct
Connect stringGateway - The ID of the Direct Connect Gateway to attach to.
- arn str
- The ARN of the resource to attach to.
- direct_
connect_ strgateway - The ID of the Direct Connect Gateway to attach to.
- arn String
- The ARN of the resource to attach to.
- direct
Connect StringGateway - The ID of the Direct Connect Gateway to attach to.
ConnectionProvider, ConnectionProviderArgs
The partner cloud service provider.- Cloud
Service stringProvider - The name of the cloud service provider.
- Last
Mile stringProvider - The name of the last mile provider.
- Cloud
Service stringProvider - The name of the cloud service provider.
- Last
Mile stringProvider - The name of the last mile provider.
- cloud
Service StringProvider - The name of the cloud service provider.
- last
Mile StringProvider - The name of the last mile provider.
- cloud
Service stringProvider - The name of the cloud service provider.
- last
Mile stringProvider - The name of the last mile provider.
- cloud_
service_ strprovider - The name of the cloud service provider.
- last_
mile_ strprovider - The name of the last mile provider.
- cloud
Service StringProvider - The name of the cloud service provider.
- last
Mile StringProvider - The name of the last mile provider.
ConnectionState, ConnectionStateArgs
- Available
available- Requested
requested- Pending
pending- Down
down- Deleting
deleting- Deleted
deleted- Failed
failed
- Connection
State Available available- Connection
State Requested requested- Connection
State Pending pending- Connection
State Down down- Connection
State Deleting deleting- Connection
State Deleted deleted- Connection
State 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
- "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.Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Apr 20, 2026 by Pulumi
