Получить информацию о конкретном АктивномШлюзе: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Получает информацию об указанном ActiveGate. Запрос создает <code>application/json</code>полезную нагруз...») |
(нет различий)
|
Версия 05:36, 13 декабря 2021
Получает информацию об указанном ActiveGate.
Запрос создает application/jsonполезную нагрузку.
| ПОЛУЧИТЬ |
|
Аутентификация
Чтобы выполнить этот запрос, вам необходимо разрешение на чтение ActiveGates ( activeGates.read), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | В | необходимые |
|---|---|---|---|---|
| стареть | нить | ID необходимого ActiveGate. | дорожка | обязательный |
Ответ
Коды ответов
| Код | Описание |
|---|---|
| 200 | Успех |
| 404 | Не найден. См. Подробности в теле ответа. |
Тело ответа
- Параметры ответа
ActiveGate объект
Параметры ActiveGate.
| Элемент | Тип | Описание |
|---|---|---|
| я бы | нить | Идентификатор ActiveGate. |
| networkAddresses | нить[] | Список сетевых адресов ActiveGate. |
| loadBalancerAddresses | нить[] | Список адресов Load Balancer ActiveGate. |
| osType | нить | Тип ОС, на которой работает ActiveGate.
Элемент может содержать эти значения |
| autoUpdateStatus | нить | Текущий статус автообновлений ActiveGate.
Элемент может содержать эти значения |
| offline | целое число | Отметка времени, с которой ActiveGate отключен.
|
| версия | нить | Текущая версия ActiveGate в <major>.<minor>.<revision>.<timestamp>формате.
|
| тип | нить | Тип ActiveGate.
Элемент может содержать эти значения |
| имя хоста | нить | Имя хоста, на котором работает ActiveGate. |
| mainEnvironment | нить | Идентификатор основной среды для ActiveGate с несколькими средами. |
| окружающая среда | нить[] | Список сред (заданных идентификаторами), к которым ActiveGate может подключиться. |
| autoUpdateSettings | Активный Gate Auto Update Config | |
| networkZone | нить | Сетевая зона ActiveGate. |
| группа | нить | Группа ActiveGate. |
| модули | Активный Gate модуль [] | Список модулей ActiveGate. |
| контейнерный | логический | ActiveGate развертывается в контейнере ( true) или нет ( false).
|
ActiveGateModule объект
Информация о модуле ActiveGate
| Элемент | Тип | Описание |
|---|---|---|
| неправильно настроен | логический | Модуль неправильно сконфигурирован ( true) или нет ( false).
|
| тип | нить | Тип модуля ActiveGate.
Элемент может содержать эти значения |
| атрибуты | объект | Атрибуты модуля ActiveGate. |
| версия | нить | Версия модуля ActiveGate. |
| включено | логический | Модуль включен ( true) или отключен ( false).
|
ActiveGateAutoUpdateConfig объект
Настройка автообновлений ActiveGate.
| Элемент | Тип | Описание |
|---|---|---|
| параметр | нить | Состояние автообновления ActiveGate: включено, отключено или унаследовано.
Если установлено значение Элемент может содержать эти значения |
| EffectiveSetting | нить | Фактическое состояние автообновления ActiveGate.
Применимо, только если параметр настройки установлен на Элемент может содержать эти значения |
- Модель JSON
{
"id": "0x3efdd091",
"networkAddresses": [
"string"
],
"loadBalancerAddresses": [
"string"
],
"osType": "WINDOWS",
"autoUpdateStatus": "OUTDATED",
"offlineSince": 1582031917814,
"version": "1.185.0.20200201-120000",
"type": "ENVIRONMENT",
"hostname": "exampleHostname",
"mainEnvironment": "d1bf4a7e-666b-43af-9f45-718g98372e2f",
"environments": [
"string"
],
"autoUpdateSettings": {
"setting": "INHERITED",
"effectiveSetting": "ENABLED"
},
"networkZone": "exampleNetworkZone",
"group": "default",
"modules": [
{
"misconfigured": true,
"type": "KUBERNETES",
"attributes": {},
"version": "string",
"enabled": true
}
],
"containerized": true
}
Пример
В этом примере в запросе перечислены параметры ActiveGate с идентификатором 876651882 .
Токен API передается в заголовке авторизации .
Завиток
curl -L -X GET 'https://mySampleEnv/api/v2/activeGates/876651882' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL запроса
https://mySampleEnv/api/v2/activeGates/876651882
Тело ответа
{
"id": "876651882",
"networkAddresses": [
"orange-13.easytravel.com",
"228.245.125.39"
],
"osType": "LINUX",
"autoUpdateStatus": "UPDATE_IN_PROGRESS",
"offlineSince": null,
"version": "1.198.0.20200630-163221",
"type": "ENVIRONMENT",
"hostname": "orange-13.easytravel.com",
"mainEnvironment": null,
"environments": [
"mySampleEnv"
],
"networkZone": "easytravel.europe.austria.05"
}
Код ответа
200