Deprovisionierungssperre ablehnen

POST /v1/directories/{directory_id}/deprovision-holds/{hold_id}:reject · Berechtigung directories:write

Lehnt die Massen-Deprovisionierungssperre des Verzeichnisses ab: Die zurückgehaltenen Deprovisionierungen werden verworfen, und die betroffenen Datensätze werden als abweichend markiert. Protokolliert als directory.deprovision_hold_rejected. Eine Sperre, die nicht mehr offen ist, oder die ihr 72-Stunden-Zeitlimit überschritten hat (sie wird durch das Zeitlimit genehmigt, und diese Entscheidung wird nicht angewendet), liefert 409 conflict.

Anfrage

Feld	Typ	Pflicht	Beschreibung
`directory_id`	path	ja	SCIM-Verzeichnis-ID (`dir_…`).
`hold_id`	path	ja	Die Sperr-ID: `open_deprovision_hold.id` aus `GET /v1/directories/{directory_id}` (UUID in Kleinbuchstaben).

Es gibt keinen Anfrage-Body.

Antwort

200 OK mit der Entscheidung.

{
  "id": "0192a3c0-1d2e-7f3a-8b4c-5d6e7f8a9b0c",
  "directory_id": "dir_01j9xm2n4p6q8r0s2t4v6w8y0z",
  "status": "rejected"
}

Fehler

HTTP	code	Wann
404	`not_found`	Das Verzeichnis oder die Sperre existiert nicht in dieser Umgebung, oder die Sperre gehört zu einem anderen Verzeichnis.
409	`conflict`	Über die Sperre wurde bereits entschieden, oder sie hat ihr 72-Stunden-Zeitlimit überschritten.
401	`unauthenticated`	Die Anmeldeinformation fehlt, ist ungültig oder widerrufen.
403	`insufficient_permissions`	Der Anmeldeinformation fehlt die erforderliche Berechtigung.
429	`rate_limited`	Das Ratenlimit wurde überschritten; nach Ablauf des `Retry-After`-Zeitraums erneut versuchen.
503	`service_unavailable`	Die Verzeichnissynchronisation ist vorübergehend nicht verfügbar oder in diesem Deployment nicht konfiguriert; nach Ablauf des `Retry-After`-Zeitraums erneut versuchen.

Beispiel

curl -i -X POST "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/deprovision-holds/0192a3c0-1d2e-7f3a-8b4c-5d6e7f8a9b0c:reject" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)"