Agent Enrollment widerrufen

Widerrufen Sie ein nicht verwendetes Enrollment, damit sein Geheimcode keinen Agenten mehr verbinden kann.

DELETE/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}API-Version: v1operationId: revokePartnerAgentEnrollmentAls Markdown anzeigen

Funktion dieser Methode

Widerrufen Sie ein nicht verwendetes Enrollment, damit sein Geheimcode keinen Agenten mehr verbinden kann.

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}/agent-enrollments/{enrollmentId}

Parameter

Name	Position	Typ	Erforderlich	Beschreibung	Einschränkungen
`relationshipId`	path	`string (uuid)`	ja	Stabile UUID der Partnerbeziehung zum verwalteten Kunden.	—
`enrollmentId`	path	`string (uuid)`	ja	Stabile UUID des Agent Enrollments 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/agent-enrollments/$ENROLLMENT_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.

Agent Enrollment widerrufen ​

Funktion dieser Methode ​

Authentifizierung ​

Anfrage ​

Parameter ​

Anfrageinhalt ​

Anfragebeispiele ​

cURL ​

Antwort ​

Fehler ​

Verwandte Dokumentation ​