Vault

创建 Vault

创建一个密钥库

POST

/api/v1/agentstudio/vaults

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/vaults' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "生产环境密钥箱",
  "metadata": {
    "environment": "production"
  }
}
'

{
  "id": "vlt_xxx",
  "type": "vault",
  "display_name": "生产环境密钥箱",
  "metadata": {
    "environment": "production"
  },
  "archived_at": null,
  "created_at": "2026-06-20T10:00:00Z",
  "updated_at": "2026-06-20T10:00:00Z"
}

鉴权

string

header

必填

DashScope API Key

请求体

application/json

string

必填

Vault 的可读名称，1-255 字符

object

业务自定义键值对元数据

响应

200-application/json

string

Vault ID，格式 vlt_xxx

string

固定为 vault

string

Vault 可读名称

object

业务自定义键值对

string | null

归档时间，未归档时为 null

string

创建时间，ISO 8601

string

最近更新时间，ISO 8601

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/vaults' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "生产环境密钥箱",
  "metadata": {
    "environment": "production"
  }
}
'

{
  "id": "vlt_xxx",
  "type": "vault",
  "display_name": "生产环境密钥箱",
  "metadata": {
    "environment": "production"
  },
  "archived_at": null,
  "created_at": "2026-06-20T10:00:00Z",
  "updated_at": "2026-06-20T10:00:00Z"
}