AWS Direct Connect
Direct Connect links your internal network to an Direct Connect location over a standard Ethernet fiber-optic cable. One end of the cable is connected to your…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Direct Connect links your internal network to an Direct Connect location over a standard Ethernet fiber-optic cable.
One end of the cable is connected to your router, the other to an Direct Connect router. With this connection
in place, you can create virtual interfaces directly to the Amazon Web Services Cloud (for example, to Amazon EC2
and Amazon S3) and to Amazon VPC, bypassing Internet service providers in your network path. A
connection provides access to all Amazon Web Services Regions except the China (Beijing) and (China) Ningxia Regions.
Amazon Web Services resources in the China Regions can only be accessed through locations associated with those Regions.
Endpoints 73
- POSTAccept direct connect gateway association proposal
/#X-Amz-Target=OvertureService.AcceptDirectConnectGatewayAssociationProposalAccepts a proposal request to attach a virtual private gateway or transit gateway to a Direct Connect gateway. - POSTAllocate connection on interconnect
/#X-Amz-Target=OvertureService.AllocateConnectionOnInterconnectDeprecated. Deprecated. Use AllocateHostedConnection instead. Creates a hosted connection on an interconnect. Allocates a VLAN number and a specified amount… - POSTAllocate hosted connection
/#X-Amz-Target=OvertureService.AllocateHostedConnectionCreates a hosted connection on the specified interconnect or a link aggregation group (LAG) of interconnects. Allocates a VLAN number and a specified amount… - POSTAllocate private virtual interface
/#X-Amz-Target=OvertureService.AllocatePrivateVirtualInterfaceProvisions a private virtual interface to be owned by the specified Amazon Web Services account. Virtual interfaces created using this action must be… - POSTAllocate public virtual interface
/#X-Amz-Target=OvertureService.AllocatePublicVirtualInterfaceProvisions a public virtual interface to be owned by the specified Amazon Web Services account. The owner of a connection calls this function to provision a… - POSTAllocate transit virtual interface
/#X-Amz-Target=OvertureService.AllocateTransitVirtualInterfaceProvisions a transit virtual interface to be owned by the specified Amazon Web Services account. Use this type of interface to connect a transit gateway to… - POSTAssociate connection with lag
/#X-Amz-Target=OvertureService.AssociateConnectionWithLagAssociates an existing connection with a link aggregation group (LAG). The connection is interrupted and re-established as a member of the LAG (connectivity… - POSTAssociate connections to resiliency group
/#X-Amz-Target=OvertureService.AssociateConnectionsToResiliencyGroupAssociates one or more connections with the specified resiliency group. This operation is atomic: either all of the specified connections are associated, or… - POSTAssociate hosted connection
/#X-Amz-Target=OvertureService.AssociateHostedConnectionAssociates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or interconnect. If the target interconnect or LAG has an… - POSTAssociate mac sec key
/#X-Amz-Target=OvertureService.AssociateMacSecKeyAssociates a MAC Security (MACsec) Connection Key Name (CKN)/ Connectivity Association Key (CAK) pair with a Direct Connect connection. You must supply either… - POSTAssociate virtual interface
/#X-Amz-Target=OvertureService.AssociateVirtualInterfaceAssociates a virtual interface with a specified link aggregation group (LAG) or connection. Connectivity to Amazon Web Services is temporarily interrupted as… - POSTConfirm connection
/#X-Amz-Target=OvertureService.ConfirmConnectionConfirms the creation of the specified hosted connection on an interconnect. Upon creation, the hosted connection is initially in the Ordering state, and… - POSTConfirm customer agreement
/#X-Amz-Target=OvertureService.ConfirmCustomerAgreementThe confirmation of the terms of agreement when creating the connection/link aggregation group (LAG). - POSTConfirm private virtual interface
/#X-Amz-Target=OvertureService.ConfirmPrivateVirtualInterfaceAccepts ownership of a private virtual interface created by another Amazon Web Services account. After the virtual interface owner makes this call, the… - POSTConfirm public virtual interface
/#X-Amz-Target=OvertureService.ConfirmPublicVirtualInterfaceAccepts ownership of a public virtual interface created by another Amazon Web Services account. After the virtual interface owner makes this call, the… - POSTConfirm transit virtual interface
/#X-Amz-Target=OvertureService.ConfirmTransitVirtualInterfaceAccepts ownership of a transit virtual interface created by another Amazon Web Services account. After the owner of the transit virtual interface makes this… - POSTCreate bGP peer
/#X-Amz-Target=OvertureService.CreateBGPPeerCreates a BGP peer on the specified virtual interface. You must create a BGP peer for the corresponding address family (IPv4/IPv6) in order to access Amazon… - POSTCreate connection
/#X-Amz-Target=OvertureService.CreateConnectionCreates a connection between a customer network and a specific Direct Connect location. A connection links your internal network to an Direct Connect location… - POSTCreate direct connect gateway
/#X-Amz-Target=OvertureService.CreateDirectConnectGatewayCreates a Direct Connect gateway, which is an intermediate object that enables you to connect a set of virtual interfaces and virtual private gateways. A… - POSTCreate direct connect gateway association
/#X-Amz-Target=OvertureService.CreateDirectConnectGatewayAssociationCreates an association between a Direct Connect gateway and a virtual private gateway. The virtual private gateway must be attached to a VPC and must not be… - POSTCreate direct connect gateway association proposal
/#X-Amz-Target=OvertureService.CreateDirectConnectGatewayAssociationProposalCreates a proposal to associate the specified virtual private gateway or transit gateway with the specified Direct Connect gateway. You can associate a Direct… - POSTCreate interconnect
/#X-Amz-Target=OvertureService.CreateInterconnectCreates an interconnect between an Direct Connect Partner's network and a specific Direct Connect location. An interconnect is a connection that is capable of… - POSTCreate lag
/#X-Amz-Target=OvertureService.CreateLagCreates a link aggregation group (LAG) with the specified number of bundled physical dedicated connections between the customer network and a specific Direct… - POSTCreate private virtual interface
/#X-Amz-Target=OvertureService.CreatePrivateVirtualInterfaceCreates a private virtual interface. A virtual interface is the VLAN that transports Direct Connect traffic. A private virtual interface can be connected to… - POSTCreate public virtual interface
/#X-Amz-Target=OvertureService.CreatePublicVirtualInterfaceCreates a public virtual interface. A virtual interface is the VLAN that transports Direct Connect traffic. A public virtual interface supports sending… - POSTCreate resiliency group
/#X-Amz-Target=OvertureService.CreateResiliencyGroupCreates a resiliency group. A resiliency group lets you group Direct Connect connections together and manage them as a single unit to meet a target resiliency… - POSTCreate transit virtual interface
/#X-Amz-Target=OvertureService.CreateTransitVirtualInterfaceCreates a transit virtual interface. A transit virtual interface should be used to access one or more transit gateways associated with Direct Connect… - POSTDelete bGP peer
/#X-Amz-Target=OvertureService.DeleteBGPPeerDeletes the specified BGP peer on the specified virtual interface with the specified customer address and ASN. You cannot delete the last BGP peer from a… - POSTDelete connection
/#X-Amz-Target=OvertureService.DeleteConnectionDeletes the specified connection. Deleting a connection only stops the Direct Connect port hour and data transfer charges. If you are partnering with any… - POSTDelete direct connect gateway
/#X-Amz-Target=OvertureService.DeleteDirectConnectGatewayDeletes the specified Direct Connect gateway. You must first delete all virtual interfaces that are attached to the Direct Connect gateway and disassociate… - POSTDelete direct connect gateway association
/#X-Amz-Target=OvertureService.DeleteDirectConnectGatewayAssociationDeletes the association between the specified Direct Connect gateway and virtual private gateway. We recommend that you specify the associationID to delete… - POSTDelete direct connect gateway association proposal
/#X-Amz-Target=OvertureService.DeleteDirectConnectGatewayAssociationProposalDeletes the association proposal request between the specified Direct Connect gateway and virtual private gateway or transit gateway. - POSTDelete interconnect
/#X-Amz-Target=OvertureService.DeleteInterconnectDeletes the specified interconnect. Intended for use by Direct Connect Partners only. - POSTDelete lag
/#X-Amz-Target=OvertureService.DeleteLagDeletes the specified link aggregation group (LAG). You cannot delete a LAG if it has active virtual interfaces or hosted connections. - POSTDelete resiliency group
/#X-Amz-Target=OvertureService.DeleteResiliencyGroupDeletes the specified resiliency group. Deletion is asynchronous: the resiliency group transitions through the deleting state before it reaches the deleted… - POSTDelete virtual interface
/#X-Amz-Target=OvertureService.DeleteVirtualInterfaceDeletes a virtual interface. - POSTDescribe connection loa
/#X-Amz-Target=OvertureService.DescribeConnectionLoaDeprecated. Deprecated. Use DescribeLoa instead. Gets the LOA-CFA for a connection. The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is… - POSTDescribe connections
/#X-Amz-Target=OvertureService.DescribeConnectionsDisplays the specified connection or all connections in this Region. - POSTDescribe connections on interconnect
/#X-Amz-Target=OvertureService.DescribeConnectionsOnInterconnectDeprecated. Deprecated. Use DescribeHostedConnections instead. Lists the connections that have been provisioned on the specified interconnect. Intended for… - POSTDescribe customer metadata
/#X-Amz-Target=OvertureService.DescribeCustomerMetadataGet and view a list of customer agreements, along with their signed status and whether the customer is an NNIPartner, NNIPartnerV2, or a nonPartner. - POSTDescribe direct connect gateway association proposals
/#X-Amz-Target=OvertureService.DescribeDirectConnectGatewayAssociationProposalsDescribes one or more association proposals for connection between a virtual private gateway or transit gateway and a Direct Connect gateway. - POSTDescribe direct connect gateway associations
/#X-Amz-Target=OvertureService.DescribeDirectConnectGatewayAssociationsLists the associations between your Direct Connect gateways and virtual private gateways and transit gateways. You must specify one of the following: A Direct… - POSTDescribe direct connect gateway attachments
/#X-Amz-Target=OvertureService.DescribeDirectConnectGatewayAttachmentsLists the attachments between your Direct Connect gateways and virtual interfaces. You must specify a Direct Connect gateway, a virtual interface, or both. If… - POSTDescribe direct connect gateways
/#X-Amz-Target=OvertureService.DescribeDirectConnectGatewaysLists all your Direct Connect gateways or only the specified Direct Connect gateway. Deleted Direct Connect gateways are not returned. - POSTDescribe hosted connections
/#X-Amz-Target=OvertureService.DescribeHostedConnectionsLists the hosted connections that have been provisioned on the specified interconnect or link aggregation group (LAG). Intended for use by Direct Connect… - POSTDescribe interconnect loa
/#X-Amz-Target=OvertureService.DescribeInterconnectLoaDeprecated. Deprecated. Use DescribeLoa instead. Gets the LOA-CFA for the specified interconnect. The Letter of Authorization - Connecting Facility Assignment… - POSTDescribe interconnects
/#X-Amz-Target=OvertureService.DescribeInterconnectsLists the interconnects owned by the Amazon Web Services account or only the specified interconnect. - POSTDescribe lags
/#X-Amz-Target=OvertureService.DescribeLagsDescribes all your link aggregation groups (LAG) or the specified LAG. - POSTDescribe loa
/#X-Amz-Target=OvertureService.DescribeLoaGets the LOA-CFA for a connection, interconnect, or link aggregation group (LAG). The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a… - POSTDescribe locations
/#X-Amz-Target=OvertureService.DescribeLocationsLists the Direct Connect locations in the current Amazon Web Services Region. These are the locations that can be selected when calling CreateConnection or… - POSTDescribe router configuration
/#X-Amz-Target=OvertureService.DescribeRouterConfigurationDetails about the router. - POSTDescribe tags
/#X-Amz-Target=OvertureService.DescribeTagsDescribes the tags associated with the specified Direct Connect resources. - POSTDescribe virtual gateways
/#X-Amz-Target=OvertureService.DescribeVirtualGatewaysDeprecated. Use DescribeVpnGateways instead. See DescribeVPNGateways in the Amazon Elastic Compute Cloud API Reference . Lists the virtual private gateways… - POSTDescribe virtual interfaces
/#X-Amz-Target=OvertureService.DescribeVirtualInterfacesDisplays all virtual interfaces for an Amazon Web Services account. Virtual interfaces deleted fewer than 15 minutes before you make the request are also… - POSTDisassociate connection from lag
/#X-Amz-Target=OvertureService.DisassociateConnectionFromLagDisassociates a connection from a link aggregation group (LAG). The connection is interrupted and re-established as a standalone connection (the connection is… - POSTDisassociate connections from resiliency group
/#X-Amz-Target=OvertureService.DisassociateConnectionsFromResiliencyGroupDisassociates one or more connections from the specified resiliency group. This operation is atomic: either all of the specified connections are… - POSTDisassociate mac sec key
/#X-Amz-Target=OvertureService.DisassociateMacSecKeyRemoves the association between a MAC Security (MACsec) security key and a Direct Connect connection. - POSTGet resiliency group
/#X-Amz-Target=OvertureService.GetResiliencyGroupGets information about the specified resiliency group. - POSTList resiliency group associations
/#X-Amz-Target=OvertureService.ListResiliencyGroupAssociationsLists the connection associations for the specified resiliency group. - POSTList resiliency groups
/#X-Amz-Target=OvertureService.ListResiliencyGroupsLists the resiliency groups owned by your Amazon Web Services account in the current Amazon Web Services Region. - POSTList virtual interface routes
/#X-Amz-Target=OvertureService.ListVirtualInterfaceRoutesLists the routes for the specified virtual interface. Use the routeDirection filter to control which routes are returned: accepted : routes received from the… - POSTList virtual interface test history
/#X-Amz-Target=OvertureService.ListVirtualInterfaceTestHistoryLists the virtual interface failover test history. - POSTStart bgp failover test
/#X-Amz-Target=OvertureService.StartBgpFailoverTestStarts the virtual interface failover test that verifies your configuration meets your resiliency requirements by placing the BGP peering session in the DOWN… - POSTStop bgp failover test
/#X-Amz-Target=OvertureService.StopBgpFailoverTestStops the virtual interface failover test. - POSTTag resource
/#X-Amz-Target=OvertureService.TagResourceAdds the specified tags to the specified Direct Connect resource. Each resource can have a maximum of 50 tags. Each tag consists of a key and an optional… - POSTUntag resource
/#X-Amz-Target=OvertureService.UntagResourceRemoves one or more tags from the specified Direct Connect resource. - POSTUpdate connection
/#X-Amz-Target=OvertureService.UpdateConnectionUpdates the Direct Connect connection configuration. You can update the following parameters for a connection: The connection name The connection's MAC… - POSTUpdate connections billing mode
/#X-Amz-Target=OvertureService.UpdateConnectionsBillingModeUpdates the billing mode for the specified Direct Connect connections. You can update the billing mode for up to 200 connections in a single request. - POSTUpdate direct connect gateway
/#X-Amz-Target=OvertureService.UpdateDirectConnectGatewayUpdates the name of a current Direct Connect gateway. - POSTUpdate direct connect gateway association
/#X-Amz-Target=OvertureService.UpdateDirectConnectGatewayAssociationUpdates the specified attributes of the Direct Connect gateway association. Add or remove prefixes from the association. - POSTUpdate lag
/#X-Amz-Target=OvertureService.UpdateLagUpdates the attributes of the specified link aggregation group (LAG). You can update the following LAG attributes: The name of the LAG. The value for the… - POSTUpdate resiliency group
/#X-Amz-Target=OvertureService.UpdateResiliencyGroupUpdates the name of the specified resiliency group. - POSTUpdate virtual interface attributes
/#X-Amz-Target=OvertureService.UpdateVirtualInterfaceAttributesUpdates the specified attributes of the specified virtual private interface. Setting the MTU of a virtual interface to 8500 (jumbo frames) can cause an update…
API details
- Base URL
https://directconnect.{region}.amazonaws.com- Authentication
- AWS Signature Version 4 (requests signed with your AWS access key)
- Operations
- 73 operations on 73 pathsPOST 73
4 marked deprecated - Description format
- AWS Smithy model, API version
2012-10-25 - Links
- Documentation · OpenAPI document
- Listed from
- AWS Smithy API model (aws/api-models-aws) (Apache-2.0)
How to test the AWS Direct Connect in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the AWS Direct Connect collection, without the publisher's secrets.
- Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Accept direct connect gateway association proposal” (POST /#X-Amz-Target=OvertureService.AcceptDirectConnectGatewayAssociationProposal), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the AWS Direct Connect?
Direct Connect links your internal network to an Direct Connect location over a standard Ethernet fiber-optic cable. One end of the cable is connected to your… It is listed under Communication and has 73 endpoints.
Who publishes the AWS Direct Connect?
It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.
What is the base URL of the AWS Direct Connect?
Requests go to https://directconnect.{region}.amazonaws.com. Endpoint paths are added to this base URL.
How do I authenticate with the AWS Direct Connect?
With AWS Signature Version 4 (requests signed with your AWS access key).
How many endpoints does the AWS Direct Connect have?
73 operations on 73 paths (73 POST).
Is forking the AWS Direct Connect free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.