aws_sdk_datasync/client/
update_location_s3.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`UpdateLocationS3`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`location_arn(impl Into<String>)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::location_arn) / [`set_location_arn(Option<String>)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::set_location_arn):<br>required: **true**<br><p>Specifies the Amazon Resource Name (ARN) of the Amazon S3 transfer location that you're updating.</p><br>
    ///   - [`subdirectory(impl Into<String>)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::subdirectory) / [`set_subdirectory(Option<String>)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::set_subdirectory):<br>required: **false**<br><p>Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).</p><note>  <p>DataSync can't transfer objects with a prefix that begins with a slash (<code>/</code>) or includes <code>//</code>, <code>/./</code>, or <code>/../</code> patterns. For example:</p>  <ul>   <li>    <p><code>/photos</code></p></li>   <li>    <p><code>photos//2006/January</code></p></li>   <li>    <p><code>photos/./2006/February</code></p></li>   <li>    <p><code>photos/../2006/March</code></p></li>  </ul> </note><br>
    ///   - [`s3_storage_class(S3StorageClass)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::s3_storage_class) / [`set_s3_storage_class(Option<S3StorageClass>)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::set_s3_storage_class):<br>required: **false**<br><p>Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.</p> <p>For buckets in Amazon Web Services Regions, the storage class defaults to <code>STANDARD</code>. For buckets on Outposts, the storage class defaults to <code>OUTPOSTS</code>.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes">Storage class considerations with Amazon S3 transfers</a>.</p><br>
    ///   - [`s3_config(S3Config)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::s3_config) / [`set_s3_config(Option<S3Config>)`](crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::set_s3_config):<br>required: **false**<br><p>Specifies the Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access">Providing DataSync access to S3 buckets</a>.</p><br>
    /// - On success, responds with [`UpdateLocationS3Output`](crate::operation::update_location_s3::UpdateLocationS3Output)
    /// - On failure, responds with [`SdkError<UpdateLocationS3Error>`](crate::operation::update_location_s3::UpdateLocationS3Error)
    pub fn update_location_s3(&self) -> crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder {
        crate::operation::update_location_s3::builders::UpdateLocationS3FluentBuilder::new(self.handle.clone())
    }
}