Изменить состояние управляемого клиента
Приостановите, возобновите или навсегда закройте связь клиента с Developer Application.
POST
/partner-api/v1/accounts/{relationshipId}/{action}Версия API: v1operationId: changePartnerManagedAccountStateОткрыть в MarkdownНазначение метода
Приостановите, возобновите или навсегда закройте связь клиента с Developer Application.
Авторизация
Передавайте одноразовое JWT-подтверждение Developer Application, подписанное RS256, в Authorization: Bearer <application_assertion>. Это не токен доступа к Public API.
Запрос
Основной адрес API: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/{action}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|---|
relationshipId | path | string (uuid) | да | Стабильный UUID связи партнёра с управляемым клиентом. | — |
action | path | string | да | Действие с управляемым аккаунтом: приостановить, возобновить или окончательно закрыть. | enum: suspend, resume, close |
X-Request-Id | header | string | нет | Необязательный идентификатор для трассировки запроса; CloudPrint вернёт безопасное значение в заголовке ответа. | maxLength: 128; example: "order-100045-attempt-1" |
Тело запроса
У метода нет тела запроса.
Примеры запросов
cURL
bash
curl -sS -X POST "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/suspend" \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Ответ
HTTP-статус: 200 — Запрос выполнен.
Поля ответа
| Имя | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|
relationship_id | string (uuid) | да | Стабильный UUID связи партнёра с управляемым клиентом. | — |
developer_account_id | string (uuid) | да | Стабильный UUID аккаунта разработчика, которому принадлежит связь с клиентом. | — |
cloudprint_account_id | string (uuid) | да | Стабильный UUID аккаунта CloudPrint, созданного для управляемого клиента. | — |
external_customer_id | string | да | Стабильный идентификатор клиента в системе интегратора. Он должен быть уникальным в пределах авторизованного Developer Application. | maxLength: 160 |
name | string | да | Отображаемое имя ресурса для операторов аккаунта. | maxLength: 120 |
application_id | string (uuid) | да | Стабильный идентификатор Developer Application, представленного токеном установки. | — |
installation_id | string | null (uuid) | да | Стабильный UUID App Installation, выдавшей разрешение токену. | — |
agent_enrollment_id | string | null (uuid) | да | Стабильный идентификатор Agent Enrollment. | — |
agent_onboarding_expires_at | string | null (date-time) | да | Временная метка CloudPrint в формате ISO 8601. | — |
agent_onboarding_url | string | null (uri) | да | Основная одноразовая ссылка для подключения агента. Открывайте её целиком, не изменяйте и не записывайте в логи. | example: "https://connect.cloudprint.me/setup#token=cpat_example" |
onboarding_status | string | да | Текущее состояние готовности CloudPrint у управляемого клиента. | enum: provisioning, waiting_for_agent, ready, failed |
status | string | да | Текущее состояние ресурса или процесса; учитывайте допустимые значения конкретного метода. | enum: provisioning, active, suspended, closed |
created_at | string (date-time) | да | Временная метка CloudPrint в формате ISO 8601. | — |
updated_at | string (date-time) | да | Временная метка CloudPrint в формате ISO 8601. | — |
Пример ответа
json
{
"relationship_id": "11111111-1111-4111-8111-111111111111",
"developer_account_id": "11111111-1111-4111-8111-111111111111",
"cloudprint_account_id": "11111111-1111-4111-8111-111111111111",
"external_customer_id": "string",
"name": "string",
"application_id": "11111111-1111-4111-8111-111111111111",
"installation_id": "11111111-1111-4111-8111-111111111111",
"agent_enrollment_id": "11111111-1111-4111-8111-111111111111",
"agent_onboarding_expires_at": "2026-08-06T12:00:00Z",
"agent_onboarding_url": "https://connect.cloudprint.me/setup#token=cpat_example",
"onboarding_status": "provisioning",
"status": "provisioning",
"created_at": "2026-08-06T12:00:00Z",
"updated_at": "2026-08-06T12:00:00Z"
}Ошибки
| HTTP-статус | Описание |
|---|---|
401 | Авторизация отсутствует или недействительна. |
403 | Для операции недостаточно разрешений. |
404 | Запрошенный ресурс не найден. |
422 | Поля запроса не прошли проверку. |
429 | Превышен лимит запросов; учитывайте Retry-After. |
500 | Внутренняя ошибка CloudPrint. |
Связанная документация
Получить управляемые аккаунты клиентовПолучите аккаунты клиентов, созданные авторизованным Developer Application, включая состояние агентов и принтеров.Создать управляемый аккаунт клиентаСоздайте изолированный аккаунт CloudPrint, App Installation и одноразовое подключение агента без регистрации клиента.Ошибки и повторы CloudPrint APIОбрабатывайте HTTP-статусы, машиночитаемые ошибки, ограничения частоты запросов, трассировку и безопасные повторы.