pub struct Client { /* private fields */ }
Expand description

Client for AWS Direct Connect

Client for invoking operations on AWS Direct Connect. Each operation on AWS Direct Connect is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Examples

Constructing a client and invoking an operation

    // create a shared configuration. This can be used & shared between multiple service clients.
    let shared_config = aws_config::load_from_env().await;
    let client = aws_sdk_directconnect::Client::new(&shared_config);
    // invoke an operation
    /* let rsp = client
        .<operation_name>().
        .<param>("some value")
        .send().await; */

Constructing a client with custom configuration

use aws_config::retry::RetryConfig;
let shared_config = aws_config::load_from_env().await;
let config = aws_sdk_directconnect::config::Builder::from(&shared_config)
  .retry_config(RetryConfig::disabled())
  .build();
let client = aws_sdk_directconnect::Client::from_conf(config);

Implementations

Creates a client with the given service configuration.

Returns the client’s configuration.

Constructs a fluent builder for the AcceptDirectConnectGatewayAssociationProposal operation.

Constructs a fluent builder for the AllocateConnectionOnInterconnect operation.

Constructs a fluent builder for the AllocateHostedConnection operation.

Constructs a fluent builder for the AllocatePrivateVirtualInterface operation.

Constructs a fluent builder for the AllocatePublicVirtualInterface operation.

Constructs a fluent builder for the AllocateTransitVirtualInterface operation.

Constructs a fluent builder for the AssociateConnectionWithLag operation.

Constructs a fluent builder for the AssociateHostedConnection operation.

Constructs a fluent builder for the AssociateMacSecKey operation.

  • The fluent builder is configurable:
    • connection_id(impl Into<String>) / set_connection_id(Option<String>):

      The ID of the dedicated connection (dxcon-xxxx), or the ID of the LAG (dxlag-xxxx).

      You can use DescribeConnections or DescribeLags to retrieve connection ID.

    • secret_arn(impl Into<String>) / set_secret_arn(Option<String>):

      The Amazon Resource Name (ARN) of the MAC Security (MACsec) secret key to associate with the dedicated connection.

      You can use DescribeConnections or DescribeLags to retrieve the MAC Security (MACsec) secret key.

      If you use this request parameter, you do not use the ckn and cak request parameters.

    • ckn(impl Into<String>) / set_ckn(Option<String>):

      The MAC Security (MACsec) CKN to associate with the dedicated connection.

      You can create the CKN/CAK pair using an industry standard tool.

      The valid values are 64 hexadecimal characters (0-9, A-E).

      If you use this request parameter, you must use the cak request parameter and not use the secretARN request parameter.

    • cak(impl Into<String>) / set_cak(Option<String>):

      The MAC Security (MACsec) CAK to associate with the dedicated connection.

      You can create the CKN/CAK pair using an industry standard tool.

      The valid values are 64 hexadecimal characters (0-9, A-E).

      If you use this request parameter, you must use the ckn request parameter and not use the secretARN request parameter.

  • On success, responds with AssociateMacSecKeyOutput with field(s):
  • On failure, responds with SdkError<AssociateMacSecKeyError>

Constructs a fluent builder for the AssociateVirtualInterface operation.

Constructs a fluent builder for the ConfirmConnection operation.

  • The fluent builder is configurable:
  • On success, responds with ConfirmConnectionOutput with field(s):
    • connection_state(Option<ConnectionState>):

      The state of the connection. The following are the possible values:

      • ordering: The initial state of a hosted connection provisioned on an interconnect. The connection stays in the ordering state until the owner of the hosted connection confirms or declines the connection order.

      • requested: The initial state of a standard connection. The connection stays in the requested state until the Letter of Authorization (LOA) is sent to the customer.

      • pending: The connection has been approved and is being initialized.

      • available: The network link is up and the connection is ready for use.

      • down: The network link is down.

      • deleting: The connection is being deleted.

      • deleted: The connection has been deleted.

      • rejected: A hosted connection in the ordering state enters the rejected state if it is deleted by the customer.

      • unknown: The state of the connection is not available.

  • On failure, responds with SdkError<ConfirmConnectionError>

Constructs a fluent builder for the ConfirmCustomerAgreement operation.

Constructs a fluent builder for the ConfirmPrivateVirtualInterface operation.

  • The fluent builder is configurable:
  • On success, responds with ConfirmPrivateVirtualInterfaceOutput with field(s):
    • virtual_interface_state(Option<VirtualInterfaceState>):

      The state of the virtual interface. The following are the possible values:

      • confirming: The creation of the virtual interface is pending confirmation from the virtual interface owner. If the owner of the virtual interface is different from the owner of the connection on which it is provisioned, then the virtual interface will remain in this state until it is confirmed by the virtual interface owner.

      • verifying: This state only applies to public virtual interfaces. Each public virtual interface needs validation before the virtual interface can be created.

      • pending: A virtual interface is in this state from the time that it is created until the virtual interface is ready to forward traffic.

      • available: A virtual interface that is able to forward traffic.

      • down: A virtual interface that is BGP down.

      • deleting: A virtual interface is in this state immediately after calling DeleteVirtualInterface until it can no longer forward traffic.

      • deleted: A virtual interface that cannot forward traffic.

      • rejected: The virtual interface owner has declined creation of the virtual interface. If a virtual interface in the Confirming state is deleted by the virtual interface owner, the virtual interface enters the Rejected state.

      • unknown: The state of the virtual interface is not available.

  • On failure, responds with SdkError<ConfirmPrivateVirtualInterfaceError>

Constructs a fluent builder for the ConfirmPublicVirtualInterface operation.

  • The fluent builder is configurable:
  • On success, responds with ConfirmPublicVirtualInterfaceOutput with field(s):
    • virtual_interface_state(Option<VirtualInterfaceState>):

      The state of the virtual interface. The following are the possible values:

      • confirming: The creation of the virtual interface is pending confirmation from the virtual interface owner. If the owner of the virtual interface is different from the owner of the connection on which it is provisioned, then the virtual interface will remain in this state until it is confirmed by the virtual interface owner.

      • verifying: This state only applies to public virtual interfaces. Each public virtual interface needs validation before the virtual interface can be created.

      • pending: A virtual interface is in this state from the time that it is created until the virtual interface is ready to forward traffic.

      • available: A virtual interface that is able to forward traffic.

      • down: A virtual interface that is BGP down.

      • deleting: A virtual interface is in this state immediately after calling DeleteVirtualInterface until it can no longer forward traffic.

      • deleted: A virtual interface that cannot forward traffic.

      • rejected: The virtual interface owner has declined creation of the virtual interface. If a virtual interface in the Confirming state is deleted by the virtual interface owner, the virtual interface enters the Rejected state.

      • unknown: The state of the virtual interface is not available.

  • On failure, responds with SdkError<ConfirmPublicVirtualInterfaceError>

Constructs a fluent builder for the ConfirmTransitVirtualInterface operation.

  • The fluent builder is configurable:
  • On success, responds with ConfirmTransitVirtualInterfaceOutput with field(s):
    • virtual_interface_state(Option<VirtualInterfaceState>):

      The state of the virtual interface. The following are the possible values:

      • confirming: The creation of the virtual interface is pending confirmation from the virtual interface owner. If the owner of the virtual interface is different from the owner of the connection on which it is provisioned, then the virtual interface will remain in this state until it is confirmed by the virtual interface owner.

      • verifying: This state only applies to public virtual interfaces. Each public virtual interface needs validation before the virtual interface can be created.

      • pending: A virtual interface is in this state from the time that it is created until the virtual interface is ready to forward traffic.

      • available: A virtual interface that is able to forward traffic.

      • down: A virtual interface that is BGP down.

      • deleting: A virtual interface is in this state immediately after calling DeleteVirtualInterface until it can no longer forward traffic.

      • deleted: A virtual interface that cannot forward traffic.

      • rejected: The virtual interface owner has declined creation of the virtual interface. If a virtual interface in the Confirming state is deleted by the virtual interface owner, the virtual interface enters the Rejected state.

      • unknown: The state of the virtual interface is not available.

  • On failure, responds with SdkError<ConfirmTransitVirtualInterfaceError>

Constructs a fluent builder for the CreateBGPPeer operation.

Constructs a fluent builder for the CreateConnection operation.

Constructs a fluent builder for the CreateDirectConnectGateway operation.

Constructs a fluent builder for the CreateDirectConnectGatewayAssociation operation.

Constructs a fluent builder for the CreateDirectConnectGatewayAssociationProposal operation.

Constructs a fluent builder for the CreateInterconnect operation.

Constructs a fluent builder for the CreateLag operation.

Constructs a fluent builder for the CreatePrivateVirtualInterface operation.

Constructs a fluent builder for the CreatePublicVirtualInterface operation.

Constructs a fluent builder for the CreateTransitVirtualInterface operation.

Constructs a fluent builder for the DeleteBGPPeer operation.

Constructs a fluent builder for the DeleteConnection operation.

Constructs a fluent builder for the DeleteDirectConnectGateway operation.

Constructs a fluent builder for the DeleteDirectConnectGatewayAssociation operation.

Constructs a fluent builder for the DeleteDirectConnectGatewayAssociationProposal operation.

Constructs a fluent builder for the DeleteInterconnect operation.

Constructs a fluent builder for the DeleteLag operation.

Constructs a fluent builder for the DeleteVirtualInterface operation.

  • The fluent builder is configurable:
  • On success, responds with DeleteVirtualInterfaceOutput with field(s):
    • virtual_interface_state(Option<VirtualInterfaceState>):

      The state of the virtual interface. The following are the possible values:

      • confirming: The creation of the virtual interface is pending confirmation from the virtual interface owner. If the owner of the virtual interface is different from the owner of the connection on which it is provisioned, then the virtual interface will remain in this state until it is confirmed by the virtual interface owner.

      • verifying: This state only applies to public virtual interfaces. Each public virtual interface needs validation before the virtual interface can be created.

      • pending: A virtual interface is in this state from the time that it is created until the virtual interface is ready to forward traffic.

      • available: A virtual interface that is able to forward traffic.

      • down: A virtual interface that is BGP down.

      • deleting: A virtual interface is in this state immediately after calling DeleteVirtualInterface until it can no longer forward traffic.

      • deleted: A virtual interface that cannot forward traffic.

      • rejected: The virtual interface owner has declined creation of the virtual interface. If a virtual interface in the Confirming state is deleted by the virtual interface owner, the virtual interface enters the Rejected state.

      • unknown: The state of the virtual interface is not available.

  • On failure, responds with SdkError<DeleteVirtualInterfaceError>

Constructs a fluent builder for the DescribeConnectionLoa operation.

Constructs a fluent builder for the DescribeConnections operation.

Constructs a fluent builder for the DescribeConnectionsOnInterconnect operation.

Constructs a fluent builder for the DescribeCustomerMetadata operation.

Constructs a fluent builder for the DescribeDirectConnectGatewayAssociationProposals operation.

Constructs a fluent builder for the DescribeDirectConnectGatewayAssociations operation.

Constructs a fluent builder for the DescribeDirectConnectGatewayAttachments operation.

Constructs a fluent builder for the DescribeDirectConnectGateways operation.

Constructs a fluent builder for the DescribeHostedConnections operation.

Constructs a fluent builder for the DescribeInterconnectLoa operation.

Constructs a fluent builder for the DescribeInterconnects operation.

Constructs a fluent builder for the DescribeLags operation.

Constructs a fluent builder for the DescribeLoa operation.

Constructs a fluent builder for the DescribeLocations operation.

Constructs a fluent builder for the DescribeRouterConfiguration operation.

Constructs a fluent builder for the DescribeTags operation.

Constructs a fluent builder for the DescribeVirtualGateways operation.

Constructs a fluent builder for the DescribeVirtualInterfaces operation.

Constructs a fluent builder for the DisassociateConnectionFromLag operation.

Constructs a fluent builder for the DisassociateMacSecKey operation.

Constructs a fluent builder for the ListVirtualInterfaceTestHistory operation.

Constructs a fluent builder for the StartBgpFailoverTest operation.

Constructs a fluent builder for the StopBgpFailoverTest operation.

Constructs a fluent builder for the TagResource operation.

Constructs a fluent builder for the UntagResource operation.

Constructs a fluent builder for the UpdateConnection operation.

Constructs a fluent builder for the UpdateDirectConnectGateway operation.

Constructs a fluent builder for the UpdateDirectConnectGatewayAssociation operation.

Constructs a fluent builder for the UpdateLag operation.

Constructs a fluent builder for the UpdateVirtualInterfaceAttributes operation.

Creates a client with the given service config and connector override.

Creates a new client from a shared config.

Creates a new client from the service Config.

Trait Implementations

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Converts to this type from the input type.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more