Struct Bucket 

pub struct Bucket { /* private fields */ }

A handle bound to one exact bucket identity.

Implementations

impl Bucket

pub fn id(&self) -> &str

The opaque bucket identity. Name reuse never revives it.

pub fn name(&self) -> &str

The account-scoped bucket name.

pub fn reference(&self) -> BucketRef

Copy the complete opaque bucket identity for durable application state.

pub async fn destroy(&self, options: MutationOptions) -> Result<bool>

Delete this exact bucket when it has no versions, markers, or multipart uploads.

Errors

Returns an error when the bucket is not empty or the service cannot complete the request.

pub async fn put( &self, object_key: impl Into<String>, body: Bytes, options: PutOptions, ) -> Result<ObjectVersion>

Create one immutable version from buffered bytes.

Errors

Returns an error when the service rejects or cannot complete the request.

pub async fn put_stream<S>( &self, object_key: impl Into<String>, body: S, options: PutOptions, ) -> Result<ObjectVersion>

where S: Stream<Item = Bytes> + Send + 'static,

Stream one immutable version without buffering it in the SDK.

Errors

Returns an error when the service rejects or cannot complete the request.

pub async fn get( &self, object_key: impl Into<String>, options: GetOptions, ) -> Result<StoredObject>

Open a streaming object read.

Errors

Returns an error when the service rejects the read or violates framing.

pub async fn head( &self, object_key: impl Into<String>, options: GetOptions, ) -> Result<ObjectVersion>

Read immutable object metadata without transferring its body.

Errors

Returns an error when the service rejects or cannot complete the request.

pub async fn delete( &self, object_key: impl Into<String>, options: DeleteOptions, ) -> Result<DeleteObjectResponse>

Publish a delete marker or delete one exact immutable version.

Errors

Returns an error when the service rejects or cannot complete the request.

pub async fn list_page(&self, options: ListOptions) -> Result<ListPage>

Read one page from a fixed 24-hour listing view.

Errors

Returns an error when the service rejects or cannot complete the request.

pub async fn snapshot(&self, options: MutationOptions) -> Result<Snapshot>

Capture an immutable whole-bucket snapshot.

Errors

Returns an error when the service rejects or cannot complete the request.

pub async fn fork_current( &self, destination_name: impl Into<String>, options: MutationOptions, ) -> Result<Self>

Atomically fork the current complete bucket state.

Errors

Returns an error when the service rejects or cannot complete the request.

pub async fn create_multipart( &self, object_key: impl Into<String>, options: PutOptions, ) -> Result<MultipartUpload>

Begin a multipart upload.

Errors

Returns an error when the service rejects or cannot complete the request.

Trait Implementations

impl Clone for Bucket

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.