Управление кластером
Кластер Kubernetes можно создать c помощью API.
Пример запроса:
POST https://10.15.39.68/api/kubernetes/v1/clusters
В теле запроса необходимо указать следующие параметры:
| Параметр | Тип | Описание |
|---|---|---|
clusterName | string | Имя кластера (обязательное поле). Имя должно быть уникальным, может содержать строчные буквы латинского алфавита, цифры и дефисы. Допустимое количество символов от 3 до 20 |
projectId | string | Идентификатор проекта, в котором будет создан кластер. Если значение не указано, кластер будет создан в проекте по умолчанию |
regionId | string | Идентификатор региона, в котором будет создан кластер Kubernetes. Если значение не указано, кластер будет создан в регионе по умолчанию |
Пример запроса на создание кластера:
Request type=json{ "clusterName": "test", "regionId": "PD", "projectId": " a7baf2d9-5924-459d ", "addonsConfig": { "dashboard": { "enabled": true } } }
Ответ будет содержать данные о задаче на создание кластера. Пример ответа:
Response type=json{ "task": { "id": "7baf2d9-5924-459", "command": "CREATE_CLUSTER", "createdAt": "2021-09-23T11:31:19.883Z", "status": "PENDING", "metadata": { "typeUrl": "string", "value": "string" }, "statusChangedAt": "2021-09-23T11:31:19.883Z", "response": { "typeUrl": "string", "value": "string" }, "error": { "code": 0, "message": "string", "details": [ { "typeUrl": "string", "value": "string" } ] } } }
Чтобы получить информацию о кластере, выполните следующий запрос:
GET https://10.15.39.68/api/kubernetes/v1/clusters
Ответ будет содержать следующие параметры:
| Параметр | Тип | Описание |
|---|---|---|
clusters[].clusterId | string | Уникальный идентификатор кластера |
clusters[].clusterName | string | Уникальное имя кластера |
clusters[].projectId | string | Идентификатор проекта, в котором кластер был создан |
clusters[].regionId | string | Идентификатора региона, в котором кластер был создан |
Пример ответа:
Response type=json{ "clusters": [ { "clusterId": "a7baf2d9-5924-459d", "clusterName": "test-cluster", "regionId": "PD", "projectId": "825f-e2d9aac9c60" } ] }
Удалить кластер можно с помощью следующего запроса:
DELETE https://10.15.39.68/api/kubernetes/v1/clusters/{clusterId}
В теле запроса необходимо указать параметр clusterId (string) – идентификатор кластера.
Пример запроса:
Request type=jsonDELETE https://10.15.39.68/api/kubernetes/v1/clusters/{ a7baf2d9-5924-459d} { "clusterid": "a7baf2d9-5924-459d", },
Ответ содержит информацию о задаче на удаление кластера Kubernetes. Пример ответа:
Response type=json{ "task": { "id": "a7baf2d9-5924-459", "command": "CREATE_CLUSTER", "createdAt": "2021-09-23T11:39:50.015Z", "status": "PENDING", "metadata": { "typeUrl": "string", "value": "string" }, "statusChangedAt": "2021-09-23T11:39:50.015Z", "response": { "typeUrl": "string", "value": "string" }, "error": { "code": 0, "message": "string", "details": [ { "typeUrl": "string", "value": "string" } ]