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