Vault

更新 Vault

更新密钥库信息

POST

/api/v1/agentstudio/vaults/{vault_id}

cURL

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

{
  "id": "vlt_xxx",
  "type": "vault",
  "display_name": "生产环境密钥箱（已更名）",
  "metadata": {
    "environment": "production"
  },
  "archived_at": null,
  "created_at": "2026-06-20T10:00:00Z",
  "updated_at": "2026-07-01T14:30:00Z"
}

鉴权

string

header

必填

DashScope API Key

路径参数

string

必填

Vault ID，格式 vlt_xxx

请求体

application/json

string

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

object

补丁语义：键设为字符串则追加或覆盖，设为 null 则删除该键

响应

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/{vault_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "生产环境密钥箱（已更名）",
  "metadata": {
    "environment": "production",
    "deprecated_key": null
  }
}
'

{
  "id": "vlt_xxx",
  "type": "vault",
  "display_name": "生产环境密钥箱（已更名）",
  "metadata": {
    "environment": "production"
  },
  "archived_at": null,
  "created_at": "2026-06-20T10:00:00Z",
  "updated_at": "2026-07-01T14:30:00Z"
}