Managed Object - Datacenter

Property of
DatacenterEventArgument, DatacenterMismatch, DatacenterMismatchArgument
Parameter to
CopyDatastoreFile_Task, CopyDatastoreFile_Task, CopyVirtualDisk_Task, CopyVirtualDisk_Task, CreateVirtualDisk_Task, DefragmentVirtualDisk_Task, DeleteDatastoreFile_Task, DeleteVirtualDisk_Task, ExtendVirtualDisk_Task, FindByDatastorePath, FindByDnsName, FindByIp, FindByUuid, InflateVirtualDisk_Task, MakeDirectory, MoveDatastoreFile_Task, MoveDatastoreFile_Task, MoveVirtualDisk_Task, MoveVirtualDisk_Task, QueryVirtualDiskFragmentation, QueryVirtualDiskGeometry, QueryVirtualDiskUuid, SetVirtualDiskUuid, ShrinkVirtualDisk_Task, ZeroFillVirtualDisk_Task
Returned by
CreateDatacenter
Extends
ManagedEntity
See also
ClusterPowerOnVmResult, Datastore, Folder, HostConnectInfo, Network, VirtualMachine


Managed Object Description

The interface to the common container object for hosts and virtual machines. Every host and virtual machine must be under a distinct datacenter in the inventory, and datacenters may not be nested under other datacenters.

Properties

Name Type Description
datastore*ManagedObjectReference[]
to a Datastore[]

A collection of references to the datastore objects available in this datacenter.
hostFolder PManagedObjectReference
to a Folder

A reference to the folder hierarchy that contains the compute resources, including hosts and clusters, for this datacenter.

This folder is guaranteed to exist.

network*ManagedObjectReference[]
to a Network[]

A collection of references to the network objects available in this datacenter.
vmFolder PManagedObjectReference
to a Folder

A reference to the folder hierarchy that contains the virtual machines and templates for this datacenter.

This folder is guaranteed to exist.

Properties inherited from ManagedEntity
configIssue, configStatus, customValue, declaredAlarmState, disabledMethod, effectiveRole, name, overallStatus, parent, permission, recentTask, triggeredAlarmState
Properties inherited from ExtensibleManagedObject
availableField, value
*May not be presentP Required privilege: System.View

Methods

Methods defined in this Managed Object
PowerOnMultiVM_Task, QueryConnectionInfo
Methods inherited from ManagedEntity
Destroy_Task, Reload, Rename_Task
Methods inherited from ExtensibleManagedObject
setCustomValue

PowerOnMultiVM_Task

Powers on multiple virtual machines in a data center. If the virtual machines are suspended, this method resumes execution from the suspend point. The virtual machines can belong to different clusters in the data center.

If any virtual machine in the list is manually managed by DRS, or DRS has to migrate any manually managed virtual machine or power on any manually managed host in order to power on these virtual machines, a DRS recommendation will be generated, and the users need to manually apply the recommendation for actually powering on these virtual machines. Otherwise, all the virtual machine will be automatically powered on. The virtual machines on stand alone hosts or DRS disabled will be powered-on on the current host. The DRS automatically managed virtual machines will be powered-on on the recommended hosts.

When powering on a virtual machine in a cluster, the system might do an implicit relocation of the virtual machine to another host.

Required Privileges
System.View
Since
VI API 2.5

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the Datacenter used to make the method call.
vm PManagedObjectReference[]
to a VirtualMachine[]

The virtual machines to power on.
P Required privilege: VirtualMachine.Interact.PowerOn

Return Value

Type Description
ManagedObjectReference
to a Task
This method returns a #vim.Task object with which to monitor the operation, and also a #vim.cluster.PowerOnVmResult object.

Faults

Type Description
RuntimeFaultThrown 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



QueryConnectionInfo

This method provides a way of getting basic information about a host without adding it to a datacenter. Connection wizards typically use this method to show information about a host so a user can confirm a set of changes before applying them.
Required Privileges
System.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the Datacenter used to make the method call.
hostnamexsd:string

The target of the query.
portxsd:int

The port number of the target host. For ESX 2.x this is the authd port (902 by default). For ESX 3.x and above and for VMware Server hosts this is the https port (443 by default). You can specify -1 to have the VirtualCenter Server try the default ports.
usernamexsd:string

The name of the user.
passwordxsd:string

The password of the user.
sslThumbprint*xsd:string

The expected SSL thumbprint of the host's certificate

Since VI API 2.5
*Need not be set

Return Value

Type Description
HostConnectInfo

Faults

Type Description
AlreadyConnectedThrown if the host is already being managed by this server.
HostConnectFaultThrown if an error occurred when querying about a host. Typically, a more specific subclass, such as AlreadyBeingManaged, is thrown.
InvalidLoginThrown if unable to authenticate with the host.
NoHostThrown if unable to contact the host.
NotSupportedThrown if called directly on a host.
NotSupportedHostThrown if the software version on the host is not supported.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
SSLVerifyFaultThrown if the host certificate could not be authenticated

Show WSDL type definition