aws_sdk_datasync/client/
create_location_efs.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateLocationEfs`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`subdirectory(impl Into<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::subdirectory) / [`set_subdirectory(Option<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::set_subdirectory):<br>required: **false**<br><p>Specifies a mount path for your Amazon EFS file system. This is where DataSync reads or writes data on your file system (depending on if this is a source or destination location).</p> <p>By default, DataSync uses the root directory (or <a href="https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html">access point</a> if you provide one by using <code>AccessPointArn</code>). You can also include subdirectories using forward slashes (for example, <code>/path/to/folder</code>).</p><br>
    ///   - [`efs_filesystem_arn(impl Into<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::efs_filesystem_arn) / [`set_efs_filesystem_arn(Option<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::set_efs_filesystem_arn):<br>required: **true**<br><p>Specifies the ARN for your Amazon EFS file system.</p><br>
    ///   - [`ec2_config(Ec2Config)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::ec2_config) / [`set_ec2_config(Option<Ec2Config>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::set_ec2_config):<br>required: **true**<br><p>Specifies the subnet and security groups DataSync uses to connect to one of your Amazon EFS file system's <a href="https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html">mount targets</a>.</p><br>
    ///   - [`tags(TagListEntry)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::tags) / [`set_tags(Option<Vec::<TagListEntry>>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::set_tags):<br>required: **false**<br><p>Specifies the key-value pair that represents a tag that you want to add to the resource. The value can be an empty string. This value helps you manage, filter, and search for your resources. We recommend that you create a name tag for your location.</p><br>
    ///   - [`access_point_arn(impl Into<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::access_point_arn) / [`set_access_point_arn(Option<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::set_access_point_arn):<br>required: **false**<br><p>Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to mount your Amazon EFS file system.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam">Accessing restricted file systems</a>.</p><br>
    ///   - [`file_system_access_role_arn(impl Into<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::file_system_access_role_arn) / [`set_file_system_access_role_arn(Option<String>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::set_file_system_access_role_arn):<br>required: **false**<br><p>Specifies an Identity and Access Management (IAM) role that allows DataSync to access your Amazon EFS file system.</p> <p>For information on creating this role, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role">Creating a DataSync IAM role for file system access</a>.</p><br>
    ///   - [`in_transit_encryption(EfsInTransitEncryption)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::in_transit_encryption) / [`set_in_transit_encryption(Option<EfsInTransitEncryption>)`](crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::set_in_transit_encryption):<br>required: **false**<br><p>Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS file system.</p> <p>If you specify an access point using <code>AccessPointArn</code> or an IAM role using <code>FileSystemAccessRoleArn</code>, you must set this parameter to <code>TLS1_2</code>.</p><br>
    /// - On success, responds with [`CreateLocationEfsOutput`](crate::operation::create_location_efs::CreateLocationEfsOutput) with field(s):
    ///   - [`location_arn(Option<String>)`](crate::operation::create_location_efs::CreateLocationEfsOutput::location_arn): <p>The Amazon Resource Name (ARN) of the Amazon EFS file system location that you create.</p>
    /// - On failure, responds with [`SdkError<CreateLocationEfsError>`](crate::operation::create_location_efs::CreateLocationEfsError)
    pub fn create_location_efs(&self) -> crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder {
        crate::operation::create_location_efs::builders::CreateLocationEfsFluentBuilder::new(self.handle.clone())
    }
}