Identity からの Memory Store の解除

Memory Store と (identity, template) のマウントを解除します。Store 本体と Memory エントリには影響しません。 以後、その Identity がこの Template で作成する Session には Store が読み込まれません。 システム管理のデフォルト Store はマウント解除できません。 解除しようとすると 409 が返されます。

パス

DELETE /api/v1/forward/identities/{identity_id}/templates/{template_id}/memory_stores/{memory_store_id}

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT, admin SAT, or SAT for this Identity>`

Identity レベルの Service Account Token は自身の Identity のみ操作できます。別の Identity を操作すると 403 が返されます。

パスパラメータ

パラメータ	型	必須	説明
`identity_id`	string	はい	Identity ID（`idn_...`）。
`template_id`	string	はい	Template ID（`tmpl_...`）。
`memory_store_id`	string	はい	マウント解除する Memory Store ID（`memstore_...`）。

リクエスト例

curl -X DELETE "https://api.qoder.com/api/v1/forward/identities/idn_63ee28747a35cff93771c491/templates/tmpl_eb3377fb74ad413e17b3d755/memory_stores/memstore_00mc7mukn7lkxr454tjd" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store_binding_deleted",
  "deleted": true
}

レスポンスフィールド

フィールド	型	説明
`id`	string	マウント解除した Memory Store の ID。
`type`	string	常に `memory_store_binding_deleted`。Store 削除時の `memory_store_deleted` と異なり、この API はマウントのみを解除し、Store 本体は残します。
`deleted`	boolean	マウントが解除されたかどうか。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	パスパラメータが無効です。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	Identity レベルの SAT が別の Identity を操作しようとしました。
404	`not_found_error`	Identity または Template が存在しないか、Store がこの `(identity, template)` にマウントされていません。
409	`conflict_error`	対象はシステム管理のデフォルト Store のためマウント解除できません。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​パスパラメータ

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー

パス

ヘッダー

パスパラメータ

リクエスト例

レスポンス例

レスポンスフィールド

エラー