Infra Cluster Query

Infra Cluster Query

Api to query Kubernetes Cluster for Telco Cloud Automation

Request
URI
POST
https://{api_host}/hybridity/api//infra/k8s/clusters/query
COPY
Request Body

query cluster

inline_object of type(s) application/json
Optional
{
    "filter": {
        "clusterType": "string",
        "status": "string"
    }
}
filter
Optional

filter

Authentication
This operation uses the following authentication methods.
Responses
200

Query cluster response.

Returns cluster of type(s) application/json
{
    "placementParams": [
        {
            "name": "name",
            "type": "type"
        },
        {
            "name": "name",
            "type": "type"
        }
    ],
    "creationUser": "creationUser",
    "isImported": true,
    "activeTasksCount": 0,
    "_links": "{}",
    "supportedOperatorsVersion": "supportedOperatorsVersion",
    "clusterUrl": "clusterUrl",
    "workerNodes": [
        {
            "cloneMode": "fullClone",
            "memory": 2048,
            "nodes": [
                {
                    "vmName": "vmName",
                    "ip": "ip"
                },
                {
                    "vmName": "vmName",
                    "ip": "ip"
                }
            ],
            "replica": 1,
            "name": "name",
            "cpu": 1,
            "storage": 20,
            "networks": [
                {
                    "nameservers": [
                        "nameservers",
                        "nameservers"
                    ],
                    "networkName": "networkName",
                    "label": "label",
                    "isManagement": true,
                    "mtu": 2
                },
                {
                    "nameservers": [
                        "nameservers",
                        "nameservers"
                    ],
                    "networkName": "networkName",
                    "label": "label",
                    "isManagement": true,
                    "mtu": 2
                }
            ],
            "config": {
                "healthCheck": {
                    "unhealthyConditions": [
                        {
                            "type": "Ready",
                            "timeout": "timeout",
                            "status": true
                        },
                        {
                            "type": "Ready",
                            "timeout": "timeout",
                            "status": true
                        }
                    ],
                    "nodeStartupTimeout": "nodeStartupTimeout"
                },
                "cpuManagerPolicy": {
                    "type": "kubernetes",
                    "properties": {
                        "systemReserved": {
                            "memoryInGiB": 1,
                            "cpu": 1
                        },
                        "kubeReserved": {
                            "memoryInGiB": 1,
                            "cpu": 1
                        }
                    },
                    "policy": "static"
                }
            },
            "labels": [
                "labels",
                "labels"
            ]
        },
        {
            "cloneMode": "fullClone",
            "memory": 2048,
            "nodes": [
                {
                    "vmName": "vmName",
                    "ip": "ip"
                },
                {
                    "vmName": "vmName",
                    "ip": "ip"
                }
            ],
            "replica": 1,
            "name": "name",
            "cpu": 1,
            "storage": 20,
            "networks": [
                {
                    "nameservers": [
                        "nameservers",
                        "nameservers"
                    ],
                    "networkName": "networkName",
                    "label": "label",
                    "isManagement": true,
                    "mtu": 2
                },
                {
                    "nameservers": [
                        "nameservers",
                        "nameservers"
                    ],
                    "networkName": "networkName",
                    "label": "label",
                    "isManagement": true,
                    "mtu": 2
                }
            ],
            "config": {
                "healthCheck": {
                    "unhealthyConditions": [
                        {
                            "type": "Ready",
                            "timeout": "timeout",
                            "status": true
                        },
                        {
                            "type": "Ready",
                            "timeout": "timeout",
                            "status": true
                        }
                    ],
                    "nodeStartupTimeout": "nodeStartupTimeout"
                },
                "cpuManagerPolicy": {
                    "type": "kubernetes",
                    "properties": {
                        "systemReserved": {
                            "memoryInGiB": 1,
                            "cpu": 1
                        },
                        "kubeReserved": {
                            "memoryInGiB": 1,
                            "cpu": 1
                        }
                    },
                    "policy": "static"
                }
            },
            "labels": [
                "labels",
                "labels"
            ]
        }
    ],
    "endpointIP": "endpointIP",
    "managementClusterId": "managementClusterId",
    "clusterId": "clusterId",
    "error": "error",
    "hasSupportedKubernetesVersion": true,
    "lastUpdated": "lastUpdated",
    "clusterName": "clusterName",
    "clusterTemplate": {
        "name": "name",
        "id": "id",
        "version": "version"
    },
    "id": "id",
    "clusterType": "clusterType",
    "hcxUUID": "hcxUUID",
    "proxyConfig": {
        "http_proxy": "http_proxy",
        "no_proxy": "no_proxy",
        "https_proxy": "https_proxy",
        "caCert": "caCert",
        "type": "extension",
        "extensionId": "extensionId"
    },
    "airgapConfig": {
        "caCert": "caCert",
        "fqdn": "fqdn",
        "ip": "ip",
        "type": "extension",
        "extensionId": "extensionId"
    },
    "vimId": "vimId",
    "clusterPassword": "clusterPassword",
    "warnings": [
        {
            "errorCode": "errorCode",
            "operationType": "operationType",
            "message": "message",
            "internalMessage": "internalMessage"
        },
        {
            "errorCode": "errorCode",
            "operationType": "operationType",
            "message": "message",
            "internalMessage": "internalMessage"
        }
    ],
    "kubeConfig": "kubeConfig",
    "creationDate": "creationDate",
    "vsphereClusterName": "vsphereClusterName",
    "clusterConfig": {
        "csiEditable": true,
        "systemSettings": [
            {
                "name": "syslog",
                "properties": {
                    "protocol": "udp",
                    "port": 0,
                    "host": "host"
                }
            },
            {
                "name": "syslog",
                "properties": {
                    "protocol": "udp",
                    "port": 0,
                    "host": "host"
                }
            }
        ],
        "csi": [
            {
                "name": "vsphere-csi",
                "properties": {
                    "isDefault": true,
                    "mountPath": "mountPath",
                    "datastoreUrl": "datastoreUrl",
                    "zone": "zone",
                    "name": "name",
                    "serverIP": "serverIP",
                    "region": "region",
                    "timeout": "timeout"
                }
            },
            {
                "name": "vsphere-csi",
                "properties": {
                    "isDefault": true,
                    "mountPath": "mountPath",
                    "datastoreUrl": "datastoreUrl",
                    "zone": "zone",
                    "name": "name",
                    "serverIP": "serverIP",
                    "region": "region",
                    "timeout": "timeout"
                }
            }
        ],
        "cniEditable": true,
        "tools": [
            {
                "name": "helm",
                "version": "version",
                "properties": "{}"
            },
            {
                "name": "helm",
                "version": "version",
                "properties": "{}"
            }
        ],
        "cni": [
            {
                "name": "calico",
                "properties": "{}"
            },
            {
                "name": "calico",
                "properties": "{}"
            }
        ],
        "kubernetesVersion": "kubernetesVersion"
    },
    "masterNodes": [
        {
            "cloneMode": "fullClone",
            "memory": 2048,
            "nodes": [
                {
                    "vmName": "vmName",
                    "ip": "ip"
                },
                {
                    "vmName": "vmName",
                    "ip": "ip"
                }
            ],
            "replica": 1,
            "name": "name",
            "cpu": 1,
            "storage": 20,
            "networks": [
                {
                    "nameservers": [
                        "nameservers",
                        "nameservers"
                    ],
                    "networkName": "networkName",
                    "label": "label",
                    "isManagement": true,
                    "mtu": 5
                },
                {
                    "nameservers": [
                        "nameservers",
                        "nameservers"
                    ],
                    "networkName": "networkName",
                    "label": "label",
                    "isManagement": true,
                    "mtu": 5
                }
            ],
            "labels": [
                "labels",
                "labels"
            ]
        }
    ],
    "errors": [
        {
            "errorCode": "errorCode",
            "operationType": "operationType",
            "message": "message",
            "internalMessage": "internalMessage"
        },
        {
            "errorCode": "errorCode",
            "operationType": "operationType",
            "message": "message",
            "internalMessage": "internalMessage"
        }
    ],
    "status": "status"
}
string
id
Optional

id

string
clusterName
Optional

clusterName

boolean
isImported
Optional

Flag to indicate if this cluster is imported. Clusters created outside TCA and imported to TCA will have this flag set to True.

string
clusterType
Optional

Type of cluster. Can be Workload/Management.

string
vsphereClusterName
Optional

Name of the vsphere cluster on which the k8s cluster is deployed.

string
managementClusterId
Optional

Id of the management cluster, only relevant for workload clusters.

string
hcxUUID
Optional

Endpoint id of the tca cp on which the cluster is deployed.

string
status
Optional

Current status of the cluster.

integer
activeTasksCount
Optional

Number of operations in processing or queued state on the cluster

clusterTemplate
Optional

clusterTemplate

clusterConfig
Optional

clusterConfig

airgapConfig
Optional

airgapConfig

proxyConfig
Optional

proxyConfig

string
clusterId
Optional

clusterId

string
clusterUrl
Optional

clusterUrl

string
kubeConfig
Optional

kubeConfig

string
endpointIP
Optional

API server load balancer IP. This address is used by Kube-vip pod that runs in the control plane nodes and provides load balancing services for the cluster API server. Make sure that this Ip Address is not in the DHCP range,but its in the same subnet as the DHCP range of master node's management network.

masterNodes
Optional

Pool of nodes on which Kubernetes control plane can run.

workerNodes
Optional

Pool of worker nodes on which Network Functions can run. Each Node Pool can be deployed on a vSphere Resource Pool. All the worker nodes in a node pool contain same Kubelet and Operating System Configuration. It is recommended that a Node Pool should be used by only one Network Function Instance, if it has Infrastructure requirements.

string
vimId
Optional

vimId

string
error
Optional

Any error associated with the cluster. For eg. "Kubernetes version not supported".

boolean
hasSupportedKubernetesVersion
Optional

Flag to indicate if the cluster is on one of the supported kubernetes versions.

string
supportedOperatorsVersion
Optional

The supported version for the operators like vmconfig operator and nodeconfig operator.

string
clusterPassword
Optional

This password is used to login to the master nodes and worker nodes. The username is "capv".

object
_links
Optional

_links

string
creationUser
Optional

creationUser

string
lastUpdated
Optional

lastUpdated

string
creationDate
Optional

creationDate

placementParams
Optional

placementParams

warnings
Optional

warnings

errors
Optional

Errors are for internal use and subject to change. Please use task for monitoring progress of operation.


400

Bad Request

Returns errorResponse of type(s) application/json
{
    "errors": [
        {
            "code": "code",
            "message": "message"
        }
    ]
}
array of error
errors
Optional

errors


500

Internal Server Error

Returns errorResponse of type(s) application/json
{
    "errors": [
        {
            "code": "code",
            "message": "message"
        }
    ]
}
array of error
errors
Optional

errors