Struct aws_sdk_fsx::client::fluent_builders::AssociateFileSystemAliases

pub struct AssociateFileSystemAliases { /* private fields */ }

Fluent builder constructing a request to AssociateFileSystemAliases.

Use this action to associate one or more Domain Name Server (DNS) aliases with an existing Amazon FSx for Windows File Server file system. A file system can have a maximum of 50 DNS aliases associated with it at any one time. If you try to associate a DNS alias that is already associated with the file system, FSx takes no action on that alias in the request. For more information, see Working with DNS Aliases and Walkthrough 5: Using DNS aliases to access your file system, including additional steps you must take to be able to access your file system using a DNS alias.

The system response shows the DNS aliases that Amazon FSx is attempting to associate with the file system. Use the API operation to monitor the status of the aliases Amazon FSx is associating with the file system.

Implementations

impl AssociateFileSystemAliases

pub async fn send(
    self
) -> Result<AssociateFileSystemAliasesOutput, SdkError<AssociateFileSystemAliasesError>>

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 client_request_token(self, input: impl Into<String>) -> Self

(Optional) An idempotency token for resource creation, in a string of up to 64 ASCII characters. This token is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.

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

(Optional) An idempotency token for resource creation, in a string of up to 64 ASCII characters. This token is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.

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

Specifies the file system with which you want to associate one or more DNS aliases.

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

Specifies the file system with which you want to associate one or more DNS aliases.

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

Appends an item to Aliases.

To override the contents of this collection use set_aliases.

An array of one or more DNS alias names to associate with the file system. The alias name has to comply with the following formatting requirements:

• Formatted as a fully-qualified domain name (FQDN), hostname.domain , for example, accounting.corp.example.com.

• Can contain alphanumeric characters and the hyphen (-).

• Cannot start or end with a hyphen.

• Can start with a numeric.

For DNS alias names, Amazon FSx stores alphabetic characters as lowercase letters (a-z), regardless of how you specify them: as uppercase letters, lowercase letters, or the corresponding letters in escape codes.

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

An array of one or more DNS alias names to associate with the file system. The alias name has to comply with the following formatting requirements:

• Formatted as a fully-qualified domain name (FQDN), hostname.domain , for example, accounting.corp.example.com.

• Can contain alphanumeric characters and the hyphen (-).

• Cannot start or end with a hyphen.

• Can start with a numeric.

For DNS alias names, Amazon FSx stores alphabetic characters as lowercase letters (a-z), regardless of how you specify them: as uppercase letters, lowercase letters, or the corresponding letters in escape codes.

Trait Implementations

impl Clone for AssociateFileSystemAliases

fn clone(&self) -> AssociateFileSystemAliases

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AssociateFileSystemAliases

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

Formats the value using the given formatter.