public class AbstractAmazonDirectConnect extends Object implements AmazonDirectConnect
AmazonDirectConnect
. Convenient method
forms pass through to the corresponding overload that takes a request object,
which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
AllocateConnectionOnInterconnectResult |
allocateConnectionOnInterconnect(AllocateConnectionOnInterconnectRequest request)
Creates a hosted connection on an interconnect.
|
AllocatePrivateVirtualInterfaceResult |
allocatePrivateVirtualInterface(AllocatePrivateVirtualInterfaceRequest request)
Provisions a private virtual interface to be owned by a different
customer.
|
AllocatePublicVirtualInterfaceResult |
allocatePublicVirtualInterface(AllocatePublicVirtualInterfaceRequest request)
Provisions a public virtual interface to be owned by a different
customer.
|
ConfirmConnectionResult |
confirmConnection(ConfirmConnectionRequest request)
Confirm the creation of a hosted connection on an interconnect.
|
ConfirmPrivateVirtualInterfaceResult |
confirmPrivateVirtualInterface(ConfirmPrivateVirtualInterfaceRequest request)
Accept ownership of a private virtual interface created by another
customer.
|
ConfirmPublicVirtualInterfaceResult |
confirmPublicVirtualInterface(ConfirmPublicVirtualInterfaceRequest request)
Accept ownership of a public virtual interface created by another
customer.
|
CreateConnectionResult |
createConnection(CreateConnectionRequest request)
Creates a new connection between the customer network and a specific AWS
Direct Connect location.
|
CreateInterconnectResult |
createInterconnect(CreateInterconnectRequest request)
Creates a new interconnect between a AWS Direct Connect partner's network
and a specific AWS Direct Connect location.
|
CreatePrivateVirtualInterfaceResult |
createPrivateVirtualInterface(CreatePrivateVirtualInterfaceRequest request)
Creates a new private virtual interface.
|
CreatePublicVirtualInterfaceResult |
createPublicVirtualInterface(CreatePublicVirtualInterfaceRequest request)
Creates a new public virtual interface.
|
DeleteConnectionResult |
deleteConnection(DeleteConnectionRequest request)
Deletes the connection.
|
DeleteInterconnectResult |
deleteInterconnect(DeleteInterconnectRequest request)
Deletes the specified interconnect.
|
DeleteVirtualInterfaceResult |
deleteVirtualInterface(DeleteVirtualInterfaceRequest request)
Deletes a virtual interface.
|
DescribeConnectionLoaResult |
describeConnectionLoa(DescribeConnectionLoaRequest request)
Returns the LOA-CFA for a Connection.
|
DescribeConnectionsResult |
describeConnections()
Simplified method form for invoking the DescribeConnections operation.
|
DescribeConnectionsResult |
describeConnections(DescribeConnectionsRequest request)
Displays all connections in this region.
|
DescribeConnectionsOnInterconnectResult |
describeConnectionsOnInterconnect(DescribeConnectionsOnInterconnectRequest request)
Return a list of connections that have been provisioned on the given
interconnect.
|
DescribeInterconnectLoaResult |
describeInterconnectLoa(DescribeInterconnectLoaRequest request)
Returns the LOA-CFA for an Interconnect.
|
DescribeInterconnectsResult |
describeInterconnects()
Simplified method form for invoking the DescribeInterconnects operation.
|
DescribeInterconnectsResult |
describeInterconnects(DescribeInterconnectsRequest request)
Returns a list of interconnects owned by the AWS account.
|
DescribeLocationsResult |
describeLocations()
Simplified method form for invoking the DescribeLocations operation.
|
DescribeLocationsResult |
describeLocations(DescribeLocationsRequest request)
Returns the list of AWS Direct Connect locations in the current AWS
region.
|
DescribeVirtualGatewaysResult |
describeVirtualGateways()
Simplified method form for invoking the DescribeVirtualGateways
operation.
|
DescribeVirtualGatewaysResult |
describeVirtualGateways(DescribeVirtualGatewaysRequest request)
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 request)
Displays all virtual interfaces for an AWS account.
|
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)
Overrides the default endpoint for this client
("https://directconnect.us-east-1.amazonaws.com/").
|
void |
setRegion(Region region)
An alternative to
AmazonDirectConnect.setEndpoint(String) , sets
the regional endpoint for this client's service calls. |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
public void setEndpoint(String endpoint)
AmazonDirectConnect
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.
setEndpoint
in interface AmazonDirectConnect
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.public void setRegion(Region region)
AmazonDirectConnect
AmazonDirectConnect.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.
setRegion
in interface AmazonDirectConnect
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)
public AllocateConnectionOnInterconnectResult allocateConnectionOnInterconnect(AllocateConnectionOnInterconnectRequest request)
AmazonDirectConnect
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.
allocateConnectionOnInterconnect
in interface AmazonDirectConnect
request
- Container for the parameters to the
AllocateConnectionOnInterconnect operation.public AllocatePrivateVirtualInterfaceResult allocatePrivateVirtualInterface(AllocatePrivateVirtualInterfaceRequest request)
AmazonDirectConnect
Provisions a private virtual interface to be owned by a different customer.
The owner of a connection calls this function to provision a private 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 ConfirmPrivateVirtualInterface. Until this step has been completed, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.
allocatePrivateVirtualInterface
in interface AmazonDirectConnect
request
- Container for the parameters to the
AllocatePrivateVirtualInterface operation.public AllocatePublicVirtualInterfaceResult allocatePublicVirtualInterface(AllocatePublicVirtualInterfaceRequest request)
AmazonDirectConnect
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.
allocatePublicVirtualInterface
in interface AmazonDirectConnect
request
- Container for the parameters to the AllocatePublicVirtualInterface
operation.public ConfirmConnectionResult confirmConnection(ConfirmConnectionRequest request)
AmazonDirectConnect
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.
confirmConnection
in interface AmazonDirectConnect
request
- Container for the parameters to the ConfirmConnection operation.public ConfirmPrivateVirtualInterfaceResult confirmPrivateVirtualInterface(ConfirmPrivateVirtualInterfaceRequest request)
AmazonDirectConnect
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, and will be available for handling traffic.
confirmPrivateVirtualInterface
in interface AmazonDirectConnect
request
- Container for the parameters to the ConfirmPrivateVirtualInterface
operation.public ConfirmPublicVirtualInterfaceResult confirmPublicVirtualInterface(ConfirmPublicVirtualInterfaceRequest request)
AmazonDirectConnect
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.
confirmPublicVirtualInterface
in interface AmazonDirectConnect
request
- Container for the parameters to the ConfirmPublicVirtualInterface
operation.public CreateConnectionResult createConnection(CreateConnectionRequest request)
AmazonDirectConnect
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.
createConnection
in interface AmazonDirectConnect
request
- Container for the parameters to the CreateConnection operation.public CreateInterconnectResult createInterconnect(CreateInterconnectRequest request)
AmazonDirectConnect
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.
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.
createInterconnect
in interface AmazonDirectConnect
request
- Container for the parameters to the CreateInterconnect operation.public CreatePrivateVirtualInterfaceResult createPrivateVirtualInterface(CreatePrivateVirtualInterfaceRequest request)
AmazonDirectConnect
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).
createPrivateVirtualInterface
in interface AmazonDirectConnect
request
- Container for the parameters to the CreatePrivateVirtualInterface
operation.public CreatePublicVirtualInterfaceResult createPublicVirtualInterface(CreatePublicVirtualInterfaceRequest request)
AmazonDirectConnect
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).
createPublicVirtualInterface
in interface AmazonDirectConnect
request
- Container for the parameters to the CreatePublicVirtualInterface
operation.public DeleteConnectionResult deleteConnection(DeleteConnectionRequest request)
AmazonDirectConnect
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.
deleteConnection
in interface AmazonDirectConnect
request
- Container for the parameters to the DeleteConnection operation.public DeleteInterconnectResult deleteInterconnect(DeleteInterconnectRequest request)
AmazonDirectConnect
Deletes the specified interconnect.
This is intended for use by AWS Direct Connect partners only.
deleteInterconnect
in interface AmazonDirectConnect
request
- Container for the parameters to the DeleteInterconnect operation.public DeleteVirtualInterfaceResult deleteVirtualInterface(DeleteVirtualInterfaceRequest request)
AmazonDirectConnect
Deletes a virtual interface.
deleteVirtualInterface
in interface AmazonDirectConnect
request
- Container for the parameters to the DeleteVirtualInterface
operation.public DescribeConnectionLoaResult describeConnectionLoa(DescribeConnectionLoaRequest request)
AmazonDirectConnect
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.
describeConnectionLoa
in interface AmazonDirectConnect
request
- Container for the parameters to the DescribeConnectionLoa
operation.public DescribeConnectionsResult describeConnections(DescribeConnectionsRequest request)
AmazonDirectConnect
Displays all connections in this region.
If a connection ID is provided, the call returns only that particular connection.
describeConnections
in interface AmazonDirectConnect
request
- Container for the parameters to the DescribeConnections operation.public DescribeConnectionsResult describeConnections()
AmazonDirectConnect
describeConnections
in interface AmazonDirectConnect
AmazonDirectConnect.describeConnections(DescribeConnectionsRequest)
public DescribeConnectionsOnInterconnectResult describeConnectionsOnInterconnect(DescribeConnectionsOnInterconnectRequest request)
AmazonDirectConnect
Return a list of connections that have been provisioned on the given interconnect.
This is intended for use by AWS Direct Connect partners only.
describeConnectionsOnInterconnect
in interface AmazonDirectConnect
request
- Container for the parameters to the
DescribeConnectionsOnInterconnect operation.public DescribeInterconnectLoaResult describeInterconnectLoa(DescribeInterconnectLoaRequest request)
AmazonDirectConnect
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.
describeInterconnectLoa
in interface AmazonDirectConnect
request
- Container for the parameters to the DescribeInterconnectLoa
operation.public DescribeInterconnectsResult describeInterconnects(DescribeInterconnectsRequest request)
AmazonDirectConnect
Returns a list of interconnects owned by the AWS account.
If an interconnect ID is provided, it will only return this particular interconnect.
describeInterconnects
in interface AmazonDirectConnect
request
- Container for the parameters to the DescribeInterconnects
operation.public DescribeInterconnectsResult describeInterconnects()
AmazonDirectConnect
describeInterconnects
in interface AmazonDirectConnect
AmazonDirectConnect.describeInterconnects(DescribeInterconnectsRequest)
public DescribeLocationsResult describeLocations(DescribeLocationsRequest request)
AmazonDirectConnect
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.
describeLocations
in interface AmazonDirectConnect
public DescribeLocationsResult describeLocations()
AmazonDirectConnect
describeLocations
in interface AmazonDirectConnect
AmazonDirectConnect.describeLocations(DescribeLocationsRequest)
public DescribeVirtualGatewaysResult describeVirtualGateways(DescribeVirtualGatewaysRequest request)
AmazonDirectConnect
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.
describeVirtualGateways
in interface AmazonDirectConnect
public DescribeVirtualGatewaysResult describeVirtualGateways()
AmazonDirectConnect
describeVirtualGateways
in interface AmazonDirectConnect
AmazonDirectConnect.describeVirtualGateways(DescribeVirtualGatewaysRequest)
public DescribeVirtualInterfacesResult describeVirtualInterfaces(DescribeVirtualInterfacesRequest request)
AmazonDirectConnect
Displays all virtual interfaces for an AWS account. Virtual interfaces deleted fewer than 15 minutes before DescribeVirtualInterfaces is called are also returned. If a connection ID is included then only virtual interfaces associated with this connection will be returned. If a virtual interface ID is included then only a single virtual interface will be returned.
A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.
If a connection ID is provided, only virtual interfaces provisioned on the specified connection will be returned. If a virtual interface ID is provided, only this particular virtual interface will be returned.
describeVirtualInterfaces
in interface AmazonDirectConnect
request
- Container for the parameters to the DescribeVirtualInterfaces
operation.public DescribeVirtualInterfacesResult describeVirtualInterfaces()
AmazonDirectConnect
describeVirtualInterfaces
in interface AmazonDirectConnect
AmazonDirectConnect.describeVirtualInterfaces(DescribeVirtualInterfacesRequest)
public void shutdown()
AmazonDirectConnect
shutdown
in interface AmazonDirectConnect
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonDirectConnect
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.
getCachedResponseMetadata
in interface AmazonDirectConnect
request
- The originally executed request.Copyright © 2013 Amazon Web Services, Inc. All Rights Reserved.