Struct ObjectMethods

pub struct ObjectMethods<'a, C>
where
    C: 'a,
{ /* private fields */ }

A builder providing access to all methods supported on object resources. It is not used directly, but through the Storage hub.

Example

Instantiate a resource builder

extern crate hyper;
extern crate hyper_rustls;
extern crate google_storage1 as storage1;

use storage1::{Storage, FieldMask, hyper_rustls, hyper_util, yup_oauth2};

let secret: yup_oauth2::ApplicationSecret = Default::default();
let auth = yup_oauth2::InstalledFlowAuthenticator::builder(
    secret,
    yup_oauth2::InstalledFlowReturnMethod::HTTPRedirect,
).build().await.unwrap();

let client = hyper_util::client::legacy::Client::builder(
    hyper_util::rt::TokioExecutor::new()
)
.build(
    hyper_rustls::HttpsConnectorBuilder::new()
        .with_native_roots()
        .unwrap()
        .https_or_http()
        .enable_http1()
        .build()
);
let mut hub = Storage::new(client, auth);
// Usually you wouldn't bind this to a variable, but keep calling *CallBuilders*
// like `bulk_restore(...)`, `compose(...)`, `copy(...)`, `delete(...)`, `get(...)`, `get_iam_policy(...)`, `insert(...)`, `list(...)`, `patch(...)`, `restore(...)`, `rewrite(...)`, `set_iam_policy(...)`, `test_iam_permissions(...)`, `update(...)` and `watch_all(...)`
// to build up your call.
let rb = hub.objects();

Implementations

impl<'a, C> ObjectMethods<'a, C>

pub fn bulk_restore( &self, request: BulkRestoreObjectsRequest, bucket: &str, ) -> ObjectBulkRestoreCall<'a, C>

Create a builder to help you perform the following task:

Initiates a long-running bulk restore operation on the specified bucket.

Arguments

• request - No description provided.
• bucket - Name of the bucket in which the object resides.

pub fn compose( &self, request: ComposeRequest, destination_bucket: &str, destination_object: &str, ) -> ObjectComposeCall<'a, C>

Create a builder to help you perform the following task:

Concatenates a list of existing objects into a new object in the same bucket.

Arguments

• request - No description provided.
• destinationBucket - Name of the bucket containing the source objects. The destination object is stored in this bucket.
• destinationObject - Name of the new object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn copy( &self, request: Object, source_bucket: &str, source_object: &str, destination_bucket: &str, destination_object: &str, ) -> ObjectCopyCall<'a, C>

Create a builder to help you perform the following task:

Copies a source object to a destination object. Optionally overrides metadata.

Arguments

• request - No description provided.
• sourceBucket - Name of the bucket in which to find the source object.
• sourceObject - Name of the source object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
• destinationBucket - Name of the bucket in which to store the new object. Overrides the provided object metadata’s bucket value, if any.For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
• destinationObject - Name of the new object. Required when the object metadata is not otherwise provided. Overrides the object metadata’s name value, if any.

pub fn delete(&self, bucket: &str, object: &str) -> ObjectDeleteCall<'a, C>

Create a builder to help you perform the following task:

Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used.

Arguments

• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn get(&self, bucket: &str, object: &str) -> ObjectGetCall<'a, C>

Create a builder to help you perform the following task:

Retrieves an object or its metadata.

Arguments

• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn get_iam_policy( &self, bucket: &str, object: &str, ) -> ObjectGetIamPolicyCall<'a, C>

Create a builder to help you perform the following task:

Returns an IAM policy for the specified object.

Arguments

• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn insert(&self, request: Object, bucket: &str) -> ObjectInsertCall<'a, C>

Create a builder to help you perform the following task:

Stores a new object and metadata.

Arguments

• request - No description provided.
• bucket - Name of the bucket in which to store the new object. Overrides the provided object metadata’s bucket value, if any.

pub fn list(&self, bucket: &str) -> ObjectListCall<'a, C>

Create a builder to help you perform the following task:

Retrieves a list of objects matching the criteria.

Arguments

• bucket - Name of the bucket in which to look for objects.

pub fn patch( &self, request: Object, bucket: &str, object: &str, ) -> ObjectPatchCall<'a, C>

Create a builder to help you perform the following task:

Patches an object’s metadata.

Arguments

• request - No description provided.
• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn restore( &self, bucket: &str, object: &str, generation: i64, ) -> ObjectRestoreCall<'a, C>

Create a builder to help you perform the following task:

Restores a soft-deleted object.

Arguments

• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
• generation - Selects a specific revision of this object.

pub fn rewrite( &self, request: Object, source_bucket: &str, source_object: &str, destination_bucket: &str, destination_object: &str, ) -> ObjectRewriteCall<'a, C>

Create a builder to help you perform the following task:

Rewrites a source object to a destination object. Optionally overrides metadata.

Arguments

• request - No description provided.
• sourceBucket - Name of the bucket in which to find the source object.
• sourceObject - Name of the source object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
• destinationBucket - Name of the bucket in which to store the new object. Overrides the provided object metadata’s bucket value, if any.
• destinationObject - Name of the new object. Required when the object metadata is not otherwise provided. Overrides the object metadata’s name value, if any. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn set_iam_policy( &self, request: Policy, bucket: &str, object: &str, ) -> ObjectSetIamPolicyCall<'a, C>

Create a builder to help you perform the following task:

Updates an IAM policy for the specified object.

Arguments

• request - No description provided.
• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn test_iam_permissions( &self, bucket: &str, object: &str, permissions: &Vec<String>, ) -> ObjectTestIamPermissionCall<'a, C>

Create a builder to help you perform the following task:

Tests a set of permissions on the given object to see which, if any, are held by the caller.

Arguments

• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.
• permissions - Permissions to test.

pub fn update( &self, request: Object, bucket: &str, object: &str, ) -> ObjectUpdateCall<'a, C>

Create a builder to help you perform the following task:

Updates an object’s metadata.

Arguments

• request - No description provided.
• bucket - Name of the bucket in which the object resides.
• object - Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

pub fn watch_all( &self, request: Channel, bucket: &str, ) -> ObjectWatchAllCall<'a, C>

Create a builder to help you perform the following task:

Watch for changes on all objects in a bucket.

Arguments

• request - No description provided.
• bucket - Name of the bucket in which to look for objects.

Trait Implementations

impl<'a, C> MethodsBuilder for ObjectMethods<'a, C>