Skip to main content
Vaults

Vault 数据结构

Vault 对象和凭据(credential)结构的完整定义。

Vault 对象

由创建、获取、列表和归档接口返回。
字段类型说明
idstringVault ID,前缀 vault_
typestring固定为 "vault"
display_namestringVault 显示名称,最多 255 个字符
statusstring可选值:activearchived
metadataobjectMetadata 对象
credentialsarray of Vault credential在同一请求中创建凭据时,创建响应中包含此字段
archived_atstring仅在已归档时返回
created_atstring创建时间
updated_atstring最后更新时间

Vault credential

由创建凭据、列表凭据、归档凭据以及嵌套在 Vault 创建响应中返回。
字段类型说明
idstring凭据 ID,前缀 vcred_
vault_idstring所属 Vault ID
mcp_server_urlstringMCP 服务器 URL,最多 2048 个字符
protocolstring支持的值:streamable_http
typestring支持的值:static_bearer
statusstring可选值:activearchived
archived_atstring仅在已归档时返回
created_atstring创建时间
updated_atstring最后更新时间
凭据的密钥信息(包括 access_token)仅在创建请求中接受,永远不会在响应中返回。

创建凭据请求

字段类型必填说明
mcp_server_urlstringMCP 服务器 URL,最多 2048 个字符
protocolstring使用 streamable_http
typestring使用 static_bearer
access_tokenstringBearer token,安全存储在 Vault 中