Установка или обновление конфигурации прокси кластера: различия между версиями

Материал из Документация Ключ-АСТРОМ
(Новая страница: «Этот вызов API обновляет конфигурацию прокси-сервера кластера. ==Аутентификация== Для выпо...»)
 
 
(не показана 1 промежуточная версия 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_%D0%9A%D0%BB%D0%B0%D1%81%D1%82%D0%B5%D1%80%D0%B0_v1 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.9F.D1.80.D0.BE.D0.BA.D1.81.D0.B8 Прокси] / Установка или обновление конфигурации прокси кластера'''''
Этот вызов API обновляет конфигурацию прокси-сервера кластера.
Этот вызов API обновляет конфигурацию прокси-сервера кластера.
==Аутентификация==
==Аутентификация==
Строка 20: Строка 22:
===Объекты тела запроса===
===Объекты тела запроса===
====Объект <code>InternetProxyChangeRequest</code>====
====Объект <code>InternetProxyChangeRequest</code>====
Настройка прокси-сервера для подключения к Интернету
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент

Текущая версия на 13:52, 18 августа 2023

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

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

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

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

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

/api/v1.0/onpremise/proxy/configuration

Параметры

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

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

Объект InternetProxyChangeRequest

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

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

Ответ

Коды ответа

Код Описание
201 Успешно создана новая конфигурация
204 Успешно, конфигурация обновлена
400 Данная конфигурация прокси-сервера недействительна

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

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

Пример

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

Curl

curl -X PUT "https://myManaged.cluster.com/api/v1.0/onpremise/proxy/configuration" -H  "accept: */*" -H  "Content-Type: application/json" -d "{\"scheme\":\"http\",\"server\":\"outbound-proxy.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/configuration

Тело ответа

{
  "code": 201,
  "message": "Successful, new configuration created."
}

Код ответа

201