デプロビジョニング保留の承認

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

ディレクトリの一括デプロビジョニング保留を承認します。保留されていたデプロビジョニングが適用されます。directory.deprovision_hold_approved として監査されます。もう開いていない保留、または72時間のタイムアウトを過ぎた保留（タイムアウトにより承認済みとなり、この決定は適用されません）は 409 conflict を返します。

リクエスト

フィールド	型	必須	説明
`directory_id`	path	はい	SCIMディレクトリID（`dir_…`）。
`hold_id`	path	はい	保留ID。`GET /v1/directories/{directory_id}` の `open_deprovision_hold.id`（小文字のUUID）。

リクエストボディはありません。

レスポンス

200 OK と決定結果を返します。

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

エラー

HTTP	code	発生条件
404	`not_found`	ディレクトリまたは保留がこの環境に存在しない、または保留が別のディレクトリのものです。
409	`conflict`	保留にはすでに決定が下されたか、72時間のタイムアウトを過ぎています。
401	`unauthenticated`	認証情報がない、無効、または失効しています。
403	`insufficient_permissions`	認証情報に必要な権限がありません。
429	`rate_limited`	レート制限を超えました。`Retry-After` の期間を待ってから再試行してください。
503	`service_unavailable`	ディレクトリ同期が一時的に利用できないか、このデプロイメントで構成されていません。`Retry-After` の期間を待ってから再試行してください。

例

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)"