ListClusters#

Description#

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

Request Syntax#

GET /clusters?maxResults=maxResults&nextToken=nextToken HTTP/1.1

URI Request Parameters#

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

  • maxResults — Максимальное количество кластеров, описание которых возвращает ListClusters в постраничном выводе.

    • Необходимо: Нет

    • Тип: Integer

    • Диапазон значений: Минимум — 1. Максимум — 100.

    • Значение по умолчанию: 100

  • nextToken — Значение nextToken из предыдущего вызова (см. Response Elements).

    • Тип: String

    • Необходимо: Нет

Request Parameters#

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

Response Syntax#

HTTP/1.1 200
Content-type: application/json

{
   "clusters": [ "string" ],
   "nextToken": "string"
}

Response Elements#

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

  • clusters — Список имён всех кластеров Kubernetes.

    • Тип: List of strings

  • nextToken — Токен возвращается только в том случае, когда не удалось вернуть все кластеры, удовлетворяющие критериям. Чтобы продолжить вывод данных, полученное значение нужно передать в параметре nextToken такого же запроса.

    • Тип: String

Examples#

boto3 K2 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="",
)

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

eks_client.list_clusters()
c2-eks K2 Cloud API Client
c2-eks ListClusters
aws-cli
aws eks --endpoint https://eks.k2.cloud/ list-clusters