Struct aws_sdk_s3::client::fluent_builders::GetBucketAccelerateConfiguration [−][src]
pub struct GetBucketAccelerateConfiguration<C = DynConnector, M = AwsMiddleware, R = Standard> { /* fields omitted */ }
Expand description
Fluent builder constructing a request to GetBucketAccelerateConfiguration
.
This implementation of the GET action uses the accelerate
subresource to
return the Transfer Acceleration state of a bucket, which is either Enabled
or
Suspended
. Amazon S3 Transfer Acceleration is a bucket-level feature that
enables you to perform faster data transfers to and from Amazon S3.
To use this operation, you must have permission to perform the
s3:GetAccelerateConfiguration
action. The bucket owner has this permission
by default. The bucket owner can grant this permission to others. For more information
about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to your Amazon S3
Resources in the Amazon S3 User Guide.
You set the Transfer Acceleration state of an existing bucket to Enabled
or
Suspended
by using the PutBucketAccelerateConfiguration operation.
A GET accelerate
request does not return a state value for a bucket that
has no transfer acceleration state. A bucket has no Transfer Acceleration state if a state
has never been set on the bucket.
For more information about transfer acceleration, see Transfer Acceleration in the Amazon S3 User Guide.
Related Resources
Implementations
impl<C, M, R> GetBucketAccelerateConfiguration<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
impl<C, M, R> GetBucketAccelerateConfiguration<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
pub async fn send(
self
) -> Result<GetBucketAccelerateConfigurationOutput, SdkError<GetBucketAccelerateConfigurationError>> where
R::Policy: SmithyRetryPolicy<GetBucketAccelerateConfigurationInputOperationOutputAlias, GetBucketAccelerateConfigurationOutput, GetBucketAccelerateConfigurationError, GetBucketAccelerateConfigurationInputOperationRetryAlias>,
pub async fn send(
self
) -> Result<GetBucketAccelerateConfigurationOutput, SdkError<GetBucketAccelerateConfigurationError>> where
R::Policy: SmithyRetryPolicy<GetBucketAccelerateConfigurationInputOperationOutputAlias, GetBucketAccelerateConfigurationOutput, GetBucketAccelerateConfigurationError, GetBucketAccelerateConfigurationInputOperationRetryAlias>,
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.
The name of the bucket for which the accelerate configuration is retrieved.
The name of the bucket for which the accelerate configuration is retrieved.
The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied)
error.
The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied)
error.
Trait Implementations
Auto Trait Implementations
impl<C = DynConnector, M = AwsMiddleware, R = Standard> !RefUnwindSafe for GetBucketAccelerateConfiguration<C, M, R>
impl<C, M, R> Send for GetBucketAccelerateConfiguration<C, M, R> where
C: Send + Sync,
M: Send + Sync,
R: Send + Sync,
impl<C, M, R> Sync for GetBucketAccelerateConfiguration<C, M, R> where
C: Send + Sync,
M: Send + Sync,
R: Send + Sync,
impl<C, M, R> Unpin for GetBucketAccelerateConfiguration<C, M, R>
impl<C = DynConnector, M = AwsMiddleware, R = Standard> !UnwindSafe for GetBucketAccelerateConfiguration<C, M, R>
Blanket Implementations
Mutably borrows from an owned value. Read more
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