Query Cluster Instance.

curl --request GET \
  --url https://{apiHost}/api/v1/cluster/instances \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{apiHost}/api/v1/cluster/instances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "summaryByState": {
    "description": "<string>",
    "total": 123,
    "values": {}
  },
  "list": [
    {
      "id": "<string>",
      "name": "<string>",
      "title": "<string>",
      "description": "<string>",
      "tags": {},
      "clusterType": "CLUSTER_TYPE_UNSPECIFIED",
      "projectId": "<string>",
      "revision": {
        "curr": "<string>",
        "createdAt": {},
        "createdBy": "<string>",
        "updatedAt": {},
        "updatedBy": "<string>",
        "prev": "<string>"
      },
      "activate": "<string>",
      "clusterPolicyId": "<string>",
      "edgeNodePoolTags": {},
      "serverAppID": "<string>",
      "agentAppID": "<string>",
      "minEdgeDevices": 123,
      "maxEdgeDevices": 123,
      "minServerNodes": 123,
      "maxServerNodes": 123,
      "minAgentNodes": 123,
      "maxAgentNodes": 123,
      "callHomeURL": "<string>",
      "clusterOnboardType": "CLUSTER_ONBOARD_TYPE_UNSPECIFIED",
      "orchestrationProvider": "ORCHESTRATOR_PROVIDER_UNSPECIFIED",
      "orchestratorAuthenticationType": "ORCHESTRATOR_AUTHENTICATION_TYPE_UNSPECIFIED",
      "orchestratorServerAddress": "<string>",
      "orchestratorPort": "<string>",
      "dbEndpoint": "<string>"
    }
  ],
  "next": {
    "pageToken": "<string>",
    "orderBy": [
      "<string>"
    ],
    "pageNum": 123,
    "pageSize": 123,
    "totalPages": 123
  }
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "typeUrl": "<string>",
      "value": "aSDinaTvuI8gbWludGxpZnk="
    }
  ]
}

Authentication · API availability · Download OpenAPI

Authorizations

Authorization

string

header

required

Bearer token for user session

Headers

X-Request-Id

string

User-Agent specified id to track a request

Query Parameters

summary

boolean

summary flag

project

string

User defined name of the project, unique across the enterprise. Once project is created, name can’t be changed

namePattern

string

cluster name pattern

projectNamePattern

string

cluster project name pattern

clusterType

enum<string>

default:CLUSTER_TYPE_UNSPECIFIED

type of cluster

CLUSTER_TYPE_K3S: cluster type is k3s
CLUSTER_TYPE_TKG_ATTACH: cluster type is TKG, with subtype ATTACH

Available options:

CLUSTER_TYPE_UNSPECIFIED,

CLUSTER_TYPE_K3S,

CLUSTER_TYPE_TKG_ATTACH

next.pageToken

string

Page Token

next.orderBy

string[]

OrderBy helps in sorting the list response

next.pageNum

number<int64>

Page Number

next.pageSize

number<int64>

Defines the page size

next.totalPages

number<int64>

Total number of pages to be fetched.

fields

string[]

Fields to select: id, name, title, description, tags, clusterType, projectId, revision, activate, clusterPolicyId, edgeNodePoolTags, serverAppID, agentAppID, minEdgeDevices, maxEdgeDevices, minServerNodes, maxServerNodes, minAgentNodes, maxAgentNodes, callHomeURL, clusterOnboardType, orchestrationProvider, orchestratorAuthenticationType, orchestratorServerAddress, orchestratorPort, dbEndpoint

Response

A successful response.

summaryByState

Summary is used to store the Summary details · object

cluster instance by summary

Show child attributes

list

Cluster Instance config summary · object[]

cluster instance summary list response

Show child attributes

Cursor is used as filter in list operation. · object

cursor next

Show child attributes

⌘I

Query Cluster Instance.

curl --request GET \
  --url https://{apiHost}/api/v1/cluster/instances \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{apiHost}/api/v1/cluster/instances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "summaryByState": {
    "description": "<string>",
    "total": 123,
    "values": {}
  },
  "list": [
    {
      "id": "<string>",
      "name": "<string>",
      "title": "<string>",
      "description": "<string>",
      "tags": {},
      "clusterType": "CLUSTER_TYPE_UNSPECIFIED",
      "projectId": "<string>",
      "revision": {
        "curr": "<string>",
        "createdAt": {},
        "createdBy": "<string>",
        "updatedAt": {},
        "updatedBy": "<string>",
        "prev": "<string>"
      },
      "activate": "<string>",
      "clusterPolicyId": "<string>",
      "edgeNodePoolTags": {},
      "serverAppID": "<string>",
      "agentAppID": "<string>",
      "minEdgeDevices": 123,
      "maxEdgeDevices": 123,
      "minServerNodes": 123,
      "maxServerNodes": 123,
      "minAgentNodes": 123,
      "maxAgentNodes": 123,
      "callHomeURL": "<string>",
      "clusterOnboardType": "CLUSTER_ONBOARD_TYPE_UNSPECIFIED",
      "orchestrationProvider": "ORCHESTRATOR_PROVIDER_UNSPECIFIED",
      "orchestratorAuthenticationType": "ORCHESTRATOR_AUTHENTICATION_TYPE_UNSPECIFIED",
      "orchestratorServerAddress": "<string>",
      "orchestratorPort": "<string>",
      "dbEndpoint": "<string>"
    }
  ],
  "next": {
    "pageToken": "<string>",
    "orderBy": [
      "<string>"
    ],
    "pageNum": 123,
    "pageSize": 123,
    "totalPages": 123
  }
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "operationType": "OPS_TYPE_UNSPECIFIED",
  "operationStatus": "OPS_STATUS_UNSPECIFIED",
  "objectKind": "<string>",
  "objectId": "<string>",
  "objectName": "<string>",
  "objectRevision": "<string>",
  "objectType": "OBJECT_TYPE_UNSPECIFIED",
  "operationTime": "<string>",
  "startTime": "<string>",
  "endTime": "<string>",
  "user": "<string>",
  "httpStatusCode": 123,
  "httpStatusMsg": "<string>",
  "jobId": "<string>",
  "error": [
    {
      "ec": "zMsgErrorNone",
      "location": "<string>",
      "details": "<string>"
    }
  ]
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "typeUrl": "<string>",
      "value": "aSDinaTvuI8gbWludGxpZnk="
    }
  ]
}

API guides

API services

Query Cluster Instance.

Authorizations

Headers

Query Parameters

Response