Открыть меню
Открыть персональное меню
Вы не представились системе
Your IP address will be publicly visible if you make any edits.

Настройка обязанности нод кластера: различия между версиями

Материал из Документация АппОптима
Нет описания правки
Нет описания правки
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
'''''[https://doc.ruscomtech.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0 Установка и настройка] / [https://doc.ruscomtech.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#.D0.9E.D1.81.D0.BD.D0.BE.D0.B2.D0.BD.D1.8B.D0.B5_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D1.8B_.D0.9A.D0.BB.D1.8E.D1.87-.D0.90.D1.81.D1.82.D1.80.D0.BE.D0.BC Основные элементы Ключ-Астром] / [https://doc.ruscomtech.ru/index.php/%D0%9A%D0%BB%D1%8E%D1%87-%D0%90%D0%A1%D0%A2%D0%A0%D0%9E%D0%9C_Managed Ключ-АСТРОМ Managed] / [https://doc.ruscomtech.ru/index.php/%D0%9A%D0%BB%D1%8E%D1%87-%D0%90%D0%A1%D0%A2%D0%A0%D0%9E%D0%9C_Managed#REST_API REST API] / [https://doc.ruscomtech.ru/index.php/API%20%D0%9A%D0%BB%D0%B0%D1%81%D1%82%D0%B5%D1%80%D0%B0%20v1 API Кластера v1] / [https://doc.ruscomtech.ru/index.php/API_%D0%9A%D0%BB%D0%B0%D1%81%D1%82%D0%B5%D1%80%D0%B0_v1#.D0.9A.D0.BB.D0.B0.D1.81.D1.82.D0.B5.D1.80 Кластер] / Настройка обязанности нод кластера'''''
'''''Установка и настройка / Основные элементы АппОптима / АппОптима / REST API / API Кластера v1 / Кластер / Настройка обязанности нод кластера'''''


Этот запрос API настраивает обязанности узлов кластера.
Этот запрос API настраивает обязанности узлов кластера.


==Аутентификация==
==Аутентификация==
Для выполнения этого запроса вам необходимо разрешение API <code>(ServiceProviderAPI)</code>, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. [https://doc.ruscomtech.ru/index.php/%D0%90%D1%83%D1%82%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D1%8F_%D0%BA%D0%BB%D0%B0%D1%81%D1%82%D0%B5%D1%80%D0%B0 Аутентификация кластера].
Для выполнения этого запроса вам необходимо разрешение API <code>(ServiceProviderAPI)</code>, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.
==Конечная точка==
==Конечная точка==
<code>/api/v1.0/onpremise/cluster/configuration</code>
<code>/api/v1.0/onpremise/cluster/configuration</code>
Строка 82: Строка 82:


=== JSON-модель тела ответа ===
=== JSON-модель тела ответа ===
  <code>{
  <{
   "clusterNodes": [
   "clusterNodes": [
     {
     {
Строка 92: Строка 92:
     }
     }
   ]
   ]
  }</code>
  }


==Пример==
==Пример==
В этом примере мы отключаем трафик веб-интерфейса на '''ноде 1'''. Состояние операции можно проверить с помощью API-вызова '''Получить текущее состояние конфигурации узлов кластера'''.
В этом примере мы отключаем трафик веб-интерфейса на '''ноде 1'''. Состояние операции можно проверить с помощью API-вызова '''Получить текущее состояние конфигурации узлов кластера'''.
====Curl====
====Curl====
  <code>curl -X POST "<nowiki>https://myManaged.cluster.com/api/v1.0/onpremise/cluster/configuration</nowiki>" -H  "accept: */*" -H  "Content-Type: application/json" -d "{\"clusterNodes\":[{\"id\":1,\"ipAddress\":\"10.10.4.2\",\"webUI\":false,\"agent\":true,\"datacenter\":\"datacenter-1\",\"kubernetesRole\":\"\"}]}"</code>
  <code>curl -X POST "<nowiki>https://myАппОптима.cluster.com/api/v1.0/onpremise/cluster/configuration</nowiki>" -H  "accept: */*" -H  "Content-Type: application/json" -d "{\"clusterNodes\":[{\"id\":1,\"ipAddress\":\"10.10.4.2\",\"webUI\":false,\"agent\":true,\"datacenter\":\"datacenter-1\",\"kubernetesRole\":\"\"}]}"</code>
====URL-адрес запроса====
====URL-адрес запроса====
  <code><nowiki>https://myManaged.cluster.com/api/v1.0/onpremise/cluster/configuration</nowiki></code>
  <code><nowiki>https://myАппОптима.cluster.com/api/v1.0/onpremise/cluster/configuration</nowiki></code>
====Тело запроса====
====Тело запроса====
  <code>{
  <{
   "clusterNodes": [
   "clusterNodes": [
     {
     {
Строка 112: Строка 112:
     }
     }
   ]
   ]
  }</code>
  }


==== Тело ответа ====
==== Тело ответа ====
  <code>{
  <{
   "lockAcquired": true,
   "lockAcquired": true,
   "acquirationTime": 1619771074449,
   "acquirationTime": 1619771074449,
   "notAcquiredReason": null
   "notAcquiredReason": null
  }</code>
  }


====Код ответа====
====Код ответа====
<code>200</code>
<code>200</code>

Текущая версия от 16:20, 25 декабря 2024

Установка и настройка / Основные элементы АппОптима / АппОптима / REST API / API Кластера v1 / Кластер / Настройка обязанности нод кластера

Этот запрос API настраивает обязанности узлов кластера.

Аутентификация

Для выполнения этого запроса вам необходимо разрешение API (ServiceProviderAPI), назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.

Конечная точка

/api/v1.0/onpremise/cluster/configuration

Параметры

Параметр Тип Описание В Обязательно
body ClusterNodesConfigDto - body Нет

Объекты тела запроса

Объект ClusterNodesConfigDto

Элемент Тип Описание Обязательно
clusterNodes NodeConfigDto[] - Нет

Объект NodeConfigDto

Элемент Тип Описание Обязательно
id integer - Нет
webUI boolean - Нет
agent boolean - Нет
datacenter string - Нет
kubernetesRole string - Нет

Ответ

Коды ответа

Код Описание
200 Success

JSON-модель тела ответа

<{
  "clusterNodes": [
    {
      "id": 1,
      "webUI": true,
      "agent": true,
      "datacenter": "string",
      "kubernetesRole": "string"
    }
  ]
}

Пример

В этом примере мы отключаем трафик веб-интерфейса на ноде 1. Состояние операции можно проверить с помощью API-вызова Получить текущее состояние конфигурации узлов кластера.

Curl

curl -X POST "https://myАппОптима.cluster.com/api/v1.0/onpremise/cluster/configuration" -H  "accept: */*" -H  "Content-Type: application/json" -d "{\"clusterNodes\":[{\"id\":1,\"ipAddress\":\"10.10.4.2\",\"webUI\":false,\"agent\":true,\"datacenter\":\"datacenter-1\",\"kubernetesRole\":\"\"}]}"

URL-адрес запроса

https://myАппОптима.cluster.com/api/v1.0/onpremise/cluster/configuration

Тело запроса

<{
  "clusterNodes": [
    {
      "id": 1,
      "ipAddress": "10.10.4.2",
      "webUI": false,
      "agent": true,
      "datacenter": "datacenter-1",
      "kubernetesRole": ""
    }
  ]
}

Тело ответа

<{
  "lockAcquired": true,
  "acquirationTime": 1619771074449,
  "notAcquiredReason": null
}

Код ответа

200