[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Get Virtual Center

Description

Retrieve the representation of a vCenter server registered and managed by vCD.

Request

Request

URL

URL


get
https://{api_host}/cloudapi/1.0.0/virtualCenters/{vcUrn}
Copy

Path Parameters

Path Parameters

string
vcUrn Required

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns VCenterServer of type(s) application/json;version=37.2
{
    "buildNumber": "12345",
    "description": "vCenter Sample Description",
    "name": "vCenter Sample Name",
    "url": "https://sampleVc.vmware.com",
    "vcId": "urn:vcloud:vimserver:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "vcVersion": "6.7.0"
}
string
name Required

The name of the vCenter server.


string
username Required

User name to connect to the server.


string as uri
url Required

URL of the server.


string
buildNumber Optional

The build number of the VIM server.


boolean
isConnected Optional

True if the vCenter server is connected.


boolean
isEnabled Optional

True if the vCenter server is enabled for use with vCloud Director.


string
listenerState Optional

The vcenter listener state. One of

  • INITIAL
  • INVALID_SETTINGS
  • UNSUPPORTED
  • DISCONNECTED
  • CONNECTING
  • CONNECTED_SYNCING
  • CONNECTED
  • STOP_REQ
  • STOP_AND_PURGE_REQ
  • STOP_ACK


string
mode Optional

The vcenter mode. One of

  • NONE - undetermined
  • IAAS - provider scoped
  • SDDC - tenant scoped
  • MIXED
IAAS indicates this vCenter server is scoped to the provider. SDDC indicates that this vCenter server is scoped to tenants, while MIXED indicates mixed mode, where both uses are allowed in this vCenter server.

Possible values are: NONEIAASSDDCMIXED


boolean
hasProxy Optional

When present, indicates that a proxy exists within vCloud Director that proxies this vCenter server for access by authorized end-users. Setting this field to true when registering a vCenter server will result in a proxy being created for the vCenter server, and another for the corresponding SSO endpoint (if different from the vCenter server’s endpoint). This field is immutable after the vCenter Server is registered, and will be updated by the system when/if the proxy is removed.


nsxVManager Optional

the NSX-V attached to this Virtual Center server, when present.


string
password Optional

Cleartext password to connect to the server.


string
proxyConfigurationUrn Changed Optional

string
rootFolder Optional

vCenter root folder in which the vCloud Director system folder will be created. This parameter only takes the folder name and not directory structure.


string
tenantVisibleName Optional

Public label of this vCenter server visible to all tenants.


string
description Optional

Optional description.


string
clusterHealthStatus Optional

The overall health status of clusters in this vCenter server. One of

  • GRAY
  • RED
  • YELLOW
  • GREEN

Possible values are: GRAYREDYELLOWGREEN


string
uuid Optional

The instance UUID property of the vCenter server.


string
vcId Optional

URN of the associated vCenter server.


string
vcNoneNetwork Optional

Network in Vcenter to be used as ‘NONE’ network by vCD.


string
vcVersion Optional

The version of the VIM server.


string as uri
vsphereWebClientServerUrl Optional

The URL of vCenter web client server.

Errors

Errors

Error
400

Invalid configuration.


Error
404

The specified resource was not found

Code Samples

Code Samples

cURL Command

curl https://{api_host}/cloudapi/1.0.0/virtualCenters/{vcUrn}


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Feedback

Was this page helpful?