Managed Object - Datastore
Managed Object - Datastore
- Property of
- ComputeResource, Datacenter, DatastoreEventArgument, DatastoreSummary, HostDatastoreBrowser, HostDatastoreBrowserSearchResults, HostDatastoreSystem, HostSystem, InvalidDatastore, UnsupportedDatastore, VirtualDeviceFileBackingInfo, VirtualMachine, VirtualMachineRelocateSpec, VirtualMachineRelocateSpecDiskLocator
- Parameter to
- ExtendVmfsDatastore, QueryAvailableDisksForVmfs, QueryVmfsDatastoreExtendOptions, RemoveDatastore
- Returned by
- CreateLocalDatastore, CreateNasDatastore, CreateVmfsDatastore, ExtendVmfsDatastore
- See also
- DatastoreCapability, DatastoreHostMount, DatastoreInfo, DatastoreSummary, HostDatastoreBrowser, VirtualMachine
Managed Object 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".
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.
*
May not be present
Show WSDL type definition
Show WSDL type definition
Show WSDL type definition
Properties
| Name | Type | Description |
|---|---|---|
| browser | ManagedObjectReference to a HostDatastoreBrowser |
DatastoreBrowser used to browse this datastore. |
| capability | DatastoreCapability | Capabilities of this datastore. |
| host* | DatastoreHostMount[] | Hosts attached to this datastore. |
| info | DatastoreInfo | Specific information about the datastore. |
| summary | DatastoreSummary | Global properties of the datastore. |
| vm* | ManagedObjectReference[] to a VirtualMachine[] |
Virtual machines stored on this datastore. |
Methods
| Methods defined in this Managed Object |
|---|
| DestroyDatastore, RefreshDatastore, RenameDatastore |
DestroyDatastore
Removes a datastore. A datastore can be removed only if it is not currently used by any host or virtual machine.
- Required Privileges
- Datastore.Delete
Parameters
| Name | Type | Description |
|---|---|---|
| _this | ManagedObjectReference | A reference to the Datastore used to make the method call. |
Return Value
| Type | Description |
|---|---|
| None | |
Faults
| Type | Description |
|---|---|
| ResourceInUse | Thrown if one or more hosts or virtual machines are configured to use the datastore. |
| RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error. |
Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" name="DestroyDatastore"> <complexType> <sequence> <element name="_this" type="vim2:ManagedObjectReference"/> </sequence> </complexType> </element> <element xmlns="http://www.w3.org/2001/XMLSchema" name="DestroyDatastoreResponse"> <complexType/> </element>
RefreshDatastore
Explicitly refreshes the freeSpace and capacity values.
- Required Privileges
- System.Read
Parameters
| Name | Type | Description |
|---|---|---|
| _this | ManagedObjectReference | A reference to the Datastore used to make the method call. |
Return Value
| Type | Description |
|---|---|
| None | |
Faults
| Type | Description |
|---|---|
| RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error. |
Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" name="RefreshDatastore"> <complexType> <sequence> <element name="_this" type="vim2:ManagedObjectReference"/> </sequence> </complexType> </element> <element xmlns="http://www.w3.org/2001/XMLSchema" name="RefreshDatastoreResponse"> <complexType/> </element>
RenameDatastore
Renames a datastore.
- Required Privileges
- Datastore.Rename
Parameters
| Name | Type | Description |
|---|---|---|
| _this | ManagedObjectReference | A reference to the Datastore used to make the method call. |
| newName | xsd:string | The new name to assign to the datastore. |
Return Value
| Type | Description |
|---|---|
| None | |
Faults
| Type | Description |
|---|---|
| DuplicateName | Thrown if another datastore in this datacenter already has the same name. |
| InvalidName | Thrown if the name is not a valid datastore name. |
| RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error. |
Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" name="RenameDatastore"> <complexType> <sequence> <element name="_this" type="vim2:ManagedObjectReference"/> <element name="newName" type="xsd:string"/> </sequence> </complexType> </element> <element xmlns="http://www.w3.org/2001/XMLSchema" name="RenameDatastoreResponse"> <complexType/> </element>
 |
 |
 |
0人
|
了这篇文章 |
类别： VMware vSphere┆阅读(
0)┆评论(
0) ┆ 返回博主首页┆ 返回博客首页
上一篇 ESX SERVER 命令控制台添加VMFS 下一篇 Troubleshooting VMware High Availability (HA)
文章评论
发表评论
- 昵 称：
- 登录 快速注册
- 验证码：
-
点击图片可刷新验证码请点击后输入验证码博客过2级，无需填写验证码
- 内 容：
同时赞一个
每日博报 精彩不止一点