pub struct CreateBucketFluentBuilder { /* private fields */ }
Expand description

Fluent builder constructing a request to CreateBucket.

This action creates an Amazon S3 on Outposts bucket. To create an S3 bucket, see Create Bucket in the Amazon S3 API Reference.

Creates a new Outposts bucket. By creating the bucket, you become the bucket owner. To create an Outposts bucket, you must have S3 on Outposts. For more information, see Using Amazon S3 on Outposts in Amazon S3 User Guide.

Not every string is an acceptable bucket name. For information on bucket naming restrictions, see Working with Amazon S3 Buckets.

S3 on Outposts buckets support:

  • Tags

  • LifecycleConfigurations for deleting expired objects

For a complete list of restrictions and Amazon S3 feature limitations on S3 on Outposts, see Amazon S3 on Outposts Restrictions and Limitations.

For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and x-amz-outpost-id in your API request, see the Examples section.

The following actions are related to CreateBucket for Amazon S3 on Outposts:

Implementations§

source§

impl CreateBucketFluentBuilder

source

pub fn as_input(&self) -> &CreateBucketInputBuilder

Access the CreateBucket as a reference.

source

pub async fn send( self ) -> Result<CreateBucketOutput, SdkError<CreateBucketError, HttpResponse>>

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.

source

pub fn customize( self ) -> CustomizableOperation<CreateBucketOutput, CreateBucketError, Self>

Consumes this builder, creating a customizable operation that can be modified before being sent.

source

pub fn acl(self, input: BucketCannedAcl) -> Self

The canned ACL to apply to the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn set_acl(self, input: Option<BucketCannedAcl>) -> Self

The canned ACL to apply to the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_acl(&self) -> &Option<BucketCannedAcl>

The canned ACL to apply to the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

The name of the bucket.

source

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

The name of the bucket.

source

pub fn get_bucket(&self) -> &Option<String>

The name of the bucket.

source

pub fn create_bucket_configuration( self, input: CreateBucketConfiguration ) -> Self

The configuration information for the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn set_create_bucket_configuration( self, input: Option<CreateBucketConfiguration> ) -> Self

The configuration information for the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_create_bucket_configuration( &self ) -> &Option<CreateBucketConfiguration>

The configuration information for the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_grant_full_control(&self) -> &Option<String>

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to list the objects in the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to list the objects in the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_grant_read(&self) -> &Option<String>

Allows grantee to list the objects in the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to read the bucket ACL.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to read the bucket ACL.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_grant_read_acp(&self) -> &Option<String>

Allows grantee to read the bucket ACL.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to create, overwrite, and delete any object in the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to create, overwrite, and delete any object in the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_grant_write(&self) -> &Option<String>

Allows grantee to create, overwrite, and delete any object in the bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to write the ACL for the applicable bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

Allows grantee to write the ACL for the applicable bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_grant_write_acp(&self) -> &Option<String>

Allows grantee to write the ACL for the applicable bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn object_lock_enabled_for_bucket(self, input: bool) -> Self

Specifies whether you want S3 Object Lock to be enabled for the new bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn set_object_lock_enabled_for_bucket(self, input: Option<bool>) -> Self

Specifies whether you want S3 Object Lock to be enabled for the new bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

pub fn get_object_lock_enabled_for_bucket(&self) -> &Option<bool>

Specifies whether you want S3 Object Lock to be enabled for the new bucket.

This is not supported by Amazon S3 on Outposts buckets.

source

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

The ID of the Outposts where the bucket is being created.

This ID is required by Amazon S3 on Outposts buckets.

source

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

The ID of the Outposts where the bucket is being created.

This ID is required by Amazon S3 on Outposts buckets.

source

pub fn get_outpost_id(&self) -> &Option<String>

The ID of the Outposts where the bucket is being created.

This ID is required by Amazon S3 on Outposts buckets.

Trait Implementations§

source§

impl Clone for CreateBucketFluentBuilder

source§

fn clone(&self) -> CreateBucketFluentBuilder

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for CreateBucketFluentBuilder

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more