跳转到主要内容

Vault 对象

创建、查询、列表和归档接口都会返回该结构。
字段类型说明
idstringVault ID,前缀为 vault_
typestring固定值 "vault"
display_namestringVault 展示名称,最长 255 字符
metadataobjectMetadata 对象
credentialsVault credential 数组创建响应中返回;普通创建请求为空数组
archived_atstring | null归档时间;active 时为 null
created_atstring创建时间
updated_atstring最后更新时间

Vault credential

创建 credential、列表 credential、归档 credential,以及创建 Vault 的嵌套响应会返回该结构。
字段类型说明
idstringCredential ID,前缀为 vcred_
typestring固定值 "vault_credential"
vault_idstring所属 Vault ID
authCredential auth object脱敏后的鉴权信息;不会返回密文
display_namenull当前固定为 null
metadataobject与 credential 一起存储的自定义元数据对象;省略时为 {}
archived_atstring | null归档时间;active 时为 null
created_atstring创建时间
updated_atstring最后更新时间
Credential 密文(包括 tokenaccess_tokenrefresh_tokenclient_secretsecret_value)只在创建请求中接收,永远不会在响应中返回。

创建 credential 请求

字段类型必填说明
authobject凭证鉴权信息
display_namestring兼容字段;当前响应固定为 null,不持久化
metadataobject与 credential 一起存储的自定义元数据对象;省略时为 {}

Credential auth object

static_bearer

字段类型必填说明
typestringstatic_bearer
mcp_server_urlstringMCP server URL,最长 2048 字符
tokenstring安全存储在 Vault 中的 Bearer token;不会返回
响应中的 auth 会省略 token

mcp_oauth

字段类型必填说明
typestringmcp_oauth
mcp_server_urlstringMCP server URL,最长 2048 字符
access_tokenstringOAuth access token;不会返回
expires_atstringAccess token 过期时间,RFC 3339 格式
refreshobject刷新配置。响应中会去除 refresh_tokenclient_secret

environment_variable

字段类型必填说明
typestringenvironment_variable
secret_namestring环境变量名,必须匹配 [A-Za-z_][A-Za-z0-9_]*
secret_valuestringSecret 值;不会返回
networkingobject兼容字段;当前不执行,响应中为空对象