Struct aws_sdk_directconnect::client::fluent_builders::CreateConnection

pub struct CreateConnection { /* private fields */ }

Fluent builder constructing a request to CreateConnection.

Creates a connection between a customer network and a specific Direct Connect location.

A connection 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.

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 Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection is created.

Implementations

impl CreateConnection

pub async fn customize(
    self
) -> Result<CustomizableOperation<CreateConnection, AwsResponseRetryClassifier>, SdkError<CreateConnectionError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<CreateConnectionOutput, SdkError<CreateConnectionError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn location(self, input: impl Into<String>) -> Self

The location of the connection.

pub fn set_location(self, input: Option<String>) -> Self

The location of the connection.

pub fn bandwidth(self, input: impl Into<String>) -> Self

The bandwidth of the connection.

pub fn set_bandwidth(self, input: Option<String>) -> Self

The bandwidth of the connection.

pub fn connection_name(self, input: impl Into<String>) -> Self

The name of the connection.

pub fn set_connection_name(self, input: Option<String>) -> Self

The name of the connection.

pub fn lag_id(self, input: impl Into<String>) -> Self

The ID of the LAG.

pub fn set_lag_id(self, input: Option<String>) -> Self

The ID of the LAG.

pub fn tags(self, input: Tag) -> Self

Appends an item to tags.

To override the contents of this collection use set_tags.

The tags to associate with the lag.

pub fn set_tags(self, input: Option<Vec<Tag>>) -> Self

The tags to associate with the lag.

pub fn provider_name(self, input: impl Into<String>) -> Self

The name of the service provider associated with the requested connection.

pub fn set_provider_name(self, input: Option<String>) -> Self

The name of the service provider associated with the requested connection.

pub fn request_mac_sec(self, input: bool) -> Self

Indicates whether you want the connection to support MAC Security (MACsec).

MAC Security (MACsec) is only available on dedicated connections. For information about MAC Security (MACsec) prerequisties, see MACsec prerequisties in the Direct Connect User Guide.

pub fn set_request_mac_sec(self, input: Option<bool>) -> Self

Indicates whether you want the connection to support MAC Security (MACsec).

MAC Security (MACsec) is only available on dedicated connections. For information about MAC Security (MACsec) prerequisties, see MACsec prerequisties in the Direct Connect User Guide.

Trait Implementations

impl Clone for CreateConnection

fn clone(&self) -> CreateConnection

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CreateConnection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.