Отозвать Agent клиента
Отзовите потерянный или заменённый Agent и переведите его принтеры offline.
DELETE
/partner-api/v1/accounts/{relationshipId}/agents/{agentId}Версия API: v1operationId: revokePartnerManagedAgentОткрыть в MarkdownНазначение метода
Отзовите потерянный или заменённый Agent и переведите его принтеры offline.
Авторизация
Передавайте одноразовый RS256 assertion Developer Application в Authorization: Bearer <application_assertion>. Это не токен доступа к Public API.
Запрос
Основной адрес API: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agents/{agentId}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|---|
relationshipId | path | string (uuid) | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |
agentId | path | string (uuid) | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |
Тело запроса
У метода нет тела запроса.
Примеры запросов
cURL
bash
curl -sS -X DELETE "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agents/$AGENT_ID" \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Ответ
HTTP-статус: 204 — Операция выполнена без тела ответа.
Ошибки
| HTTP-статус | Описание |
|---|---|
401 | Авторизация отсутствует или недействительна. |
403 | Для операции недостаточно разрешений. |
404 | Запрошенный ресурс не найден. |
422 | Поля запроса не прошли проверку. |
429 | Превышен лимит запросов; учитывайте Retry-After. |
500 | Внутренняя ошибка CloudPrint. |
Рекомендации по интеграции
Связанная документация
Получить Agents клиентаПолучите все Agents управляемого клиента, включая отозванные.Создать Agent EnrollmentВыпустите идемпотентный одноразовый Enrollment до или после onboarding клиента.Подключение агента клиентаПодключите локальный CloudPrint Agent к правильному управляемому аккаунту без входа клиента в кабинет CloudPrint.