Class AbstractAmazonDirectConnect

  • All Implemented Interfaces:
    AmazonDirectConnect
    Direct Known Subclasses:
    AbstractAmazonDirectConnectAsync

    public class AbstractAmazonDirectConnect
    extends Object
    implements AmazonDirectConnect
    Abstract implementation of AmazonDirectConnect. Convenient method forms pass through to the corresponding overload that takes a request object, which throws an UnsupportedOperationException.
    • Constructor Detail

      • AbstractAmazonDirectConnect

        protected AbstractAmazonDirectConnect()
    • Method Detail

      • setEndpoint

        public void setEndpoint​(String endpoint)
        Description copied from interface: AmazonDirectConnect
        Overrides the default endpoint for this client ("https://directconnect.us-east-1.amazonaws.com/"). Callers can use this method to control which AWS region they want to work with.

        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.

        Specified by:
        setEndpoint in interface AmazonDirectConnect
        Parameters:
        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.
      • allocatePrivateVirtualInterface

        public AllocatePrivateVirtualInterfaceResult allocatePrivateVirtualInterface​(AllocatePrivateVirtualInterfaceRequest request)
        Description copied from interface: 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.

        Specified by:
        allocatePrivateVirtualInterface in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the AllocatePrivateVirtualInterface operation.
        Returns:
        Result of the AllocatePrivateVirtualInterface operation returned by the service.
      • allocatePublicVirtualInterface

        public AllocatePublicVirtualInterfaceResult allocatePublicVirtualInterface​(AllocatePublicVirtualInterfaceRequest request)
        Description copied from interface: 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.

        Specified by:
        allocatePublicVirtualInterface in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the AllocatePublicVirtualInterface operation.
        Returns:
        Result of the AllocatePublicVirtualInterface operation returned by the service.
      • confirmConnection

        public ConfirmConnectionResult confirmConnection​(ConfirmConnectionRequest request)
        Description copied from interface: 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.

        Specified by:
        confirmConnection in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the ConfirmConnection operation.
        Returns:
        Result of the ConfirmConnection operation returned by the service.
      • confirmPrivateVirtualInterface

        public ConfirmPrivateVirtualInterfaceResult confirmPrivateVirtualInterface​(ConfirmPrivateVirtualInterfaceRequest request)
        Description copied from interface: 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.

        Specified by:
        confirmPrivateVirtualInterface in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the ConfirmPrivateVirtualInterface operation.
        Returns:
        Result of the ConfirmPrivateVirtualInterface operation returned by the service.
      • confirmPublicVirtualInterface

        public ConfirmPublicVirtualInterfaceResult confirmPublicVirtualInterface​(ConfirmPublicVirtualInterfaceRequest request)
        Description copied from interface: 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.

        Specified by:
        confirmPublicVirtualInterface in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the ConfirmPublicVirtualInterface operation.
        Returns:
        Result of the ConfirmPublicVirtualInterface operation returned by the service.
      • createConnection

        public CreateConnectionResult createConnection​(CreateConnectionRequest request)
        Description copied from interface: 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.

        Specified by:
        createConnection in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the CreateConnection operation.
        Returns:
        Result of the CreateConnection operation returned by the service.
      • createInterconnect

        public CreateInterconnectResult createInterconnect​(CreateInterconnectRequest request)
        Description copied from interface: 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.

        Specified by:
        createInterconnect in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the CreateInterconnect operation.
        Returns:
        Result of the CreateInterconnect operation returned by the service.
      • createPublicVirtualInterface

        public CreatePublicVirtualInterfaceResult createPublicVirtualInterface​(CreatePublicVirtualInterfaceRequest request)
        Description copied from interface: 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).

        Specified by:
        createPublicVirtualInterface in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the CreatePublicVirtualInterface operation.
        Returns:
        Result of the CreatePublicVirtualInterface operation returned by the service.
      • deleteConnection

        public DeleteConnectionResult deleteConnection​(DeleteConnectionRequest request)
        Description copied from interface: 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.

        Specified by:
        deleteConnection in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the DeleteConnection operation.
        Returns:
        Result of the DeleteConnection operation returned by the service.
      • describeVirtualInterfaces

        public DescribeVirtualInterfacesResult describeVirtualInterfaces​(DescribeVirtualInterfacesRequest request)
        Description copied from interface: 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.

        Specified by:
        describeVirtualInterfaces in interface AmazonDirectConnect
        Parameters:
        request - Container for the parameters to the DescribeVirtualInterfaces operation.
        Returns:
        Result of the DescribeVirtualInterfaces operation returned by the service.
      • shutdown

        public void shutdown()
        Description copied from interface: AmazonDirectConnect
        Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.
        Specified by:
        shutdown in interface AmazonDirectConnect
      • getCachedResponseMetadata

        public ResponseMetadata getCachedResponseMetadata​(AmazonWebServiceRequest request)
        Description copied from interface: AmazonDirectConnect
        Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

        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.

        Specified by:
        getCachedResponseMetadata in interface AmazonDirectConnect
        Parameters:
        request - The originally executed request.
        Returns:
        The response metadata for the specified request, or null if none is available.