Managed Object - Datastore
2009-12-09 12:11
337 查看
[align=center]Managed Object - Datastore[/align]
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
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.
Properties
*May not be present
Methods
Required Privileges
Datastore.Delete
Parameters
Return Value
Faults
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>
Required Privileges
Datastore.Rename
Parameters
Return Value
Faults
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.
Properties
Name | Type | Description |
---|---|---|
browser | ManagedObjectReference to a HostDatastoreBrowser | DatastoreBrowser used to browse this datastore. |
capability | DatastoreCapability | Capabilities of this datastore. |
host* | 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. |
Type | Description |
---|---|
None |
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. |
<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. |
Type | Description |
---|---|
None |
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. |
相关文章推荐
- Google Appengine开发碰到DatastoreNeedIndexException了
- 探索Google App Engine背后的奥秘(5)- Datastore的设计
- Jackrabbit之DataStore
- Dropbox创造共享新思维——Datastore API
- Vijava 学习笔记之 DataStore(基础配置信息)
- 在下拉列表框里显示datastore里的服务内容
- 在Linux环境下设置ArcGIS的 Server,Portal和DataStore服务开机自启
- 说说Java for Google App Engine(1) – 关于 DataStore 的设计
- 探索Google App Engine背后的奥秘(5)- Datastore的设计
- PowerBuilder:用DataStore导出Excel
- Dropbox创造共享新思维——Datastore API
- Oracle Data Integrator 12c-模型(Model)和 数据存储(DataStore)
- Google Appengine开发碰到DatastoreNeedIndexException了
- ArcGIS Enterprise 10.5.1 静默安装部署记录(Centos 7.2 minimal)- 5、安装Datastore
- oracle全文索引之datastore_1_DIRECT_DATASTORE
- 探索Google App Engine背后的奥秘(5)- Datastore的设计(转载)
- 在PowerBuilder中利用DataStore实现查询条件的记忆
- Dropbox Datastore, the iCloud Killer? (updated)
- PB中的DataStore是个好东西
- Oracle Data Integrator 12c-模型(Model)和 数据存储(DataStore)