vcenter datacenter: list
Request:
HTTP request
?filter.names.1=string
&filter.names.2=string
&filter.datacenters.1=obj-103
&filter.datacenters.2=obj-103
&filter.folders.1=obj-103
&filter.folders.2=obj-103
Request Query Parameters:
Name | Type | Description |
---|---|---|
bold = required | ||
filter | filter_spec | Optional. Specification of matching datacenters for which information should be returned. |
filter.datacenters | string[] | Identifiers of datacenters that can match the filter. Optional. If unset or empty, datacenters with any identifier match the filter.When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: |
filter.names | string[] | Names that datacenters must have to match the filter (see vcenter.datacenter.info.name). Optional. If unset or empty, datacenters with any name match the filter. |
filter.folders | string[] | Folders that must contain the datacenters for the datacenter to match the filter. Optional. If unset or empty, datacenters in any folder match the filter.When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: |
Response:
HTTP Status Code: 200
Representations:
Response Type:
Name | Type | Description |
---|---|---|
bold = required | ||
value | summary[] | Commonly used information about the datacenters matching the vcenter.datacenter.filter_spec. |
value[].datacenter | string | Identifier of the datacenter. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: |
value[].name | string | Name of the datacenter.
|
Errors:
HTTP Status Code | Type | Description |
---|---|---|
400 | unable_to_allocate_resource | if more than 1000 datacenters match the vcenter.datacenter.filter_spec. |
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. |