Struct aws_sdk_s3::client::fluent_builders::GetBucketPolicy [−][src]
pub struct GetBucketPolicy<C = DynConnector, M = AwsMiddleware, R = Standard> { /* fields omitted */ }
Expand description
Fluent builder constructing a request to GetBucketPolicy
.
Returns the policy of a specified bucket. If you are using an identity other than the
root user of the Amazon Web Services account that owns the bucket, the calling identity must have the
GetBucketPolicy
permissions on the specified bucket and belong to the
bucket owner's account in order to use this operation.
If you don't have GetBucketPolicy
permissions, Amazon S3 returns a 403
Access Denied
error. If you have the correct permissions, but you're not using an
identity that belongs to the bucket owner's account, Amazon S3 returns a 405 Method Not
Allowed
error.
As a security precaution, the root user of the Amazon Web Services account that owns a bucket can always use this operation, even if the policy explicitly denies the root user the ability to perform this action.
For more information about bucket policies, see Using Bucket Policies and User Policies.
The following action is related to GetBucketPolicy
:
Implementations
impl<C, M, R> GetBucketPolicy<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
impl<C, M, R> GetBucketPolicy<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
pub async fn send(
self
) -> Result<GetBucketPolicyOutput, SdkError<GetBucketPolicyError>> where
R::Policy: SmithyRetryPolicy<GetBucketPolicyInputOperationOutputAlias, GetBucketPolicyOutput, GetBucketPolicyError, GetBucketPolicyInputOperationRetryAlias>,
pub async fn send(
self
) -> Result<GetBucketPolicyOutput, SdkError<GetBucketPolicyError>> where
R::Policy: SmithyRetryPolicy<GetBucketPolicyInputOperationOutputAlias, GetBucketPolicyOutput, GetBucketPolicyError, GetBucketPolicyInputOperationRetryAlias>,
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 bucket name for which to get the bucket policy.
The bucket name for which to get the bucket policy.
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 GetBucketPolicy<C, M, R>
impl<C, M, R> Send for GetBucketPolicy<C, M, R> where
C: Send + Sync,
M: Send + Sync,
R: Send + Sync,
impl<C, M, R> Sync for GetBucketPolicy<C, M, R> where
C: Send + Sync,
M: Send + Sync,
R: Send + Sync,
impl<C, M, R> Unpin for GetBucketPolicy<C, M, R>
impl<C = DynConnector, M = AwsMiddleware, R = Standard> !UnwindSafe for GetBucketPolicy<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