DescribeCluster#

Description#

Запрос на получение параметров кластера.

Request Syntax#

 GET /clusters/name HTTP/1.1

URI Request Parameters#

В запросе используются следующие параметры URI.

  • name — Имя кластера, о котором необходимо получить информацию.

    • Тип: String

    • Необходимо: Да

Request Parameters#

Тело запроса отсутствует.

Response Syntax#

HTTP/1.1 200
Content-type: application/json

{
   "cluster": {
      "name": "string",
      "createdAt": number,
      "version": "string",
      "status": "string",
      "resourcesVpcConfig": {
         "securityGroupIds": [ "string" ],
         "subnetIds": [ "string" ],
         "vpcId": "string"
      },
      "certificateAuthority": {
         "data": "string",
      },
      "remoteAccessConfig": {
         "ec2SshKey": "string",
      },
      "kubernetesNetworkConfig": {
         "ipFamily": "string",
         "serviceIpv4Cidr": "string",
         "podIpv4Cidr": "string",
      },
      "health": {
         "issues": [
            {
               "code": "string",
               "message": "string",
               "resourceIds": [ "string" ]
            }
         ]
      },
      "platformVersion": "string",
      "legacyClusterParams": {
           "masterConfig": {
                 "highAvailability": boolean,
                 "mastersInstanceType": "string",
                 "mastersVolumeType": "string",
                 "mastersVolumeSize": number,
                 "mastersVolumeIops": number,
                 "masterPublicIp": "string",
           },
           "ingressConfig": {
                 "ingressRequired": boolean,
                 "ingressPublicIp": "string",
                 "ingressInstanceType": "string",
                 "ingressVolumeType": "string",
                 "ingressVolumeSize": number,
                 "ingressVolumeIops": number,
           },
           "dockerRegistryConfig": {
                 "dockerRegistryRequired": boolean,
                 "dockerRegistryVolumeType": "string",
                 "dockerRegistryVolumeSize": number,
                 "dockerRegistryVolumeIops": number,
           },
           "ebsProviderConfig": {
                 "ebsProviderRequired": boolean,
                 "ebsUser": "string",
           },
           "userDataConfig": {
                 "userData": "string",
                 "userDataContentType": "string",
           }
      },
      "tags": {
         "string" : "string"
      },
   }
}

Response Elements#

В случае успешного выполнения запроса API вернёт HTTP-ответ с кодом 200. В ответе содержатся следующие данные в формате JSON.

  • cluster — Детальное описание кластера.

Examples#

boto3 CROC Cloud boto3 Client
import boto3

session = boto3.Session(
   aws_access_key_id="<AWS_ACCESS_KEY_ID>",
   aws_secret_access_key="<AWS_SECRET_ACCESS_KEY>",
   region_name="croc",
)

eks_client = session.client(
   'eks',
   endpoint_url='https://eks.cloud.croc.ru/',
)

eks_client.describe_cluster(name="production")
c2-eks CROC Cloud API Client
c2-eks DescribeCluster name production
aws-cli
aws eks --endpoint https://eks.cloud.croc.ru/ describe-cluster --name production