Тест конфигурации прокси из определенного центра обработки данных

Материал из Документация Ключ-АСТРОМ
Версия от 14:04, 18 августа 2023; ENetrebin (обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

Установка и настройка / Основные элементы Ключ-Астром / Ключ-АСТРОМ Managed / REST API / API Кластера v1 / Прокси для ВысокойДоступности / Тест конфигурации прокси из определенного центра обработки данных

Этот вызов API проверяет конфигурацию прокси из определенного центра обработки данных.

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

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

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

/api/v1.0/onpremise/proxy/test

Параметры

Параметр Тип Описание В Обязательно
dc string Дата-центр path Да
body InternetProxyChangeRequest Конфигурация прокси-сервера для интернет-соединения body Да

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

Объект InternetProxyChangeRequest

Настройка прокси-сервера для подключения к Интернету

Элемент Тип Описание Обязательно
scheme string Протокол, который использует прокси-сервер (http, https) Да
server string Адрес (либо IP, либо имя хоста) прокси-сервера Да
port integer Порт прокси-сервера Да
user string Пользователь прокси-сервера, ноль означает, что предыдущее значение нельзя изменять. Нет
password string Пароль прокси-сервера, ноль означает, что предыдущее значение нельзя изменять. Нет
nonProxyHosts string[] Определение хостов, для которых прокси не будет использоваться. Вы можете определить несколько хостов. Каждый хост может начинаться или заканчиваться подстановочным знаком «*», например, для соответствия всему домену. Нет

JSON-модель тела запроса

Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.

{
  "scheme": "http",
  "server": "string",
  "port": 1,
  "user": "string",
  "password": "string",
  "nonProxyHosts": [
    "string"
  ]
}

Ответ

Коды ответа

Код Тип Описание
200 ConnectionStatus Запрос обработан, подробности в тексте ответа

Объекты тела ответа

Объект ConnectionStatus

Результат проверки интернет-соединения

Элемент Тип Описание
connectionOk boolean Результат проверки соединения
testExecuted boolean Указывает, выполнялся ли тест
testExecutionMessage string Дополнительные комментарии обычно указывают, почему тест не был выполнен

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

{
  "connectionOk": true,
  "testExecuted": true,
  "testExecutionMessage": "string"
}

Пример

В этом примере вы тестируете прокси-сервер (outbound-proxy-dc1.dynatrace.com), который использует порт 8080 и требует пароль в определенном центре обработки данных (eu-west-1), в то же время исключая внутренний тестовый хост ( *.internal.lab.company.com). В ответ вы получаете ответ JSON, указывающий, что соединение установлено.

Curl

curl -X PUT "https://myManaged.cluster.com/api/v1.0/onpremise/proxy/test/eu-west-1" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{\"scheme\":\"http\",\"server\":\"outbound-proxy-dc1.dynatrace.com\",\"port\":8080,\"nonProxyHosts\":[\"https://mycompany.com/proxy/*\",\"*.internal.lab.company.com\"],\"userOrPasswordDefined\":true}"

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

https://myManaged.cluster.com/api/v1.0/onpremise/proxy/test/eu-west-1

Тело ответа

{
  "connectionOk": true,
  "testExecuted": true,
  "testExecutionMessage": "string"
}

Код ответа

200