Query Virtual Centers

Query Virtual Centers

Retrieves a paged list of all Virtual Center servers in the system.

Request
URI
GET
https://{api_host}/cloudapi/1.0.0/virtualCenters
COPY
Query Parameters
string
filter
Optional

Filter for a query. FIQL format.

string
sortAsc
Optional

Field to use for ascending sort

string
sortDesc
Optional

Field to use for descending sort

integer
page
Required
Constraints: minimum: 1 default: 1

Page to fetch, zero offset.

integer
pageSize
Required
Constraints: minimum: 0 maximum: 128 default: 25

Results per page to fetch.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns VCenterServers of type(s) application/json;version=39.1
This response body class contains all of the following: InlineVCenterServers0 , InlineVCenterServers1 
{
    "resultTotal": 0,
    "pageCount": 0,
    "page": 0,
    "pageSize": 0,
    "associations": [
        {
            "entityId": "string",
            "associationId": "string"
        }
    ],
    "values": [
        {
            "vcId": "urn:vcloud:vimserver:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "name": "vCenter Sample Name",
            "description": "vCenter Sample Description",
            "username": "string",
            "password": "string",
            "url": "https://sampleVc.vmware.com",
            "isEnabled": false,
            "vsphereWebClientServerUrl": "string",
            "hasProxy": false,
            "rootFolder": "string",
            "vcNoneNetwork": "string",
            "vcNoneNetworkMoref": "string",
            "tenantVisibleName": "string",
            "isConnected": false,
            "mode": "string",
            "listenerState": "string",
            "clusterHealthStatus": "string",
            "vcVersion": "6.7.0",
            "buildNumber": "12345",
            "uuid": "string",
            "nsxVManager": {
                "username": "string",
                "password": "string",
                "url": "https://sampleVsm.vmware.com",
                "softwareVersion": "string"
            },
            "proxyConfigurationUrn": "string"
        }
    ]
}

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/cloudapi/1.0.0/virtualCenters?page=value&pageSize=v
Availability
Added in 34.0
On This Page
Virtual Center Operations
GET
Query Virtual Centers
POST
Attach Virtual Center
GET
Get Virtual Center
PUT
Update Virtual Center
DELETE
Delete Virtual Center
GET
Get Virtual Center Metrics
GET
Get Nsx V Manager Settings
PUT
Update Nsx V Manager Settings
GET
Get Root Resource Pools
GET
Get Child Resource Pools
GET
Get All Resource Pools
GET
Get Supported Hardware Versions
GET
Get Resource Pool Kubernetes Config
GET
Query Virtual Machine Classes
GET
Get Storage Profiles
GET
Get Vc Storage Policy Capabilities
GET
Get Unmanaged Virtual Machines
GET
Get Unmanaged Virtual Disks
GET
Retrieve Vsphere Vmca