@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AmazonDirectConnect
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAmazonDirectConnect
instead.
AWS Direct Connect links your internal network to an AWS Direct Connect location over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router. With this connection in place, you can create virtual interfaces directly to the AWS cloud (for example, to Amazon Elastic Compute Cloud (Amazon EC2) and Amazon Simple Storage Service (Amazon S3)) and to Amazon Virtual Private Cloud (Amazon VPC), bypassing Internet service providers in your network path. An AWS Direct Connect location provides access to AWS in the region it is associated with, as well as access to other US regions. For example, you can provision a single connection to any AWS Direct Connect location in the US and use it to access public AWS services in all US Regions and AWS GovCloud (US).
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
AllocateConnectionOnInterconnectResult |
allocateConnectionOnInterconnect(AllocateConnectionOnInterconnectRequest allocateConnectionOnInterconnectRequest)
Deprecated.
|
AllocateHostedConnectionResult |
allocateHostedConnection(AllocateHostedConnectionRequest allocateHostedConnectionRequest)
Creates a hosted connection on an interconnect or a link aggregation group (LAG).
|
AllocatePrivateVirtualInterfaceResult |
allocatePrivateVirtualInterface(AllocatePrivateVirtualInterfaceRequest allocatePrivateVirtualInterfaceRequest)
Provisions a private virtual interface to be owned by another AWS customer.
|
AllocatePublicVirtualInterfaceResult |
allocatePublicVirtualInterface(AllocatePublicVirtualInterfaceRequest allocatePublicVirtualInterfaceRequest)
Provisions a public virtual interface to be owned by a different customer.
|
AssociateConnectionWithLagResult |
associateConnectionWithLag(AssociateConnectionWithLagRequest associateConnectionWithLagRequest)
Associates an existing connection with a link aggregation group (LAG).
|
AssociateHostedConnectionResult |
associateHostedConnection(AssociateHostedConnectionRequest associateHostedConnectionRequest)
Associates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or interconnect.
|
AssociateVirtualInterfaceResult |
associateVirtualInterface(AssociateVirtualInterfaceRequest associateVirtualInterfaceRequest)
Associates a virtual interface with a specified link aggregation group (LAG) or connection.
|
ConfirmConnectionResult |
confirmConnection(ConfirmConnectionRequest confirmConnectionRequest)
Confirm the creation of a hosted connection on an interconnect.
|
ConfirmPrivateVirtualInterfaceResult |
confirmPrivateVirtualInterface(ConfirmPrivateVirtualInterfaceRequest confirmPrivateVirtualInterfaceRequest)
Accept ownership of a private virtual interface created by another customer.
|
ConfirmPublicVirtualInterfaceResult |
confirmPublicVirtualInterface(ConfirmPublicVirtualInterfaceRequest confirmPublicVirtualInterfaceRequest)
Accept ownership of a public virtual interface created by another customer.
|
CreateBGPPeerResult |
createBGPPeer(CreateBGPPeerRequest createBGPPeerRequest)
Creates a new BGP peer on a specified virtual interface.
|
CreateConnectionResult |
createConnection(CreateConnectionRequest createConnectionRequest)
Creates a new connection between the customer network and a specific AWS Direct Connect location.
|
CreateDirectConnectGatewayResult |
createDirectConnectGateway(CreateDirectConnectGatewayRequest createDirectConnectGatewayRequest)
Creates a new direct connect gateway.
|
CreateDirectConnectGatewayAssociationResult |
createDirectConnectGatewayAssociation(CreateDirectConnectGatewayAssociationRequest createDirectConnectGatewayAssociationRequest)
Creates an association between a direct connect gateway and a virtual private gateway (VGW).
|
CreateInterconnectResult |
createInterconnect(CreateInterconnectRequest createInterconnectRequest)
Creates a new interconnect between a AWS Direct Connect partner's network and a specific AWS Direct Connect
location.
|
CreateLagResult |
createLag(CreateLagRequest createLagRequest)
Creates a new link aggregation group (LAG) with the specified number of bundled physical connections between the
customer network and a specific AWS Direct Connect location.
|
CreatePrivateVirtualInterfaceResult |
createPrivateVirtualInterface(CreatePrivateVirtualInterfaceRequest createPrivateVirtualInterfaceRequest)
Creates a new private virtual interface.
|
CreatePublicVirtualInterfaceResult |
createPublicVirtualInterface(CreatePublicVirtualInterfaceRequest createPublicVirtualInterfaceRequest)
Creates a new public virtual interface.
|
DeleteBGPPeerResult |
deleteBGPPeer(DeleteBGPPeerRequest deleteBGPPeerRequest)
Deletes a BGP peer on the specified virtual interface that matches the specified customer address and ASN.
|
DeleteConnectionResult |
deleteConnection(DeleteConnectionRequest deleteConnectionRequest)
Deletes the connection.
|
DeleteDirectConnectGatewayResult |
deleteDirectConnectGateway(DeleteDirectConnectGatewayRequest deleteDirectConnectGatewayRequest)
Deletes a direct connect gateway.
|
DeleteDirectConnectGatewayAssociationResult |
deleteDirectConnectGatewayAssociation(DeleteDirectConnectGatewayAssociationRequest deleteDirectConnectGatewayAssociationRequest)
Deletes the association between a direct connect gateway and a virtual private gateway.
|
DeleteInterconnectResult |
deleteInterconnect(DeleteInterconnectRequest deleteInterconnectRequest)
Deletes the specified interconnect.
|
DeleteLagResult |
deleteLag(DeleteLagRequest deleteLagRequest)
Deletes a link aggregation group (LAG).
|
DeleteVirtualInterfaceResult |
deleteVirtualInterface(DeleteVirtualInterfaceRequest deleteVirtualInterfaceRequest)
Deletes a virtual interface.
|
DescribeConnectionLoaResult |
describeConnectionLoa(DescribeConnectionLoaRequest describeConnectionLoaRequest)
Deprecated.
|
DescribeConnectionsResult |
describeConnections()
Simplified method form for invoking the DescribeConnections operation.
|
DescribeConnectionsResult |
describeConnections(DescribeConnectionsRequest describeConnectionsRequest)
Displays all connections in this region.
|
DescribeConnectionsOnInterconnectResult |
describeConnectionsOnInterconnect(DescribeConnectionsOnInterconnectRequest describeConnectionsOnInterconnectRequest)
Deprecated.
|
DescribeDirectConnectGatewayAssociationsResult |
describeDirectConnectGatewayAssociations(DescribeDirectConnectGatewayAssociationsRequest describeDirectConnectGatewayAssociationsRequest)
Returns a list of all direct connect gateway and virtual private gateway (VGW) associations.
|
DescribeDirectConnectGatewayAttachmentsResult |
describeDirectConnectGatewayAttachments(DescribeDirectConnectGatewayAttachmentsRequest describeDirectConnectGatewayAttachmentsRequest)
Returns a list of all direct connect gateway and virtual interface (VIF) attachments.
|
DescribeDirectConnectGatewaysResult |
describeDirectConnectGateways(DescribeDirectConnectGatewaysRequest describeDirectConnectGatewaysRequest)
Returns a list of direct connect gateways in your account.
|
DescribeHostedConnectionsResult |
describeHostedConnections(DescribeHostedConnectionsRequest describeHostedConnectionsRequest)
Returns a list of hosted connections that have been provisioned on the given interconnect or link aggregation
group (LAG).
|
DescribeInterconnectLoaResult |
describeInterconnectLoa(DescribeInterconnectLoaRequest describeInterconnectLoaRequest)
Deprecated.
|
DescribeInterconnectsResult |
describeInterconnects()
Simplified method form for invoking the DescribeInterconnects operation.
|
DescribeInterconnectsResult |
describeInterconnects(DescribeInterconnectsRequest describeInterconnectsRequest)
Returns a list of interconnects owned by the AWS account.
|
DescribeLagsResult |
describeLags(DescribeLagsRequest describeLagsRequest)
Describes the link aggregation groups (LAGs) in your account.
|
DescribeLoaResult |
describeLoa(DescribeLoaRequest describeLoaRequest)
Returns the LOA-CFA for a connection, interconnect, or link aggregation group (LAG).
|
DescribeLocationsResult |
describeLocations()
Simplified method form for invoking the DescribeLocations operation.
|
DescribeLocationsResult |
describeLocations(DescribeLocationsRequest describeLocationsRequest)
Returns the list of AWS Direct Connect locations in the current AWS region.
|
DescribeTagsResult |
describeTags(DescribeTagsRequest describeTagsRequest)
Describes the tags associated with the specified Direct Connect resources.
|
DescribeVirtualGatewaysResult |
describeVirtualGateways()
Simplified method form for invoking the DescribeVirtualGateways operation.
|
DescribeVirtualGatewaysResult |
describeVirtualGateways(DescribeVirtualGatewaysRequest describeVirtualGatewaysRequest)
Returns a list of virtual private gateways owned by the AWS account.
|
DescribeVirtualInterfacesResult |
describeVirtualInterfaces()
Simplified method form for invoking the DescribeVirtualInterfaces operation.
|
DescribeVirtualInterfacesResult |
describeVirtualInterfaces(DescribeVirtualInterfacesRequest describeVirtualInterfacesRequest)
Displays all virtual interfaces for an AWS account.
|
DisassociateConnectionFromLagResult |
disassociateConnectionFromLag(DisassociateConnectionFromLagRequest disassociateConnectionFromLagRequest)
Disassociates a connection from a link aggregation group (LAG).
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
void |
setEndpoint(String endpoint)
Deprecated.
use
AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration) for
example:
builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion)); |
void |
setRegion(Region region)
Deprecated.
use
AwsClientBuilder#setRegion(String) |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
TagResourceResult |
tagResource(TagResourceRequest tagResourceRequest)
Adds the specified tags to the specified Direct Connect resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Removes one or more tags from the specified Direct Connect resource.
|
UpdateLagResult |
updateLag(UpdateLagRequest updateLagRequest)
Updates the attributes of a link aggregation group (LAG).
|
static final String ENDPOINT_PREFIX
@Deprecated void setEndpoint(String endpoint)
AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)
for
example:
builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));
Callers can pass in just the endpoint (ex: "directconnect.us-east-1.amazonaws.com/") or a full URL, including the
protocol (ex: "https://directconnect.us-east-1.amazonaws.com/"). If the protocol is not specified here, the
default protocol from this client's ClientConfiguration
will be used, which by default is HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912
This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
endpoint
- The endpoint (ex: "directconnect.us-east-1.amazonaws.com/") or a full URL, including the protocol (ex:
"https://directconnect.us-east-1.amazonaws.com/") of the region specific AWS endpoint this client will
communicate with.@Deprecated void setRegion(Region region)
AwsClientBuilder#setRegion(String)
setEndpoint(String)
, sets the regional endpoint for this client's
service calls. Callers can use this method to control which AWS region they want to work with.
By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the
ClientConfiguration
supplied at construction.
This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
region
- The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions)
for accessing a given region. Must not be null and must be a region where the service is available.Region.getRegion(com.amazonaws.regions.Regions)
,
Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
,
Region.isServiceSupported(String)
@Deprecated AllocateConnectionOnInterconnectResult allocateConnectionOnInterconnect(AllocateConnectionOnInterconnectRequest allocateConnectionOnInterconnectRequest)
Deprecated in favor of AllocateHostedConnection.
Creates a hosted connection on an interconnect.
Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the given interconnect.
This is intended for use by AWS Direct Connect partners only.
allocateConnectionOnInterconnectRequest
- Container for the parameters to the AllocateConnectionOnInterconnect operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.AllocateHostedConnectionResult allocateHostedConnection(AllocateHostedConnectionRequest allocateHostedConnectionRequest)
Creates a hosted connection on an interconnect or a link aggregation group (LAG).
Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the given interconnect or LAG.
This is intended for use by AWS Direct Connect partners only.
allocateHostedConnectionRequest
- Container for the parameters to theHostedConnection operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.AllocatePrivateVirtualInterfaceResult allocatePrivateVirtualInterface(AllocatePrivateVirtualInterfaceRequest allocatePrivateVirtualInterfaceRequest)
Provisions a private virtual interface to be owned by another AWS customer.
Virtual interfaces created using this action must be confirmed by the virtual interface owner by using the ConfirmPrivateVirtualInterface action. Until then, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.
allocatePrivateVirtualInterfaceRequest
- Container for the parameters to the AllocatePrivateVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.AllocatePublicVirtualInterfaceResult allocatePublicVirtualInterface(AllocatePublicVirtualInterfaceRequest allocatePublicVirtualInterfaceRequest)
Provisions a public virtual interface to be owned by a different customer.
The owner of a connection calls this function to provision a public virtual interface which will be owned by another AWS customer.
Virtual interfaces created using this function must be confirmed by the virtual interface owner by calling ConfirmPublicVirtualInterface. Until this step has been completed, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.
When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), the customer and amazon address fields should be left blank to use auto-assigned IPv6 space. Custom IPv6 Addresses are currently not supported.
allocatePublicVirtualInterfaceRequest
- Container for the parameters to the AllocatePublicVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.AssociateConnectionWithLagResult associateConnectionWithLag(AssociateConnectionWithLagRequest associateConnectionWithLagRequest)
Associates an existing connection with a link aggregation group (LAG). The connection is interrupted and re-established as a member of the LAG (connectivity to AWS will be interrupted). The connection must be hosted on the same AWS Direct Connect endpoint as the LAG, and its bandwidth must match the bandwidth for the LAG. You can reassociate a connection that's currently associated with a different LAG; however, if removing the connection will cause the original LAG to fall below its setting for minimum number of operational connections, the request fails.
Any virtual interfaces that are directly associated with the connection are automatically re-associated with the LAG. If the connection was originally associated with a different LAG, the virtual interfaces remain associated with the original LAG.
For interconnects, any hosted connections are automatically re-associated with the LAG. If the interconnect was originally associated with a different LAG, the hosted connections remain associated with the original LAG.
associateConnectionWithLagRequest
- Container for the parameters to the AssociateConnectionWithLag operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.AssociateHostedConnectionResult associateHostedConnection(AssociateHostedConnectionRequest associateHostedConnectionRequest)
Associates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or interconnect. If the target interconnect or LAG has an existing hosted connection with a conflicting VLAN number or IP address, the operation fails. This action temporarily interrupts the hosted connection's connectivity to AWS as it is being migrated.
This is intended for use by AWS Direct Connect partners only.
associateHostedConnectionRequest
- Container for the parameters to the AssociateHostedConnection operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.AssociateVirtualInterfaceResult associateVirtualInterface(AssociateVirtualInterfaceRequest associateVirtualInterfaceRequest)
Associates a virtual interface with a specified link aggregation group (LAG) or connection. Connectivity to AWS is temporarily interrupted as the virtual interface is being migrated. If the target connection or LAG has an associated virtual interface with a conflicting VLAN number or a conflicting IP address, the operation fails.
Virtual interfaces associated with a hosted connection cannot be associated with a LAG; hosted connections must be migrated along with their virtual interfaces using AssociateHostedConnection.
In order to reassociate a virtual interface to a new connection or LAG, the requester must own either the virtual interface itself or the connection to which the virtual interface is currently associated. Additionally, the requester must own the connection or LAG to which the virtual interface will be newly associated.
associateVirtualInterfaceRequest
- Container for the parameters to the AssociateVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.ConfirmConnectionResult confirmConnection(ConfirmConnectionRequest confirmConnectionRequest)
Confirm the creation of a hosted connection on an interconnect.
Upon creation, the hosted connection is initially in the 'Ordering' state, and will remain in this state until the owner calls ConfirmConnection to confirm creation of the hosted connection.
confirmConnectionRequest
- Container for the parameters to the ConfirmConnection operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.ConfirmPrivateVirtualInterfaceResult confirmPrivateVirtualInterface(ConfirmPrivateVirtualInterfaceRequest confirmPrivateVirtualInterfaceRequest)
Accept ownership of a private virtual interface created by another customer.
After the virtual interface owner calls this function, the virtual interface will be created and attached to the given virtual private gateway or direct connect gateway, and will be available for handling traffic.
confirmPrivateVirtualInterfaceRequest
- Container for the parameters to the ConfirmPrivateVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.ConfirmPublicVirtualInterfaceResult confirmPublicVirtualInterface(ConfirmPublicVirtualInterfaceRequest confirmPublicVirtualInterfaceRequest)
Accept ownership of a public virtual interface created by another customer.
After the virtual interface owner calls this function, the specified virtual interface will be created and made available for handling traffic.
confirmPublicVirtualInterfaceRequest
- Container for the parameters to the ConfirmPublicVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreateBGPPeerResult createBGPPeer(CreateBGPPeerRequest createBGPPeerRequest)
Creates a new BGP peer on a specified virtual interface. The BGP peer cannot be in the same address family (IPv4/IPv6) of an existing BGP peer on the virtual interface.
You must create a BGP peer for the corresponding address family in order to access AWS resources that also use that address family.
When creating a IPv6 BGP peer, the Amazon address and customer address fields must be left blank. IPv6 addresses are automatically assigned from Amazon's pool of IPv6 addresses; you cannot specify custom IPv6 addresses.
For a public virtual interface, the Autonomous System Number (ASN) must be private or already whitelisted for the virtual interface.
createBGPPeerRequest
- Container for the parameters to the CreateBGPPeer operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreateConnectionResult createConnection(CreateConnectionRequest createConnectionRequest)
Creates a new connection between the customer network and a specific AWS Direct Connect location.
A connection links your internal network to an AWS Direct Connect location over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router. An AWS Direct Connect location provides access to Amazon Web Services in the region it is associated with. You can establish connections with AWS Direct Connect locations in multiple regions, but a connection in one region does not provide connectivity to other regions.
To find the locations for your region, use DescribeLocations.
You can automatically add the new connection to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new connection is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection will be created.
createConnectionRequest
- Container for the parameters to the CreateConnection operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreateDirectConnectGatewayResult createDirectConnectGateway(CreateDirectConnectGatewayRequest createDirectConnectGatewayRequest)
Creates a new direct connect gateway. A direct connect gateway is an intermediate object that enables you to connect a set of virtual interfaces and virtual private gateways. direct connect gateways are global and visible in any AWS region after they are created. The virtual interfaces and virtual private gateways that are connected through a direct connect gateway can be in different regions. This enables you to connect to a VPC in any region, regardless of the region in which the virtual interfaces are located, and pass traffic between them.
createDirectConnectGatewayRequest
- Container for the parameters to the CreateDirectConnectGateway operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreateDirectConnectGatewayAssociationResult createDirectConnectGatewayAssociation(CreateDirectConnectGatewayAssociationRequest createDirectConnectGatewayAssociationRequest)
Creates an association between a direct connect gateway and a virtual private gateway (VGW). The VGW must be attached to a VPC and must not be associated with another direct connect gateway.
createDirectConnectGatewayAssociationRequest
- Container for the parameters to the CreateDirectConnectGatewayAssociation operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreateInterconnectResult createInterconnect(CreateInterconnectRequest createInterconnectRequest)
Creates a new interconnect between a AWS Direct Connect partner's network and a specific AWS Direct Connect location.
An interconnect is a connection which is capable of hosting other connections. The AWS Direct Connect partner can use an interconnect to provide sub-1Gbps AWS Direct Connect service to tier 2 customers who do not have their own connections. Like a standard connection, an interconnect links the AWS Direct Connect partner's network to an AWS Direct Connect location over a standard 1 Gbps or 10 Gbps Ethernet fiber-optic cable. One end is connected to the partner's router, the other to an AWS Direct Connect router.
You can automatically add the new interconnect to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new interconnect is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no interconnect will be created.
For each end customer, the AWS Direct Connect partner provisions a connection on their interconnect by calling AllocateConnectionOnInterconnect. The end customer can then connect to AWS resources by creating a virtual interface on their connection, using the VLAN assigned to them by the AWS Direct Connect partner.
This is intended for use by AWS Direct Connect partners only.
createInterconnectRequest
- Container for the parameters to the CreateInterconnect operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreateLagResult createLag(CreateLagRequest createLagRequest)
Creates a new link aggregation group (LAG) with the specified number of bundled physical connections between the customer network and a specific AWS Direct Connect location. A LAG is a logical interface that uses the Link Aggregation Control Protocol (LACP) to aggregate multiple 1 gigabit or 10 gigabit interfaces, allowing you to treat them as a single interface.
All connections in a LAG must use the same bandwidth (for example, 10 Gbps), and must terminate at the same AWS Direct Connect endpoint.
You can have up to 10 connections per LAG. Regardless of this limit, if you request more connections for the LAG than AWS Direct Connect can allocate on a single endpoint, no LAG is created.
You can specify an existing physical connection or interconnect to include in the LAG (which counts towards the total number of connections). Doing so interrupts the current physical connection or hosted connections, and re-establishes them as a member of the LAG. The LAG will be created on the same AWS Direct Connect endpoint to which the connection terminates. Any virtual interfaces associated with the connection are automatically disassociated and re-associated with the LAG. The connection ID does not change.
If the AWS account used to create a LAG is a registered AWS Direct Connect partner, the LAG is automatically enabled to host sub-connections. For a LAG owned by a partner, any associated virtual interfaces cannot be directly configured.
createLagRequest
- Container for the parameters to the CreateLag operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreatePrivateVirtualInterfaceResult createPrivateVirtualInterface(CreatePrivateVirtualInterfaceRequest createPrivateVirtualInterfaceRequest)
Creates a new private virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A private virtual interface supports sending traffic to a single virtual private cloud (VPC).
createPrivateVirtualInterfaceRequest
- Container for the parameters to the CreatePrivateVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.CreatePublicVirtualInterfaceResult createPublicVirtualInterface(CreatePublicVirtualInterfaceRequest createPublicVirtualInterfaceRequest)
Creates a new public virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A public virtual interface supports sending traffic to public services of AWS such as Amazon Simple Storage Service (Amazon S3).
When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), the customer and amazon address fields should be left blank to use auto-assigned IPv6 space. Custom IPv6 Addresses are currently not supported.
createPublicVirtualInterfaceRequest
- Container for the parameters to the CreatePublicVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DeleteBGPPeerResult deleteBGPPeer(DeleteBGPPeerRequest deleteBGPPeerRequest)
Deletes a BGP peer on the specified virtual interface that matches the specified customer address and ASN. You cannot delete the last BGP peer from a virtual interface.
deleteBGPPeerRequest
- Container for the parameters to the DeleteBGPPeer operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DeleteConnectionResult deleteConnection(DeleteConnectionRequest deleteConnectionRequest)
Deletes the connection.
Deleting a connection only stops the AWS Direct Connect port hour and data transfer charges. You need to cancel separately with the providers any services or charges for cross-connects or network circuits that connect you to the AWS Direct Connect location.
deleteConnectionRequest
- Container for the parameters to the DeleteConnection operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DeleteDirectConnectGatewayResult deleteDirectConnectGateway(DeleteDirectConnectGatewayRequest deleteDirectConnectGatewayRequest)
Deletes a direct connect gateway. You must first delete all virtual interfaces that are attached to the direct connect gateway and disassociate all virtual private gateways that are associated with the direct connect gateway.
deleteDirectConnectGatewayRequest
- Container for the parameters to the DeleteDirectConnectGateway operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DeleteDirectConnectGatewayAssociationResult deleteDirectConnectGatewayAssociation(DeleteDirectConnectGatewayAssociationRequest deleteDirectConnectGatewayAssociationRequest)
Deletes the association between a direct connect gateway and a virtual private gateway.
deleteDirectConnectGatewayAssociationRequest
- Container for the parameters to the DeleteDirectConnectGatewayAssociation operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DeleteInterconnectResult deleteInterconnect(DeleteInterconnectRequest deleteInterconnectRequest)
Deletes the specified interconnect.
This is intended for use by AWS Direct Connect partners only.
deleteInterconnectRequest
- Container for the parameters to the DeleteInterconnect operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DeleteLagResult deleteLag(DeleteLagRequest deleteLagRequest)
Deletes a link aggregation group (LAG). You cannot delete a LAG if it has active virtual interfaces or hosted connections.
deleteLagRequest
- Container for the parameters to the DeleteLag operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DeleteVirtualInterfaceResult deleteVirtualInterface(DeleteVirtualInterfaceRequest deleteVirtualInterfaceRequest)
Deletes a virtual interface.
deleteVirtualInterfaceRequest
- Container for the parameters to the DeleteVirtualInterface operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.@Deprecated DescribeConnectionLoaResult describeConnectionLoa(DescribeConnectionLoaRequest describeConnectionLoaRequest)
Deprecated in favor of DescribeLoa.
Returns the LOA-CFA for a Connection.
The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that your APN partner or service provider uses when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.
describeConnectionLoaRequest
- Container for the parameters to the DescribeConnectionLoa operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeConnectionsResult describeConnections(DescribeConnectionsRequest describeConnectionsRequest)
Displays all connections in this region.
If a connection ID is provided, the call returns only that particular connection.
describeConnectionsRequest
- Container for the parameters to the DescribeConnections operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeConnectionsResult describeConnections()
@Deprecated DescribeConnectionsOnInterconnectResult describeConnectionsOnInterconnect(DescribeConnectionsOnInterconnectRequest describeConnectionsOnInterconnectRequest)
Deprecated in favor of DescribeHostedConnections.
Returns a list of connections that have been provisioned on the given interconnect.
This is intended for use by AWS Direct Connect partners only.
describeConnectionsOnInterconnectRequest
- Container for the parameters to the DescribeConnectionsOnInterconnect operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeDirectConnectGatewayAssociationsResult describeDirectConnectGatewayAssociations(DescribeDirectConnectGatewayAssociationsRequest describeDirectConnectGatewayAssociationsRequest)
Returns a list of all direct connect gateway and virtual private gateway (VGW) associations. Either a direct connect gateway ID or a VGW ID must be provided in the request. If a direct connect gateway ID is provided, the response returns all VGWs associated with the direct connect gateway. If a VGW ID is provided, the response returns all direct connect gateways associated with the VGW. If both are provided, the response only returns the association that matches both the direct connect gateway and the VGW.
describeDirectConnectGatewayAssociationsRequest
- Container for the parameters to the DescribeDirectConnectGatewayAssociations operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeDirectConnectGatewayAttachmentsResult describeDirectConnectGatewayAttachments(DescribeDirectConnectGatewayAttachmentsRequest describeDirectConnectGatewayAttachmentsRequest)
Returns a list of all direct connect gateway and virtual interface (VIF) attachments. Either a direct connect gateway ID or a VIF ID must be provided in the request. If a direct connect gateway ID is provided, the response returns all VIFs attached to the direct connect gateway. If a VIF ID is provided, the response returns all direct connect gateways attached to the VIF. If both are provided, the response only returns the attachment that matches both the direct connect gateway and the VIF.
describeDirectConnectGatewayAttachmentsRequest
- Container for the parameters to the DescribeDirectConnectGatewayAttachments operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeDirectConnectGatewaysResult describeDirectConnectGateways(DescribeDirectConnectGatewaysRequest describeDirectConnectGatewaysRequest)
Returns a list of direct connect gateways in your account. Deleted direct connect gateways are not returned. You can provide a direct connect gateway ID in the request to return information about the specific direct connect gateway only. Otherwise, if a direct connect gateway ID is not provided, information about all of your direct connect gateways is returned.
describeDirectConnectGatewaysRequest
- Container for the parameters to the DescribeDirectConnectGateways operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeHostedConnectionsResult describeHostedConnections(DescribeHostedConnectionsRequest describeHostedConnectionsRequest)
Returns a list of hosted connections that have been provisioned on the given interconnect or link aggregation group (LAG).
This is intended for use by AWS Direct Connect partners only.
describeHostedConnectionsRequest
- Container for the parameters to the DescribeHostedConnections operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.@Deprecated DescribeInterconnectLoaResult describeInterconnectLoa(DescribeInterconnectLoaRequest describeInterconnectLoaRequest)
Deprecated in favor of DescribeLoa.
Returns the LOA-CFA for an Interconnect.
The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.
describeInterconnectLoaRequest
- Container for the parameters to the DescribeInterconnectLoa operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeInterconnectsResult describeInterconnects(DescribeInterconnectsRequest describeInterconnectsRequest)
Returns a list of interconnects owned by the AWS account.
If an interconnect ID is provided, it will only return this particular interconnect.
describeInterconnectsRequest
- Container for the parameters to the DescribeInterconnects operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeInterconnectsResult describeInterconnects()
DescribeLagsResult describeLags(DescribeLagsRequest describeLagsRequest)
Describes the link aggregation groups (LAGs) in your account.
If a LAG ID is provided, only information about the specified LAG is returned.
describeLagsRequest
- Container for the parameters to the DescribeLags operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeLoaResult describeLoa(DescribeLoaRequest describeLoaRequest)
Returns the LOA-CFA for a connection, interconnect, or link aggregation group (LAG).
The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.
describeLoaRequest
- Container for the parameters to the DescribeLoa operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeLocationsResult describeLocations(DescribeLocationsRequest describeLocationsRequest)
Returns the list of AWS Direct Connect locations in the current AWS region. These are the locations that may be selected when calling CreateConnection or CreateInterconnect.
describeLocationsRequest
- DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeLocationsResult describeLocations()
DescribeTagsResult describeTags(DescribeTagsRequest describeTagsRequest)
Describes the tags associated with the specified Direct Connect resources.
describeTagsRequest
- Container for the parameters to the DescribeTags operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeVirtualGatewaysResult describeVirtualGateways(DescribeVirtualGatewaysRequest describeVirtualGatewaysRequest)
Returns a list of virtual private gateways owned by the AWS account.
You can create one or more AWS Direct Connect private virtual interfaces linking to a virtual private gateway. A virtual private gateway can be managed via Amazon Virtual Private Cloud (VPC) console or the EC2 CreateVpnGateway action.
describeVirtualGatewaysRequest
- DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeVirtualGatewaysResult describeVirtualGateways()
DescribeVirtualInterfacesResult describeVirtualInterfaces(DescribeVirtualInterfacesRequest describeVirtualInterfacesRequest)
Displays all virtual interfaces for an AWS account. Virtual interfaces deleted fewer than 15 minutes before you make the request are also returned. If you specify a connection ID, only the virtual interfaces associated with the connection are returned. If you specify a virtual interface ID, then only a single virtual interface is returned.
A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.
describeVirtualInterfacesRequest
- Container for the parameters to the DescribeVirtualInterfaces operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.DescribeVirtualInterfacesResult describeVirtualInterfaces()
DisassociateConnectionFromLagResult disassociateConnectionFromLag(DisassociateConnectionFromLagRequest disassociateConnectionFromLagRequest)
Disassociates a connection from a link aggregation group (LAG). The connection is interrupted and re-established as a standalone connection (the connection is not deleted; to delete the connection, use the DeleteConnection request). If the LAG has associated virtual interfaces or hosted connections, they remain associated with the LAG. A disassociated connection owned by an AWS Direct Connect partner is automatically converted to an interconnect.
If disassociating the connection will cause the LAG to fall below its setting for minimum number of operational connections, the request fails, except when it's the last member of the LAG. If all connections are disassociated, the LAG continues to exist as an empty LAG with no physical connections.
disassociateConnectionFromLagRequest
- Container for the parameters to the DisassociateConnectionFromLag operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
Adds the specified tags to the specified Direct Connect resource. Each Direct Connect resource can have a maximum of 50 tags.
Each tag consists of a key and an optional value. If a tag with the same key is already associated with the Direct Connect resource, this action updates its value.
tagResourceRequest
- Container for the parameters to the TagResource operation.DuplicateTagKeysException
- A tag key was specified more than once.TooManyTagsException
- You have reached the limit on the number of tags that can be assigned to a Direct Connect resource.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Removes one or more tags from the specified Direct Connect resource.
untagResourceRequest
- Container for the parameters to the UntagResource operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.UpdateLagResult updateLag(UpdateLagRequest updateLagRequest)
Updates the attributes of a link aggregation group (LAG).
You can update the following attributes:
The name of the LAG.
The value for the minimum number of connections that must be operational for the LAG itself to be operational.
When you create a LAG, the default value for the minimum number of operational connections is zero (0). If you update this value, and the number of operational connections falls below the specified value, the LAG will automatically go down to avoid overutilization of the remaining connections. Adjusting this value should be done with care as it could force the LAG down if the value is set higher than the current number of operational connections.
updateLagRequest
- Container for the parameters to the UpdateLag operation.DirectConnectServerException
- A server-side error occurred during the API call. The error message will contain additional details about
the cause.DirectConnectClientException
- The API was called with invalid parameters. The error message will contain additional details about the
cause.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.Copyright © 2013 Amazon Web Services, Inc. All Rights Reserved.