This API has a deprecated equivalent from v7.0U1.
Get Nodes
DescriptionRetrieve details for a given identifier of the vCenter or Platform Services Controller node. if you do not have all of the privileges described as follows: - Operation execution requires System.Read.
Request
URLURL
https://{api_host}/api/vcenter/topology/nodes/{node}
Path Parameters
Path Parameters
string
node
Required
Identifier of the vCenter or Platform Services Controller node. Identifier can be either IP address or DNS resolvable name of the node.
The parameter must be an identifier for the resource type: com.vmware.vcenter.VCenter.name.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, obtained by first calling Create Session API
Response
Response
Response BodyResponse Body
200 OK returns
TopologyNodesInfo of type application/json
vCenter or Platform Services Controller node details with replication partners and client affinity information as applicable. See Nodes.Info.
{
"client_affinity": "string",
"domain": "string",
"replication_partners": [
"string"
],
"type": "enum"
}
string
domain
Required
Domain name of the node.
type
Required
Appliance type of the node.
Possible values are: VCSA_EMBEDDED , VCSA_EXTERNAL , PSC_EXTERNAL
string
client_affinity
Optional
Identifier of the affinitized Platform Services Controller node. Identifier can be either IP address or DNS resolvable name of the affinitized node. This field is optional and it is only relevant when the value of Nodes.Info.type is VCSA_EXTERNAL. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.vcenter.VCenter.name. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.vcenter.VCenter.name.
array of
string
replication_partners
Optional
List of replication partners’ node identifiers. Identifiers can be either IP address or DNS resolvable name of the partner node. This field is optional and it is only relevant when the value of Nodes.Info.type is one of VCSA_EMBEDDED or PSC_EXTERNAL. When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: com.vmware.vcenter.VCenter.name. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: com.vmware.vcenter.VCenter.name.
cURL Command
curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/vcenter/topology/nodes/{node}
Errors
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn't have the required privileges.
Availability
Added in 7.0U2
On This Page
Nodes Operations
get
get
