AWS Classic
HostedConnection
Provides a hosted connection on the specified interconnect or a link aggregation group (LAG) of interconnects. Intended for use by AWS Direct Connect Partners only.
Example Usage
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var hosted = new Aws.DirectConnect.HostedConnection("hosted", new Aws.DirectConnect.HostedConnectionArgs
{
Bandwidth = "100Mbps",
ConnectionId = "dxcon-ffabc123",
OwnerAccountId = "123456789012",
Vlan = 1,
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/directconnect"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := directconnect.NewHostedConnection(ctx, "hosted", &directconnect.HostedConnectionArgs{
Bandwidth: pulumi.String("100Mbps"),
ConnectionId: pulumi.String("dxcon-ffabc123"),
OwnerAccountId: pulumi.String("123456789012"),
Vlan: pulumi.Int(1),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var hosted = new HostedConnection("hosted", HostedConnectionArgs.builder()
.bandwidth("100Mbps")
.connectionId("dxcon-ffabc123")
.ownerAccountId("123456789012")
.vlan(1)
.build());
}
}
import pulumi
import pulumi_aws as aws
hosted = aws.directconnect.HostedConnection("hosted",
bandwidth="100Mbps",
connection_id="dxcon-ffabc123",
owner_account_id="123456789012",
vlan=1)
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const hosted = new aws.directconnect.HostedConnection("hosted", {
bandwidth: "100Mbps",
connectionId: "dxcon-ffabc123",
ownerAccountId: "123456789012",
vlan: 1,
});
resources:
hosted:
type: aws:directconnect:HostedConnection
properties:
bandwidth: 100Mbps
connectionId: dxcon-ffabc123
ownerAccountId: 123456789012
vlan: 1
Create a HostedConnection Resource
new HostedConnection(name: string, args: HostedConnectionArgs, opts?: CustomResourceOptions);
@overload
def HostedConnection(resource_name: str,
opts: Optional[ResourceOptions] = None,
bandwidth: Optional[str] = None,
connection_id: Optional[str] = None,
name: Optional[str] = None,
owner_account_id: Optional[str] = None,
vlan: Optional[int] = None)
@overload
def HostedConnection(resource_name: str,
args: HostedConnectionArgs,
opts: Optional[ResourceOptions] = None)
func NewHostedConnection(ctx *Context, name string, args HostedConnectionArgs, opts ...ResourceOption) (*HostedConnection, error)
public HostedConnection(string name, HostedConnectionArgs args, CustomResourceOptions? opts = null)
public HostedConnection(String name, HostedConnectionArgs args)
public HostedConnection(String name, HostedConnectionArgs args, CustomResourceOptions options)
type: aws:directconnect:HostedConnection
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args HostedConnectionArgs
- 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 HostedConnectionArgs
- 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 HostedConnectionArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args HostedConnectionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args HostedConnectionArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
HostedConnection Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The HostedConnection resource accepts the following input properties:
- Bandwidth string
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- Connection
Id string The ID of the interconnect or LAG.
- Owner
Account stringId The ID of the AWS account of the customer for the connection.
- Vlan int
The dedicated VLAN provisioned to the hosted connection.
- Name string
The name of the connection.
- Bandwidth string
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- Connection
Id string The ID of the interconnect or LAG.
- Owner
Account stringId The ID of the AWS account of the customer for the connection.
- Vlan int
The dedicated VLAN provisioned to the hosted connection.
- Name string
The name of the connection.
- bandwidth String
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection
Id String The ID of the interconnect or LAG.
- owner
Account StringId The ID of the AWS account of the customer for the connection.
- vlan Integer
The dedicated VLAN provisioned to the hosted connection.
- name String
The name of the connection.
- bandwidth string
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection
Id string The ID of the interconnect or LAG.
- owner
Account stringId The ID of the AWS account of the customer for the connection.
- vlan number
The dedicated VLAN provisioned to the hosted connection.
- name string
The name of the connection.
- bandwidth str
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection_
id str The ID of the interconnect or LAG.
- owner_
account_ strid The ID of the AWS account of the customer for the connection.
- vlan int
The dedicated VLAN provisioned to the hosted connection.
- name str
The name of the connection.
- bandwidth String
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection
Id String The ID of the interconnect or LAG.
- owner
Account StringId The ID of the AWS account of the customer for the connection.
- vlan Number
The dedicated VLAN provisioned to the hosted connection.
- name String
The name of the connection.
Outputs
All input properties are implicitly available as output properties. Additionally, the HostedConnection resource produces the following output properties:
- Aws
Device string The Direct Connect endpoint on which the physical connection terminates.
- Has
Logical stringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- Id string
The provider-assigned unique ID for this managed resource.
- Jumbo
Frame boolCapable Boolean value representing if jumbo frames have been enabled for this connection.
- Lag
Id string The ID of the LAG.
- Loa
Issue stringTime The time of the most recent call to DescribeLoa for this connection.
- Location string
The location of the connection.
- Partner
Name string The name of the AWS Direct Connect service provider associated with the connection.
- Provider
Name string The name of the service provider associated with the connection.
- Region string
The AWS Region where the connection is located.
- State string
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- Aws
Device string The Direct Connect endpoint on which the physical connection terminates.
- Has
Logical stringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- Id string
The provider-assigned unique ID for this managed resource.
- Jumbo
Frame boolCapable Boolean value representing if jumbo frames have been enabled for this connection.
- Lag
Id string The ID of the LAG.
- Loa
Issue stringTime The time of the most recent call to DescribeLoa for this connection.
- Location string
The location of the connection.
- Partner
Name string The name of the AWS Direct Connect service provider associated with the connection.
- Provider
Name string The name of the service provider associated with the connection.
- Region string
The AWS Region where the connection is located.
- State string
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- aws
Device String The Direct Connect endpoint on which the physical connection terminates.
- has
Logical StringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- id String
The provider-assigned unique ID for this managed resource.
- jumbo
Frame BooleanCapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag
Id String The ID of the LAG.
- loa
Issue StringTime The time of the most recent call to DescribeLoa for this connection.
- location String
The location of the connection.
- partner
Name String The name of the AWS Direct Connect service provider associated with the connection.
- provider
Name String The name of the service provider associated with the connection.
- region String
The AWS Region where the connection is located.
- state String
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- aws
Device string The Direct Connect endpoint on which the physical connection terminates.
- has
Logical stringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- id string
The provider-assigned unique ID for this managed resource.
- jumbo
Frame booleanCapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag
Id string The ID of the LAG.
- loa
Issue stringTime The time of the most recent call to DescribeLoa for this connection.
- location string
The location of the connection.
- partner
Name string The name of the AWS Direct Connect service provider associated with the connection.
- provider
Name string The name of the service provider associated with the connection.
- region string
The AWS Region where the connection is located.
- state string
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- aws_
device str The Direct Connect endpoint on which the physical connection terminates.
- has_
logical_ strredundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- id str
The provider-assigned unique ID for this managed resource.
- jumbo_
frame_ boolcapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag_
id str The ID of the LAG.
- loa_
issue_ strtime The time of the most recent call to DescribeLoa for this connection.
- location str
The location of the connection.
- partner_
name str The name of the AWS Direct Connect service provider associated with the connection.
- provider_
name str The name of the service provider associated with the connection.
- region str
The AWS Region where the connection is located.
- state str
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- aws
Device String The Direct Connect endpoint on which the physical connection terminates.
- has
Logical StringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- id String
The provider-assigned unique ID for this managed resource.
- jumbo
Frame BooleanCapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag
Id String The ID of the LAG.
- loa
Issue StringTime The time of the most recent call to DescribeLoa for this connection.
- location String
The location of the connection.
- partner
Name String The name of the AWS Direct Connect service provider associated with the connection.
- provider
Name String The name of the service provider associated with the connection.
- region String
The AWS Region where the connection is located.
- state String
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
Look up an Existing HostedConnection Resource
Get an existing HostedConnection resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: HostedConnectionState, opts?: CustomResourceOptions): HostedConnection
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
aws_device: Optional[str] = None,
bandwidth: Optional[str] = None,
connection_id: Optional[str] = None,
has_logical_redundancy: Optional[str] = None,
jumbo_frame_capable: Optional[bool] = None,
lag_id: Optional[str] = None,
loa_issue_time: Optional[str] = None,
location: Optional[str] = None,
name: Optional[str] = None,
owner_account_id: Optional[str] = None,
partner_name: Optional[str] = None,
provider_name: Optional[str] = None,
region: Optional[str] = None,
state: Optional[str] = None,
vlan: Optional[int] = None) -> HostedConnection
func GetHostedConnection(ctx *Context, name string, id IDInput, state *HostedConnectionState, opts ...ResourceOption) (*HostedConnection, error)
public static HostedConnection Get(string name, Input<string> id, HostedConnectionState? state, CustomResourceOptions? opts = null)
public static HostedConnection get(String name, Output<String> id, HostedConnectionState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Aws
Device string The Direct Connect endpoint on which the physical connection terminates.
- Bandwidth string
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- Connection
Id string The ID of the interconnect or LAG.
- Has
Logical stringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- Jumbo
Frame boolCapable Boolean value representing if jumbo frames have been enabled for this connection.
- Lag
Id string The ID of the LAG.
- Loa
Issue stringTime The time of the most recent call to DescribeLoa for this connection.
- Location string
The location of the connection.
- Name string
The name of the connection.
- Owner
Account stringId The ID of the AWS account of the customer for the connection.
- Partner
Name string The name of the AWS Direct Connect service provider associated with the connection.
- Provider
Name string The name of the service provider associated with the connection.
- Region string
The AWS Region where the connection is located.
- State string
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- Vlan int
The dedicated VLAN provisioned to the hosted connection.
- Aws
Device string The Direct Connect endpoint on which the physical connection terminates.
- Bandwidth string
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- Connection
Id string The ID of the interconnect or LAG.
- Has
Logical stringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- Jumbo
Frame boolCapable Boolean value representing if jumbo frames have been enabled for this connection.
- Lag
Id string The ID of the LAG.
- Loa
Issue stringTime The time of the most recent call to DescribeLoa for this connection.
- Location string
The location of the connection.
- Name string
The name of the connection.
- Owner
Account stringId The ID of the AWS account of the customer for the connection.
- Partner
Name string The name of the AWS Direct Connect service provider associated with the connection.
- Provider
Name string The name of the service provider associated with the connection.
- Region string
The AWS Region where the connection is located.
- State string
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- Vlan int
The dedicated VLAN provisioned to the hosted connection.
- aws
Device String The Direct Connect endpoint on which the physical connection terminates.
- bandwidth String
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection
Id String The ID of the interconnect or LAG.
- has
Logical StringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- jumbo
Frame BooleanCapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag
Id String The ID of the LAG.
- loa
Issue StringTime The time of the most recent call to DescribeLoa for this connection.
- location String
The location of the connection.
- name String
The name of the connection.
- owner
Account StringId The ID of the AWS account of the customer for the connection.
- partner
Name String The name of the AWS Direct Connect service provider associated with the connection.
- provider
Name String The name of the service provider associated with the connection.
- region String
The AWS Region where the connection is located.
- state String
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- vlan Integer
The dedicated VLAN provisioned to the hosted connection.
- aws
Device string The Direct Connect endpoint on which the physical connection terminates.
- bandwidth string
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection
Id string The ID of the interconnect or LAG.
- has
Logical stringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- jumbo
Frame booleanCapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag
Id string The ID of the LAG.
- loa
Issue stringTime The time of the most recent call to DescribeLoa for this connection.
- location string
The location of the connection.
- name string
The name of the connection.
- owner
Account stringId The ID of the AWS account of the customer for the connection.
- partner
Name string The name of the AWS Direct Connect service provider associated with the connection.
- provider
Name string The name of the service provider associated with the connection.
- region string
The AWS Region where the connection is located.
- state string
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- vlan number
The dedicated VLAN provisioned to the hosted connection.
- aws_
device str The Direct Connect endpoint on which the physical connection terminates.
- bandwidth str
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection_
id str The ID of the interconnect or LAG.
- has_
logical_ strredundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- jumbo_
frame_ boolcapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag_
id str The ID of the LAG.
- loa_
issue_ strtime The time of the most recent call to DescribeLoa for this connection.
- location str
The location of the connection.
- name str
The name of the connection.
- owner_
account_ strid The ID of the AWS account of the customer for the connection.
- partner_
name str The name of the AWS Direct Connect service provider associated with the connection.
- provider_
name str The name of the service provider associated with the connection.
- region str
The AWS Region where the connection is located.
- state str
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- vlan int
The dedicated VLAN provisioned to the hosted connection.
- aws
Device String The Direct Connect endpoint on which the physical connection terminates.
- bandwidth String
The bandwidth of the connection. Valid values for dedicated connections: 1Gbps, 10Gbps. Valid values for hosted connections: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps and 10Gbps. Case sensitive.
- connection
Id String The ID of the interconnect or LAG.
- has
Logical StringRedundancy Indicates whether the connection supports a secondary BGP peer in the same address family (IPv4/IPv6).
- jumbo
Frame BooleanCapable Boolean value representing if jumbo frames have been enabled for this connection.
- lag
Id String The ID of the LAG.
- loa
Issue StringTime The time of the most recent call to DescribeLoa for this connection.
- location String
The location of the connection.
- name String
The name of the connection.
- owner
Account StringId The ID of the AWS account of the customer for the connection.
- partner
Name String The name of the AWS Direct Connect service provider associated with the connection.
- provider
Name String The name of the service provider associated with the connection.
- region String
The AWS Region where the connection is located.
- state String
The state of the connection. Possible values include: ordering, requested, pending, available, down, deleting, deleted, rejected, unknown. See AllocateHostedConnection for a description of each connection state.
- vlan Number
The dedicated VLAN provisioned to the hosted connection.
Package Details
- Repository
- https://github.com/pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
aws
Terraform Provider.