Struct Datastore

Source

pub struct Datastore { /* private fields */ }

Expand description

Represents a storage location for virtual machine files.

A storage location can be a VMFS volume, a directory on Network Attached Storage, or a local file system path.

A datastore is platform-independent and host-independent. Therefore, datastores do not change when the virtual machines they contain are moved between hosts. The scope of a datastore is a datacenter; the datastore is uniquely named within the datacenter.

Any reference to a virtual machine or file accessed by any host within the datacenter must use a datastore path. A datastore path has the form “[<datastore>] <path>”, where <datastore> is the datastore name, and <path> is a slash-delimited path from the root of the datastore. An example datastore path is “[storage] path/to/config.vmx”.

You may use the following characters in a path, but not in a datastore name: slash (/), backslash (\), and percent (%).

All references to files in the VIM API are implicitly done using datastore paths.

When a client creates a virtual machine, it may specify the name of the datastore, omitting the path; the system, meaning VirtualCenter or the host, automatically assigns filenames and creates directories on the given datastore. For example, specifying My_Datastore as a location for a virtual machine called MyVm results in a datastore location of My_Datastore\MyVm\MyVm.vmx.

Datastores are configured per host. As part of host configuration, a HostSystem can be configured to mount a set of network drives. Multiple hosts may be configured to point to the same storage location. There exists only one Datastore object per Datacenter, for each such shared location. Each Datastore object keeps a reference to the set of hosts that have mounted the datastore. A Datastore object can be removed only if no hosts currently have the datastore mounted.

Thus, managing datastores is done both at the host level and the datacenter level. Each host is configured explicitly with the set of datastores it can access. At the datacenter, a view of the datastores across the datacenter is shown.

Datastore

Struct Datastore Copy item path

Implementations§

impl Datastore

pub fn new(client: Arc<dyn VimClient>, mo_id: &str) -> Self

pub async fn destroy_task(&self) -> Result<ManagedObjectReference>

§Returns:

§Errors:

pub async fn destroy_datastore(&self) -> Result<()>

§Errors:

pub async fn datastore_enter_maintenance_mode( &self, ) -> Result<StoragePlacementResult>

§Errors:

pub async fn datastore_exit_maintenance_mode_task( &self, ) -> Result<ManagedObjectReference>

§Returns:

§Errors:

pub async fn is_clustered_vmdk_enabled(&self) -> Result<bool>

§Returns:

§Errors:

pub async fn refresh_datastore(&self) -> Result<()>

§Errors:

pub async fn refresh_datastore_storage_info(&self) -> Result<()>

pub async fn reload(&self) -> Result<()>

pub async fn rename_task( &self, new_name: &str, ) -> Result<ManagedObjectReference>

§Parameters:

§new_name

§Returns:

§Errors:

pub async fn rename_datastore(&self, new_name: &str) -> Result<()>

§Parameters:

§new_name

§Errors:

pub async fn set_custom_value(&self, key: &str, value: &str) -> Result<()>

§Parameters:

§key

§value

pub async fn update_v_vol_virtual_machine_files_task( &self, failover_pair: Option<&[DatastoreVVolContainerFailoverPair]>, ) -> Result<ManagedObjectReference>

§Parameters:

§failover_pair

§Returns:

§Errors:

pub async fn update_virtual_machine_files_task( &self, mount_path_datastore_mapping: &[DatastoreMountPathDatastorePair], ) -> Result<ManagedObjectReference>

§Parameters:

§mount_path_datastore_mapping

§Returns:

§Errors:

pub async fn alarm_actions_enabled(&self) -> Result<Option<bool>>

pub async fn available_field(&self) -> Result<Option<Vec<CustomFieldDef>>>

pub async fn browser(&self) -> Result<ManagedObjectReference>

§Returns:

pub async fn capability(&self) -> Result<DatastoreCapability>

pub async fn config_issue(&self) -> Result<Option<Vec<Event>>>

pub async fn config_status(&self) -> Result<ManagedEntityStatusEnum>

pub async fn custom_value( &self, ) -> Result<Option<Vec<Box<dyn CustomFieldValueTrait>>>>

pub async fn declared_alarm_state(&self) -> Result<Option<Vec<AlarmState>>>

pub async fn disabled_method(&self) -> Result<Option<Vec<String>>>

pub async fn effective_role(&self) -> Result<Option<Vec<i32>>>

pub async fn host(&self) -> Result<Option<Vec<DatastoreHostMount>>>

pub async fn info(&self) -> Result<Box<dyn DatastoreInfoTrait>>

pub async fn iorm_configuration(&self) -> Result<Option<StorageIormInfo>>

pub async fn name(&self) -> Result<String>

pub async fn overall_status(&self) -> Result<ManagedEntityStatusEnum>

pub async fn parent(&self) -> Result<Option<ManagedObjectReference>>

§Returns:

pub async fn permission(&self) -> Result<Option<Vec<Permission>>>

pub async fn recent_task(&self) -> Result<Option<Vec<ManagedObjectReference>>>

§Returns:

pub async fn summary(&self) -> Result<DatastoreSummary>

pub async fn tag(&self) -> Result<Option<Vec<Tag>>>

pub async fn triggered_alarm_state(&self) -> Result<Option<Vec<AlarmState>>>

pub async fn value(&self) -> Result<Option<Vec<Box<dyn CustomFieldValueTrait>>>>

pub async fn vm(&self) -> Result<Option<Vec<ManagedObjectReference>>>

§Returns:

Trait Implementations§

impl Clone for Datastore

fn clone(&self) -> Datastore

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

Auto Trait Implementations§

impl Freeze for Datastore

impl !RefUnwindSafe for Datastore

impl Send for Datastore

Struct Datastore

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> AsAny for T
where T: 'static,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<To, T> CastInto<To> for T
where To: CastFrom<T> + ?Sized, T: 'static + ?Sized,

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

impl<T, U> Into<U> for T
where U: From<T>,

impl<T> PolicyExt for T
where T: ?Sized,

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

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

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

impl<T, U> TryFrom<U> for T
where U: Into<T>,

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

impl<T> ErasedDestructor for T
where T: 'static,