You can use the vCloud Director API for NSX to query all edges, query a specific edge, or upgrade an edge.

API-URL is a URL of the form https://vcloud.example.com/network.

id is a vCloud Director unique identifier in the form of a UUID, as defined by RFC 4122.

# is a small integer used in an NSX object identifier.

Summary of NSX Edge Gateway Query and Upgrade Requests

Operation

Request

Request Body

Response

List all edges in the system.

GET API-URL/edges

None

pagedEdgeList

List the edge with identifier id.

GET API-URL/edges/id

None

edge

Get the status of the edge with identifier id.

GET API-URL/edges/id /status

None

edgeStatus

Get the summary of the edge with identifier id.

GET API-URL/edges/id /summary

None

edgeSummary

Get the list of all jobs for the edge with identifier id.

GET API-URL/edges/id/jobs

None

edgeJobs

Get the list of active jobs for the edge with identifier id.

GET API-URL/edges/id/jobs?status=active

None

edgeJobs

Upgrade the edge with identifier id.

POST API-URL/edges/id /?action=upgrade

None

204 No Content

List the edges contained by vCloud Director organization VDC with id id.

GET API-URL/edges/?orgVdc=id

None

edgeSummaries

Configure the edge with identifier id to use NSX FIPS mode. Requires NSX 6.3 or later.

Note

This option is available only if the system administrator has allowed enablement of FIPS mode on Edge Gateways. For more information about FIPS mode, see FIPS Mode in the VMware NSX for vSphere documentation.

POST API-URL/edges/id /fips?enable=[true | false]

None

204 No Content