Struct aws_sdk_s3::client::fluent_builders::GetPublicAccessBlock

pub struct GetPublicAccessBlock { /* private fields */ }

Fluent builder constructing a request to GetPublicAccessBlock.

Retrieves the PublicAccessBlock configuration for an Amazon S3 bucket. To use this operation, you must have the s3:GetBucketPublicAccessBlock permission. For more information about Amazon S3 permissions, see Specifying Permissions in a Policy.

When Amazon S3 evaluates the PublicAccessBlock configuration for a bucket or an object, it checks the PublicAccessBlock configuration for both the bucket (or the bucket that contains the object) and the bucket owner's account. If the PublicAccessBlock settings are different between the bucket and the account, Amazon S3 uses the most restrictive combination of the bucket-level and account-level settings.

For more information about when Amazon S3 considers a bucket or an object public, see The Meaning of "Public".

The following operations are related to GetPublicAccessBlock:

• Using Amazon S3 Block Public Access

• PutPublicAccessBlock

• GetPublicAccessBlock

• DeletePublicAccessBlock

Implementations

impl GetPublicAccessBlock

pub async fn customize(
    self
) -> Result<CustomizableOperation<GetPublicAccessBlock, AwsResponseRetryClassifier>, SdkError<GetPublicAccessBlockError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<GetPublicAccessBlockOutput, SdkError<GetPublicAccessBlockError>>

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

The name of the Amazon S3 bucket whose PublicAccessBlock configuration you want to retrieve.

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

The name of the Amazon S3 bucket whose PublicAccessBlock configuration you want to retrieve.

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

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

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

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

Trait Implementations

impl Clone for GetPublicAccessBlock

fn clone(&self) -> GetPublicAccessBlock

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GetPublicAccessBlock

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

Formats the value using the given formatter.