Agent eines verwalteten Kunden widerrufen
Widerrufen Sie einen verlorenen oder ersetzten Agenten und setzen Sie seine Drucker offline.
DELETE
/partner-api/v1/accounts/{relationshipId}/agents/{agentId}API-Version: v1operationId: revokePartnerManagedAgentAls Markdown anzeigenFunktion dieser Methode
Widerrufen Sie einen verlorenen oder ersetzten Agenten und setzen Sie seine Drucker offline.
Authentifizierung
Senden Sie eine einmalige RS256-Assertion der Developer Application in Authorization: Bearer <application_assertion>. Sie ist kein Public-API-Zugriffstoken.
Anfrage
Produktions-URL: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agents/{agentId}
Parameter
| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
|---|---|---|---|---|---|
relationshipId | path | string (uuid) | ja | Stabile UUID der Partnerbeziehung zum verwalteten Kunden. | — |
agentId | path | string (uuid) | ja | Stabile UUID des Agenten eines verwalteten Kunden im Pfad. | — |
X-Request-Id | header | string | nein | Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück. | maxLength: 128; example: "order-100045-attempt-1" |
Anfrageinhalt
Die Methode hat keinen Anfrageinhalt.
Anfragebeispiele
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"Antwort
HTTP-Status: 204 — Vorgang ohne Antwortinhalt abgeschlossen.
Fehler
| HTTP-Status | Beschreibung |
|---|---|
401 | Authentifizierung fehlt oder ist ungültig. |
403 | Das Token hat nicht die erforderlichen Berechtigungen. |
404 | Ressource nicht gefunden. |
422 | Mindestens ein Feld ist ungültig. |
429 | Anfragelimit überschritten; beachten Sie Retry-After. |
500 | Interner CloudPrint-Fehler. |
Verwandte Dokumentation
Agents eines verwalteten Kunden auflistenRufen Sie alle mit einem verwalteten Kunden verbundenen Agents einschließlich widerrufener Agents ab.Verwaltetes Agent Enrollment erstellenStellen Sie vor oder nach dem Kunden-Onboarding ein idempotentes, einmaliges Enrollment aus.Kunden-Agent verbindenVerbinden Sie CloudPrint Agent ohne Anmeldung im Kundenportal mit dem richtigen verwalteten Konto.