|
|
| Строка 1: |
Строка 1: |
| Этот вызов API получает информацию запроса доступа к кластеру для определенного идентификатора доступа запроса. Запрос создает полезную нагрузку <code>application/json</code>.
| |
|
| |
|
| ==Аутентификация==
| |
| Для выполнения этого запроса вам необходимо разрешение одной из областей API <code>(ClusterTokenManagement, ServiceProvider или Nodekeeper)</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 Аутентификация кластера].
| |
| ==Конечная точка==
| |
| <code>/api/cluster/v2/remoteaccess/requests</code>
| |
| ==Параметры==
| |
| {| class="wikitable"
| |
| !Параметр
| |
| !Тип
| |
| !Описание
| |
| !В
| |
| !Обязательно
| |
| |-
| |
| |requestId
| |
| |string
| |
| |Параметр идентификатора запроса
| |
| |path
| |
| |Да
| |
| |}
| |
|
| |
| ==Ответ==
| |
| ===Коды ответа===
| |
| {| class="wikitable"
| |
| !Код
| |
| !Тип
| |
| !Описание
| |
| |-
| |
| |'''200'''
| |
| |AccessRequestData
| |
| |Успешно
| |
| |-
| |
| |'''400'''
| |
| |
| |
| |Неверный запрос
| |
| |-
| |
| |'''403'''
| |
| |
| |
| |Утверждение запроса на удаленный доступ отключено
| |
| |-
| |
| |'''404'''
| |
| |
| |
| |Не найдено
| |
| |}
| |
| ===Объекты тела ответа===
| |
| ====Объект <code>AccessRequestData</code>====
| |
| {| class="wikitable"
| |
| !Элемент
| |
| !Тип
| |
| !Описание
| |
| |-
| |
| |requestId
| |
| |string
| |
| |Идентификатор запроса
| |
| |-
| |
| |userId
| |
| |string
| |
| |ID пользователя
| |
| |-
| |
| |reason
| |
| |string
| |
| |Описание причины запроса
| |
| |-
| |
| |requestedDays
| |
| |integer
| |
| |На сколько дней запрашивается доступ
| |
| |-
| |
| |role
| |
| |string
| |
| |Запрошенная роль
| |
|
| |
| Элемент может содержать эти значения:
| |
|
| |
| * <code>devops-admin</code>
| |
| * <code>devops-user</code>
| |
| * <code>devops-viewer</code>
| |
| |-
| |
| |createdTimestamp
| |
| |integer
| |
| |Запрос на доступ создан в (отметка времени)
| |
| |-
| |
| |expirationTimestamp
| |
| |integer
| |
| |Доступ истекает в (отметка времени)
| |
| |-
| |
| |state
| |
| |string
| |
| |Состояние запроса доступа
| |
|
| |
| Элемент может содержать эти значения
| |
|
| |
| * <code>ACCEPTED</code>
| |
| * <code>EXPIRED</code>
| |
| * <code>PENDING</code>
| |
| * <code>REJECTED</code>
| |
| |-
| |
| |stateModifiedByUser
| |
| |string
| |
| |Состояние запроса на доступ было изменено пользователем
| |
| |}
| |
| ===JSON-модель тела ответа===
| |
| <code>{
| |
| "requestId": "string",
| |
| "userId": "string",
| |
| "reason": "string",
| |
| "requestedDays": 1,
| |
| "role": "devops-admin",
| |
| "createdTimestamp": 1,
| |
| "expirationTimestamp": 1,
| |
| "state": "ACCEPTED",
| |
| "stateModifiedByUser": "string"
| |
| }</code>
| |
| ==Пример==
| |
| В этом примере вы запрашиваете список разрешений на удаленный доступ для определенного идентификатора доступа запроса <code>(7a397770-86b7-473b-b23e-4a07d79f2eff)</code>. В ответ вы получаете ответ JSON, который указывает, что идентификатор запроса <code>7a397770-86b7-473b-b23e-4a07d79f2eff</code> предназначен для пользователя <code>john.smith@dynatrace.com</code>, у которого есть разрешение на удаленный доступ с ролью администратора в течение <code>7</code> дней, и причина заключается в проверке состояние кластера после обновления.
| |
| ====Curl====
| |
| <code>curl -X GET "<nowiki>https://myManaged.cluster.com/api/cluster/v2/remoteaccess/requests/7a397770-86b7-473b-b23e-4a07d79f2eff</nowiki>" -H "accept: application/json"</code>
| |
| ====URL-адрес запроса====
| |
| <code><nowiki>https://myManaged.cluster.com/api/cluster/v2/remoteaccess/requests/7a397770-86b7-473b-b23e-4a07d79f2eff</nowiki></code>
| |
| ====Тело ответа====
| |
| <code>{
| |
| "requestId": "7a397770-86b7-473b-b23e-4a07d79f2eff",
| |
| "userId": "john.smith@dynatrace.com",
| |
| "reason": "SUP-123456 Verifying cluster state after upgrade",
| |
| "requestedDays": 7,
| |
| "role": "devops-admin",
| |
| "createdTimestamp": 1586452866661,
| |
| "expirationTimestamp": 1587081600000,
| |
| "state": "ACCEPTED",
| |
| "stateModifiedByUser": "katie.novak"
| |
| }</code>
| |
| ====Код ответа====
| |
| <code>200</code>
| |
