vcenter datacenter: get
Retrieves information about the datacenter corresponding to
datacenter.
Request:
HTTP request
GET https://{server}/rest/vcenter/datacenter/{datacenter}
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| datacenter | string | Identifier of the datacenter. |
Response:
HTTP Status Code: 200
Representations:
{
"value": {
"datastore_folder": "obj-103",
"host_folder": "obj-103",
"name": "string",
"network_folder": "obj-103",
"vm_folder": "obj-103"
}
}
"value": {
"datastore_folder": "obj-103",
"host_folder": "obj-103",
"name": "string",
"network_folder": "obj-103",
"vm_folder": "obj-103"
}
}
<?xml version="1.0" ?>
<ns0:Get-Result xmlns:ns0="http://vmware.com/vcenter/datacenter" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>
<host_folder>obj-103</host_folder>
<network_folder>obj-103</network_folder>
<name>string</name>
<vm_folder>obj-103</vm_folder>
<datastore_folder>obj-103</datastore_folder>
</value>
</ns0:Get-Result>
<ns0:Get-Result xmlns:ns0="http://vmware.com/vcenter/datacenter" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>
<host_folder>obj-103</host_folder>
<network_folder>obj-103</network_folder>
<name>string</name>
<vm_folder>obj-103</vm_folder>
<datastore_folder>obj-103</datastore_folder>
</value>
</ns0:Get-Result>
Response Type:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| value | info | The vcenter.datacenter.info instances that corresponds to the datacenter. |
| value.name | string | The name of the datacenter. |
| value.datastore_folder | string | The root datastore folder associated with the datacenter. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Folder. When operations return a value of this structure as a result, the field will be an identifier for the resource type: Folder. |
| value.host_folder | string | The root host and cluster folder associated with the datacenter. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Folder. When operations return a value of this structure as a result, the field will be an identifier for the resource type: Folder. |
| value.network_folder | string | The root network folder associated with the datacenter. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Folder. When operations return a value of this structure as a result, the field will be an identifier for the resource type: Folder. |
| value.vm_folder | string | The root virtual machine folder associated with the datacenter. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Folder. When operations return a value of this structure as a result, the field will be an identifier for the resource type: Folder. |
Errors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 500 | error | if the system reports an error while responding to the request. |
| 404 | not_found | if there is no datacenter associated with datacenter in the system. |
| 503 | service_unavailable | if the system is unable to communicate with a service to complete the request. |
| 401 | unauthenticated | if the user can not be authenticated. |
| 403 | unauthorized | if the user doesn't have the required privileges. |