Skip to main content

Volume

Struct Volume 

Source
pub struct Volume {
Show 22 fields pub availability_domain: String, pub compartment_id: String, pub display_name: String, pub id: String, pub lifecycle_state: VolumeLifecycleState, pub size_in_mbs: i64, pub time_created: DateTime<Utc>, pub defined_tags: Option<HashMap<String, HashMap<String, Value>>>, pub freeform_tags: Option<HashMap<String, String>>, pub system_tags: Option<HashMap<String, HashMap<String, Value>>>, pub is_hydrated: Option<bool>, pub kms_key_id: Option<String>, pub vpus_per_gb: Option<i64>, pub cluster_placement_group_id: Option<String>, pub size_in_gbs: Option<i64>, pub source_details: Option<VolumeSourceFromBlockVolumeReplicaDetails>, pub volume_group_id: Option<String>, pub is_auto_tune_enabled: Option<bool>, pub auto_tuned_vpus_per_gb: Option<i64>, pub block_volume_replicas: Option<Vec<BlockVolumeReplicaInfo>>, pub autotune_policies: Option<Vec<AutotunePolicy>>, pub is_reservations_enabled: Option<bool>,
}
Expand description

A detachable block volume device that allows you to dynamically expand the storage capacity of an instance. For more information, see Overview of Cloud Volume Storage.

To use any of the API operations, you must be authorized in an IAM policy. If you’re not authorized, talk to an administrator. If you’re an administrator who needs to write policies to give users access, see Getting Started with Policies.

Warning:* Oracle recommends that you avoid using any confidential information when you supply string values using the API.

Fields§

§availability_domain: String

The availability domain of the volume.

Example: {@code Uocm:PHX-AD-1}

§compartment_id: String

The OCID of the compartment that contains the volume.

§display_name: String

A user-friendly name. Does not have to be unique, and it’s changeable. Avoid entering confidential information.

§id: String

The OCID of the volume.

§lifecycle_state: VolumeLifecycleState

The current state of a volume.

§size_in_mbs: i64

The size of the volume in MBs. This field is deprecated. Use sizeInGBs instead. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues.

§time_created: DateTime<Utc>

The date and time the volume was created. Format defined by RFC3339.

§defined_tags: Option<HashMap<String, HashMap<String, Value>>>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

Example: {@code {"Operations": {"CostCenter": "42"}}}

§freeform_tags: Option<HashMap<String, String>>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags.

Example: {@code {"Department": "Finance"}}

§system_tags: Option<HashMap<String, HashMap<String, Value>>>

System tags for this resource. Each key is predefined and scoped to a namespace. Example: {@code {"foo-namespace": {"bar-key": "value"}}}

§is_hydrated: Option<bool>

Specifies whether the cloned volume’s data has finished copying from the source volume or backup.

§kms_key_id: Option<String>

The OCID of the Vault service key which is the master encryption key for the volume.

§vpus_per_gb: Option<i64>

The number of volume performance units (VPUs) that will be applied to this volume per GB, representing the Block Volume service’s elastic performance options. See Block Volume Performance Levels for more information.

Allowed values:

{@code 0}: Represents Lower Cost option.

{@code 10}: Represents Balanced option.

{@code 20}: Represents Higher Performance option.

{@code 30}-{@code 120}: Represents the Ultra High Performance option.

For performance autotune enabled volumes, It would be the Default(Minimum) VPUs/GB. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues.

§cluster_placement_group_id: Option<String>

The clusterPlacementGroup Id of the volume for volume placement.

§size_in_gbs: Option<i64>

The size of the volume in GBs. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues.

§source_details: Option<VolumeSourceFromBlockVolumeReplicaDetails>§volume_group_id: Option<String>

The OCID of the source volume group.

§is_auto_tune_enabled: Option<bool>

Specifies whether the auto-tune performance is enabled for this volume. This field is deprecated. Use the {@code DetachedVolumeAutotunePolicy} instead to enable the volume for detached autotune.

§auto_tuned_vpus_per_gb: Option<i64>

The number of Volume Performance Units per GB that this volume is effectively tuned to. Note: Numbers greater than Number.MAX_SAFE_INTEGER will result in rounding issues.

§block_volume_replicas: Option<Vec<BlockVolumeReplicaInfo>>

The list of block volume replicas of this volume.

§autotune_policies: Option<Vec<AutotunePolicy>>

The list of autotune policies enabled for this volume.

§is_reservations_enabled: Option<bool>

When set to true, enables SCSI Persistent Reservation (SCSI PR) for the volume. For more information, see Persistent Reservations.

Implementations§

Source§

impl Volume

Source

pub fn new(required: VolumeRequired) -> Self

Create a new Volume with required fields

Source

pub fn set_availability_domain(self, value: String) -> Self

Set availability_domain

Source

pub fn set_compartment_id(self, value: String) -> Self

Set compartment_id

Source

pub fn set_defined_tags( self, value: Option<HashMap<String, HashMap<String, Value>>>, ) -> Self

Set defined_tags

Source

pub fn set_display_name(self, value: String) -> Self

Set display_name

Source

pub fn set_freeform_tags(self, value: Option<HashMap<String, String>>) -> Self

Set freeform_tags

Source

pub fn set_system_tags( self, value: Option<HashMap<String, HashMap<String, Value>>>, ) -> Self

Set system_tags

Source

pub fn set_id(self, value: String) -> Self

Set id

Source

pub fn set_is_hydrated(self, value: Option<bool>) -> Self

Set is_hydrated

Source

pub fn set_kms_key_id(self, value: Option<String>) -> Self

Set kms_key_id

Source

pub fn set_lifecycle_state(self, value: VolumeLifecycleState) -> Self

Set lifecycle_state

Source

pub fn set_vpus_per_gb(self, value: Option<i64>) -> Self

Set vpus_per_gb

Source

pub fn set_cluster_placement_group_id(self, value: Option<String>) -> Self

Set cluster_placement_group_id

Source

pub fn set_size_in_gbs(self, value: Option<i64>) -> Self

Set size_in_gbs

Source

pub fn set_size_in_mbs(self, value: i64) -> Self

Set size_in_mbs

Source

pub fn set_source_details( self, value: Option<VolumeSourceFromBlockVolumeReplicaDetails>, ) -> Self

Set source_details

Source

pub fn set_time_created(self, value: DateTime<Utc>) -> Self

Set time_created

Source

pub fn set_volume_group_id(self, value: Option<String>) -> Self

Set volume_group_id

Source

pub fn set_is_auto_tune_enabled(self, value: Option<bool>) -> Self

Set is_auto_tune_enabled

Source

pub fn set_auto_tuned_vpus_per_gb(self, value: Option<i64>) -> Self

Set auto_tuned_vpus_per_gb

Source

pub fn set_block_volume_replicas( self, value: Option<Vec<BlockVolumeReplicaInfo>>, ) -> Self

Set block_volume_replicas

Source

pub fn set_autotune_policies(self, value: Option<Vec<AutotunePolicy>>) -> Self

Set autotune_policies

Source

pub fn set_is_reservations_enabled(self, value: Option<bool>) -> Self

Set is_reservations_enabled

Source

pub fn with_defined_tags( self, value: HashMap<String, HashMap<String, Value>>, ) -> Self

Set defined_tags (unwraps Option)

Source

pub fn with_freeform_tags(self, value: HashMap<String, String>) -> Self

Set freeform_tags (unwraps Option)

Source

pub fn with_system_tags( self, value: HashMap<String, HashMap<String, Value>>, ) -> Self

Set system_tags (unwraps Option)

Source

pub fn with_is_hydrated(self, value: bool) -> Self

Set is_hydrated (unwraps Option)

Source

pub fn with_kms_key_id(self, value: impl Into<String>) -> Self

Set kms_key_id (unwraps Option)

Source

pub fn with_vpus_per_gb(self, value: i64) -> Self

Set vpus_per_gb (unwraps Option)

Source

pub fn with_cluster_placement_group_id(self, value: impl Into<String>) -> Self

Set cluster_placement_group_id (unwraps Option)

Source

pub fn with_size_in_gbs(self, value: i64) -> Self

Set size_in_gbs (unwraps Option)

Source

pub fn with_source_details( self, value: VolumeSourceFromBlockVolumeReplicaDetails, ) -> Self

Set source_details (unwraps Option)

Source

pub fn with_volume_group_id(self, value: impl Into<String>) -> Self

Set volume_group_id (unwraps Option)

Source

pub fn with_is_auto_tune_enabled(self, value: bool) -> Self

Set is_auto_tune_enabled (unwraps Option)

Source

pub fn with_auto_tuned_vpus_per_gb(self, value: i64) -> Self

Set auto_tuned_vpus_per_gb (unwraps Option)

Source

pub fn with_block_volume_replicas( self, value: Vec<BlockVolumeReplicaInfo>, ) -> Self

Set block_volume_replicas (unwraps Option)

Source

pub fn with_autotune_policies(self, value: Vec<AutotunePolicy>) -> Self

Set autotune_policies (unwraps Option)

Source

pub fn with_is_reservations_enabled(self, value: bool) -> Self

Set is_reservations_enabled (unwraps Option)

Trait Implementations§

Source§

impl Clone for Volume

Source§

fn clone(&self) -> Volume

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 Volume

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for Volume

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Serialize for Volume

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. 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<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

Source§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

Source§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

Source§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

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> Same for T

Source§

type Output = T

Should always be Self
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
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,