ロールマッピングを削除
DELETE /v1/connections/{connection_id}/role-mappings/{mapping_id} · 権限 connections:write
マッピングを削除します。このマッピングを通じて付与されていたロールは、次のサインイン時に再計算されます。削除は role_mapping.deleted として監査されます。
リクエスト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
connection_id |
path | はい | エンタープライズ接続 ID(conn_…)。 |
mapping_id |
path | はい | ロールマッピング ID(rmp_…)。 |
リクエストボディはありません。
レスポンス
204 No Content。
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 404 | not_found |
この接続にマッピングが存在しません。 |
| 401 | unauthenticated |
資格情報がない、無効、または失効しています。 |
| 403 | insufficient_permissions |
資格情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間を待ってから再試行してください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。Retry-After の期間を待ってから再試行してください。 |
例
curl -i -X DELETE "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/role-mappings/rmp_01j9xw0x4y5z9a1b3c5d7e9f1h" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"