Изменить состояние управляемого клиента

Приостановите, возобновите или навсегда закройте отношения с клиентом партнёрского приложения.

POST/partner-api/v1/accounts/{relationshipId}/{action}Версия API: v1operationId: changePartnerManagedAccountStateОткрыть в Markdown

Назначение метода

Приостановите, возобновите или навсегда закройте отношения с клиентом партнёрского приложения.

Авторизация

Передавайте одноразовый RS256 assertion Developer Application в Authorization: Bearer <application_assertion>. Это не токен доступа к Public API.

Запрос

Основной адрес API: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/{action}

Параметры

Имя	Расположение	Тип	Обязательно	Описание	Ограничения
`relationshipId`	path	`string (uuid)`	да	Поле контракта API; учитывайте указанные тип и ограничения.	—
`action`	path	`string`	да	Поле контракта API; учитывайте указанные тип и ограничения.	enum: `suspend`, `resume`, `close`

Тело запроса

У метода нет тела запроса.

Примеры запросов

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)`	да	Стабильный идентификатор этого ресурса.	—
`developer_account_id`	`string (uuid)`	да	Стабильный идентификатор этого ресурса.	—
`cloudprint_account_id`	`string (uuid)`	да	Стабильный идентификатор этого ресурса.	—
`external_customer_id`	`string`	да	Стабильный идентификатор этого ресурса.	maxLength: 160
`name`	`string`	да	Поле контракта API; учитывайте указанные тип и ограничения.	maxLength: 120
`application_id`	`string (uuid)`	да	Стабильный идентификатор Developer Application, представленного токеном установки.	—
`installation_id`	`string \| null (uuid)`	да	Стабильный UUID App Installation, выдавшей разрешение токену.	—
`agent_enrollment_id`	`string \| null (uuid)`	да	Стабильный идентификатор этого ресурса.	—
`agent_onboarding_expires_at`	`string \| null (date-time)`	да	Временная метка CloudPrint в формате ISO 8601.	—
`agent_onboarding_url`	`string \| null (uri)`	да	Поле контракта API; учитывайте указанные тип и ограничения.	example: `"https://connect.cloudprint.me/setup#token=cpat_example"`
`onboarding_status`	`string`	да	Поле контракта API; учитывайте указанные тип и ограничения.	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": null,
  "agent_enrollment_id": null,
  "agent_onboarding_expires_at": null,
  "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.

Связанная документация

Получить управляемые аккаунты клиентовПолучите аккаунты клиентов, созданные партнёрским приложением, включая состояние агентов и принтеров.Создать управляемый аккаунт клиентаСоздайте изолированный аккаунт CloudPrint, App Installation и одноразовое подключение агента без регистрации клиента.Ошибки и повторы CloudPrint APIОбрабатывайте HTTP-статусы, машиночитаемые ошибки, ограничения частоты запросов, трассировку и безопасные повторы.

Изменить состояние управляемого клиента ​

Назначение метода ​

Авторизация ​

Запрос ​

Параметры ​

Тело запроса ​

Примеры запросов ​

cURL ​

Ответ ​

Поля ответа ​

Пример ответа ​

Ошибки ​

Рекомендации по интеграции ​

Связанная документация ​