Revocar el agente de un cliente gestionado
Revoca un agente perdido o sustituido y marca sus impresoras como desconectadas.
DELETE
/partner-api/v1/accounts/{relationshipId}/agents/{agentId}Versión de la API: v1operationId: revokePartnerManagedAgentVer como MarkdownQué hace este método
Revoca un agente perdido o sustituido y marca sus impresoras como desconectadas.
Autenticación
Envía una aserción RS256 de un solo uso de la Developer Application en Authorization: Bearer <application_assertion>. No es un token de acceso de Public API.
Solicitud
URL de producción: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agents/{agentId}
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|---|
relationshipId | path | string (uuid) | sí | UUID estable de la relación del partner con el cliente gestionado. | — |
agentId | path | string (uuid) | sí | UUID estable del agente del cliente gestionado indicado en la ruta. | — |
X-Request-Id | header | string | no | Identificador opcional para rastrear la solicitud; CloudPrint devuelve un valor seguro en la cabecera de respuesta. | maxLength: 128; example: "order-100045-attempt-1" |
Cuerpo de la solicitud
El método no tiene cuerpo de solicitud.
Ejemplos de solicitud
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"Respuesta
Estado HTTP: 204 — Operación completada sin cuerpo de respuesta.
Errores
| Estado HTTP | Descripción |
|---|---|
401 | Falta la autenticación o no es válida. |
403 | El token no tiene permisos suficientes. |
404 | No se encontró el recurso. |
422 | Uno o varios campos no son válidos. |
429 | Se superó el límite de solicitudes; respeta Retry-After. |
500 | Error interno de CloudPrint. |
Documentación relacionada
Listar agentes de un cliente gestionadoConsulta todos los agentes conectados a un cliente gestionado, incluidos los revocados.Crear un Agent Enrollment gestionadoGenera un Enrollment idempotente de un solo uso antes o después de incorporar al cliente.Conectar un agente de clienteVincula CloudPrint Agent con la cuenta administrada correcta sin iniciar sesión en el panel del cliente.