Get Edge Clusters

Get Edge Clusters

Retrieves all Edge Clusters. Results can be filtered by id, name, vCenter (resourcePool.vcId), externalNetworkId and orgVdcId.

  • externalNetworkId - | The URN of external Network. Filters all edgeClusters that are accessible to externalNetworkId. externalNetworkId filter is supported from version 35.2 Example: (externalNetworkId==urn:vcloud:network:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
  • orgVdcId - | The URN of Org vDC. Filters all edgeClusters that are available to an Org vDC. orgVdcId filter is supported from version 36.0 Example: (orgVdcId==urn:vcloud:vdc:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
  • vdcGroupId - | The URN of vDC Group. Filters all edgeClusters that are available to a vDC Group. vdcGroupId filter is supported from version 39.0 Example: (vdcGroupId==urn:vcloud:vdcGroup:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
  • isProjectedToOrg - | The URN of the organization. Filters all edge clusters that are projected to a given Organization. Filtering for only non-projected edge clusters is also supported. isProjectedToOrg is supported from version 39.0 Example: (isProjectedToOrg==urn:vcloud:organizaton:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
Error will be thrown if both externalNetworkId and orgVdcId filters are supplied.
Request
URI
GET
https://{api_host}/cloudapi/1.0.0/edgeClusters
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 EdgeClusters of type(s) application/json;version=39.1
This response body class contains all of the following: InlineEdgeClusters0 , InlineEdgeClusters1 
{
    "resultTotal": 0,
    "pageCount": 0,
    "page": 0,
    "pageSize": 0,
    "associations": [
        {
            "entityId": "string",
            "associationId": "string"
        }
    ],
    "values": [
        {
            "status": "string",
            "id": "string",
            "name": "string",
            "description": "string",
            "resourcePool": {
                "moref": "string",
                "clusterMoref": "string",
                "name": "string",
                "vcId": "string",
                "eligible": false,
                "kubernetesEnabled": false,
                "vgpuEnabled": false
            },
            "storageProfileName": "string",
            "nsxTManagerRef": {
                "name": "string",
                "id": "string"
            },
            "backingRef": {
                "id": "string",
                "name": "string"
            },
            "networkProviderScope": "string",
            "statefulFirewallEnabled": false
        }
    ]
}

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/cloudapi/1.0.0/edgeClusters?page=value&pageSize=v
Availability
Added in 32.0
On This Page
Edge Clusters Operations
GET
Get Edge Clusters
POST
Create Edge Cluster
GET
Get Edge Cluster Projections
POST
Create Edge Cluster Projection
GET
Get Edge Cluster Projection
PUT
Update Edge Cluster Projection
DELETE
Delete Edge Cluster Projection