GET /v1/cache-operation-requests/{idempotency_key}
What the server did with a cache write sent with this Idempotency-Key
说明（契约原文）
For a write whose response was lost (network, timeout, 5xx): accepted with the operation (the new one of a create or re-submit), or rejected with the error code the write was refused with. 404 means the server has no record of the key for the authenticated actor: the write was not received and may be sent again with the same key and body. Another actor's key is the same 404 (existence is never disclosed). Not-found and permission refusals of the write itself are not kept and also read as 404. Writes nothing.
参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
idempotency_key | path | string | 是 | The Idempotency-Key the write was sent with (the batch key of a re-submit). |
action | query | string: create / retry / cancel / resubmit | 是 | — |
operation_id | query | string(uuid) | 否 | The operation a retry, cancel or re-submit acts on; required for those, absent for create. |
X-Request-ID | header | string | 是 | — |
响应
| 状态码 | 说明 |
|---|---|
200 | The write was decided. 字段： |
400 | Invalid or non-canonical request. |
401 | Authentication required. |
403 | Exact cache permission is absent or route audience is wrong. |
404 | Resource is absent or outside the effective tenant scope. |
408 | Request context was cancelled or exceeded its deadline. |
503 | A required store is unavailable; raw dependency errors are never returned. |
失败时怎么办
400按字段说明修正参数或请求体再发；不要原样重试。401检查凭据格式、是否过期或被轮换。403检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。404资源不存在或不属于当前租户。503依赖暂不可用：稍后用原 Idempotency-Key 重试。