Forward Vaults API 接口说明。
描述
根据 Vault ID 获取单个 Vault。
路径
GET /api/v1/forward/vaults/{id}
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
id | string | 是 | Vault ID。 |
查询参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
identity_id | string | 否 | 仅在操作 Identity 归属资源时使用，非必填；PAT 场景可显式传入，未传时为管理员视角；SAT 场景请签发 Identity 维度凭证且不要显式携带该参数，否则返回 HTTP 400（详见 Identity 归属）。 |
示例请求
示例响应
HTTP 200 OK
响应字段
响应为 Vault 对象。
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | 请求体、路径参数或查询参数非法；或 SAT 携带了 identity_id。 |
| 401 | authentication_error | 缺少或无效的认证令牌。 |
| 403 | permission_error | 未指定 identity_id 的 PAT、Admin SAT 发生 Owner mismatch，或当前调用方存在其他权限不足。 |
| 404 | not_found_error | 资源不存在或不可见；或 identity_id 无效、已禁用、不属于当前调用方；或该资源不属于当前 Identity 归属。 |
| 500/502/503 | api_error | Forward 或依赖服务失败。 |