Struct GetObjectRequest 

#[non_exhaustive]
pub struct GetObjectRequest {
    pub bucket: String,
    pub object: String,
    pub generation: i64,
    pub soft_deleted: Option<bool>,
    pub if_generation_match: Option<i64>,
    pub if_generation_not_match: Option<i64>,
    pub if_metageneration_match: Option<i64>,
    pub if_metageneration_not_match: Option<i64>,
    pub common_object_request_params: Option<CommonObjectRequestParams>,
    pub read_mask: Option<FieldMask>,
    pub restore_token: String,
    /* private fields */
}

Request message for GetObject.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

bucket: String

Required. Name of the bucket in which the object resides.

object: String

Required. Name of the object.

generation: i64

Optional. If present, selects a specific revision of this object (as opposed to the latest version, the default).

soft_deleted: Option<bool>

If true, return the soft-deleted version of this object.

if_generation_match: Option<i64>

Makes the operation conditional on whether the object’s current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.

if_generation_not_match: Option<i64>

Makes the operation conditional on whether the object’s live generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.

if_metageneration_match: Option<i64>

Makes the operation conditional on whether the object’s current metageneration matches the given value.

if_metageneration_not_match: Option<i64>

Makes the operation conditional on whether the object’s current metageneration does not match the given value.

common_object_request_params: Option<CommonObjectRequestParams>

Optional. A set of parameters common to Storage API requests concerning an object.

read_mask: Option<FieldMask>

Mask specifying which fields to read. If no mask is specified, it defaults to all fields except metadata. acl and metadata.owner. * might be used to mean “all fields”.

restore_token: String

Optional. Restore token used to differentiate soft-deleted objects with the same name and generation. Only applicable for hierarchical namespace buckets and if soft_deleted is set to true. This parameter is optional, and is only required in the rare case when there are multiple soft-deleted objects with the same name and generation.

Implementations

impl GetObjectRequest

pub fn new() -> Self

pub fn set_bucket<T: Into<String>>(self, v: T) -> Self

Sets the value of bucket.

pub fn set_object<T: Into<String>>(self, v: T) -> Self

Sets the value of object.

pub fn set_generation<T: Into<i64>>(self, v: T) -> Self

Sets the value of generation.

pub fn set_soft_deleted<T>(self, v: T) -> Self

where T: Into<bool>,

Sets the value of soft_deleted.

pub fn set_or_clear_soft_deleted<T>(self, v: Option<T>) -> Self

where T: Into<bool>,

Sets or clears the value of soft_deleted.

pub fn set_if_generation_match<T>(self, v: T) -> Self

where T: Into<i64>,

Sets the value of if_generation_match.

pub fn set_or_clear_if_generation_match<T>(self, v: Option<T>) -> Self

where T: Into<i64>,

Sets or clears the value of if_generation_match.

pub fn set_if_generation_not_match<T>(self, v: T) -> Self

where T: Into<i64>,

Sets the value of if_generation_not_match.

pub fn set_or_clear_if_generation_not_match<T>(self, v: Option<T>) -> Self

where T: Into<i64>,

Sets or clears the value of if_generation_not_match.

pub fn set_if_metageneration_match<T>(self, v: T) -> Self

where T: Into<i64>,

Sets the value of if_metageneration_match.

pub fn set_or_clear_if_metageneration_match<T>(self, v: Option<T>) -> Self

where T: Into<i64>,

Sets or clears the value of if_metageneration_match.

pub fn set_if_metageneration_not_match<T>(self, v: T) -> Self

where T: Into<i64>,

Sets the value of if_metageneration_not_match.

pub fn set_or_clear_if_metageneration_not_match<T>(self, v: Option<T>) -> Self

where T: Into<i64>,

Sets or clears the value of if_metageneration_not_match.

pub fn set_common_object_request_params<T>(self, v: T) -> Self

where T: Into<CommonObjectRequestParams>,

Sets the value of common_object_request_params.

pub fn set_or_clear_common_object_request_params<T>(self, v: Option<T>) -> Self

where T: Into<CommonObjectRequestParams>,

Sets or clears the value of common_object_request_params.

pub fn set_read_mask<T>(self, v: T) -> Self

where T: Into<FieldMask>,

Sets the value of read_mask.

pub fn set_or_clear_read_mask<T>(self, v: Option<T>) -> Self

where T: Into<FieldMask>,

Sets or clears the value of read_mask.

pub fn set_restore_token<T: Into<String>>(self, v: T) -> Self

Sets the value of restore_token.

Trait Implementations

impl Clone for GetObjectRequest

fn clone(&self) -> GetObjectRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GetObjectRequest

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

Formats the value using the given formatter.

impl Default for GetObjectRequest

fn default() -> GetObjectRequest

Returns the “default value” for a type.

impl Message for GetObjectRequest

fn typename() -> &'static str

The typename of this message.

impl PartialEq for GetObjectRequest

fn eq(&self, other: &GetObjectRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GetObjectRequest