# 限制与错误 (/docs/cloud/services/vault/limits-and-errors)



按以下边界规划库与 Secret。

| 限制                           | 上限                   |
| ---------------------------- | -------------------- |
| 每库有效 Secret 数                | 50                   |
| Secret 值大小                   | 16384 bytes (16 KiB) |
| 每个 Secret 的允许域名数             | 16                   |
| 单次导入行数                       | 50                   |
| 授权创建 / OAuth 校验（每账户每分钟，各自计数） | 30 / 30              |
| 库名称长度                        | 255                  |
| metadata 键值对数                | 16                   |
| metadata 键 / 值长度             | 64 / 512             |
| 列表每页条数                       | 50 (最大 200)          |

同名 Secret 已存在返回 409 SECRET\_CONFLICT；往已归档的库写入返回 409 VAULT\_INVALID\_STATE；超过有效 Secret 上限返回 400 VAULT\_LIMIT\_EXCEEDED；值超过 16 KiB 返回 413 SECRET\_TOO\_LARGE。一键授权创建与 OAuth 校验各按账户独立计数，每个固定一分钟窗口各最多 30 次；超出返回 429 RATE\_LIMITED，等待下一窗口重试。授权链接过期返回 410 AUTHORIZATION\_EXPIRED，需要重新发起授权。

通过 Claude 托管智能体的凭据库接口访问时，每库最多 20 个有效凭据，错误使用该接口自己的错误格式。

[错误码与重试属性 →](/docs/api/native/vault/errors)