Approva una sospensione di deprovisioning

POST /v1/directories/{directory_id}/deprovision-holds/{hold_id}:approve · autorizzazione directories:write

Approva la sospensione di deprovisioning di massa della directory: i deprovisioning sospesi vengono applicati. Registrata come directory.deprovision_hold_approved. Una sospensione non più aperta, oppure oltre il suo timeout di 72 ore (viene approvata dal timeout e questa decisione non viene applicata), restituisce 409 conflict.

Richiesta

Campo	Tipo	Obbligatorio	Descrizione
`directory_id`	path	sì	ID della directory SCIM (`dir_…`).
`hold_id`	path	sì	L'ID della sospensione: `open_deprovision_hold.id` di `GET /v1/directories/{directory_id}` (UUID in minuscolo).

Non c'è un corpo della richiesta.

Risposta

200 OK con la decisione.

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

Errori

HTTP	code	Quando
404	`not_found`	La directory o la sospensione non esiste in questo ambiente, oppure la sospensione appartiene a un'altra directory.
409	`conflict`	La sospensione è già stata decisa oppure ha superato il suo timeout di 72 ore.
401	`unauthenticated`	La credenziale è mancante, non valida o revocata.
403	`insufficient_permissions`	La credenziale non ha l'autorizzazione richiesta.
429	`rate_limited`	È stato superato il limite di frequenza; riprova dopo il periodo `Retry-After`.
503	`service_unavailable`	La sincronizzazione delle directory è temporaneamente non disponibile o non configurata in questa installazione; riprova dopo il periodo `Retry-After`.

Esempio

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