Datacenter APIs
The Datacenter managed object provides the interface to the common container object for hosts, virtual machines, networks, and datastores.
These entities must be under a distinct datacenter in the inventory, and datacenters may not be nested under other datacenters.
Every Datacenter has the following set of dedicated folders. These folders are empty until you create entities for the Datacenter.
- A folder for VirtualMachine, template, and VirtualApp objects.
- A folder for a ComputeResource hierarchy.
- A folder for Network, DistributedVirtualSwitch, and DistributedVirtualPortgroup objects.
- A folder for Datastore objects.
For a visual representation of the organization of objects in a vCenter hierarchy, see the description of the ServiceInstance object.
Operations
POST
Datacenter Batch Query Connect Info
This interface returns a list of information about the specified hosts without adding them to the vCenter inventory.
POST
Datacenter Destroy Task
Destroys this object, deleting its contents and removing it from its parent folder (if any).
GET
Datacenter Get Alarm Actions Enabled
Whether alarm actions are enabled for this entity.
GET
Datacenter Get Available Field
List of custom field definitions that are valid for the object's type.
GET
Datacenter Get Config Issue
Current configuration issues that have been detected for this entity.
GET
Datacenter Get Config Status
The configStatus indicates whether or not the system has detected a configuration issue involving this entity.
GET
Datacenter Get Configuration
Configuration of the datacenter.
GET
Datacenter Get Custom Value
Custom field values.
GET
Datacenter Get Datastore
A collection of references to the datastore objects available in this datacenter.
GET
Datacenter Get Datastore Folder
A reference to the folder hierarchy that contains the datastores for this datacenter.
GET
Datacenter Get Declared Alarm State
A set of alarm states for alarms that apply to this managed entity.
GET
Datacenter Get Disabled Method
List of operations that are disabled, given the current runtime state of the entity.
GET
Datacenter Get Effective Role
Access rights the current session has to this entity.
GET
Datacenter Get Host Folder
A reference to the folder hierarchy that contains the compute resources, including hosts and clusters, for this datacenter.
GET
Datacenter Get Name
Name of this entity, unique relative to its parent.
GET
Datacenter Get Network
A collection of references to the network objects available in this datacenter.
GET
Datacenter Get Network Folder
A reference to the folder hierarchy that contains the network entities for this datacenter.
GET
Datacenter Get Overall Status
General health of this managed entity.
GET
Datacenter Get Parent
Parent of this entity.
GET
Datacenter Get Permission
List of permissions defined for this entity.
GET
Datacenter Get Recent Task
The set of recent tasks operating on this managed entity.
GET
Datacenter Get Tag
The set of tags associated with this managed entity.
GET
Datacenter Get Triggered Alarm State
A set of alarm states for alarms triggered by this entity or by its descendants.
GET
Datacenter Get Value
List of custom field values.
GET
Datacenter Get Vm Folder
A reference to the folder hierarchy that contains *VirtualMachine* virtual machine templates (identified by the *VirtualMachineConfigInfo.template* property, and *VirtualApp* objects for this datacenter.
POST
Datacenter Power On Multi VM Task
Powers on multiple virtual machines in a data center.
POST
Datacenter Query Connection Info
This method provides a way of getting basic information about a host without adding it to a datacenter.
POST
Datacenter Query Connection Info Via Spec
This method provides a way of getting basic information about a host without adding it to a datacenter.
POST
Datacenter Query Datacenter Config Option Descriptor
The list of possible choices for *DatacenterConfigSpec.defaultHardwareVersionKey*.
POST
Datacenter Reconfigure Datacenter Task
Change the datacenter configuration.
POST
Datacenter Reload
Reload the entity state.
POST
Datacenter Rename Task
Renames this managed entity.
POST
Datacenter Set Custom Value
Assigns a value to a custom field.