Skip to main content

Disks

Struct Disks 

Source
pub struct Disks { /* private fields */ }
Available on crate feature disks only.
Expand description

Implements a client for the Google Compute Engine API.

§Example

let client = Disks::builder().build().await?;
// use `client` to make requests to the Google Compute Engine API.

§Service Description

Service for the disks resource.

§Configuration

To configure Disks use the with_* methods in the type returned by builder(). The default configuration should work for most applications. Common configuration changes include

  • with_endpoint(): by default this client uses the global default endpoint (https://compute.googleapis.com). Applications using regional endpoints or running in restricted networks (e.g. a network configured override this default.
  • with_credentials(): by default this client uses Application Default Credentials. Applications using custom authentication may need to override this default.

§Pooling and Cloning

Disks holds a connection pool internally, it is advised to create one and the reuse it. You do not need to wrap Disks in an Rc or Arc to reuse it, because it already uses an Arc internally.

Implementations§

Source§

impl Disks

Source

pub fn builder() -> ClientBuilder

Returns a builder for Disks.

let client = Disks::builder().build().await?;
Source

pub fn from_stub<T>(stub: T) -> Self
where T: Disks + 'static,

Creates a new client from the provided stub.

The most common case for calling this function is in tests mocking the client’s behavior.

Source

pub fn add_resource_policies(&self) -> AddResourcePolicies

Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation.

Source

pub fn aggregated_list(&self) -> AggregatedList

Retrieves an aggregated list of persistent disks.

To prevent failure, it is recommended that you set the returnPartialSuccess parameter to true.

Source

pub fn bulk_insert(&self) -> BulkInsert

Bulk create a set of disks.

Source

pub fn bulk_set_labels(&self) -> BulkSetLabels

Sets the labels on many disks at once. To learn more about labels, read theLabeling Resources documentation.

Source

pub fn create_snapshot(&self) -> CreateSnapshot

Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project.

Source

pub fn delete(&self) -> Delete

Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separatelydelete snapshots.

Source

pub fn get(&self) -> Get

Returns the specified persistent disk.

Source

pub fn get_iam_policy(&self) -> GetIamPolicy

Gets the access control policy for a resource. May be empty if no such policy or resource exists.

Source

pub fn insert(&self) -> Insert

Creates a persistent disk in the specified project using the data in the request. You can create a disk from a source (sourceImage, sourceSnapshot, orsourceDisk) or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.

Source

pub fn list(&self) -> List

Retrieves a list of persistent disks contained within the specified zone.

Source

pub fn remove_resource_policies(&self) -> RemoveResourcePolicies

Removes resource policies from a disk.

Source

pub fn resize(&self) -> Resize

Resizes the specified persistent disk. You can only increase the size of the disk.

Source

pub fn set_iam_policy(&self) -> SetIamPolicy

Sets the access control policy on the specified resource. Replaces any existing policy.

Source

pub fn set_labels(&self) -> SetLabels

Sets the labels on a disk. To learn more about labels, read theLabeling Resources documentation.

Source

pub fn start_async_replication(&self) -> StartAsyncReplication

Starts asynchronous replication. Must be invoked on the primary disk.

Source

pub fn stop_async_replication(&self) -> StopAsyncReplication

Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk.

Source

pub fn stop_group_async_replication(&self) -> StopGroupAsyncReplication

Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope.

Source

pub fn test_iam_permissions(&self) -> TestIamPermissions

Returns permissions that a caller has on the specified resource.

Source

pub fn update(&self) -> Update

Updates the specified disk with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license.

Source

pub fn get_operation(&self) -> GetOperation

Retrieves the specified zone-specific Operations resource.

Trait Implementations§

Source§

impl Clone for Disks

Source§

fn clone(&self) -> Disks

Returns a duplicate 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 Disks

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl Freeze for Disks

§

impl !RefUnwindSafe for Disks

§

impl Send for Disks

§

impl Sync for Disks

§

impl Unpin for Disks

§

impl !UnwindSafe for Disks

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

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

Source§

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>,

Source§

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>,

Source§

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<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

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