更新 Credential API：POST /vaults/{vault_id}/credentials/{credential_id}-大模型服务平台百炼(Model Studio)-阿里云帮助中心

更新指定 Credential 的属性。auth 中的 type 和 secret_name 不可修改。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

POST /vaults/{vault_id}/credentials/{credential_id}

路径参数

参数	必填	类型	说明
`vault_id`	是	string	Vault ID，格式 vlt_xxx
`credential_id`	是	string	Credential ID，格式 cred_xxx

请求体

字段	必填	类型	说明
`auth`	否	object	认证信息，固定为 environment_variable 类型。更新时 type 与 secret_name 不可修改，secret_value 留空表示不修改。
`display_name`	否	string	Credential 可读名称，最大 255 字符
`metadata`	否	object	业务自定义键值对元数据

请求示例

bash

curl -X POST "$AGENTSTUDIO_URL/vaults/vlt_xxx/credentials/cred_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "生产环境 API 密钥",
    "auth": {
      "type": "environment_variable",
      "secret_name": "API_KEY",
      "secret_value": "sk-new-value",
      "networking": {
        "allowed_hosts": [
          "api.example.com"
        ]
      },
      "injection_location": {
        "header": true
      }
    }
  }'

响应

{
  "id": "cred_xxx",
  "type": "credential",
  "vault_id": "vlt_xxx",
  "display_name": "生产环境 API 密钥",
  "auth": {
    "type": "environment_variable",
    "secret_name": "API_KEY",
    "networking": {
      "allowed_hosts": [
        "api.example.com"
      ]
    },
    "injection_location": {
      "header": true
    }
  },
  "metadata": {},
  "archived_at": null,
  "created_at": "2026-07-10T08:00:00Z",
  "updated_at": "2026-07-15T03:00:00Z",
  "request_id": "req_xxx"
}

响应字段

字段	类型	说明
`id`	string	Credential ID，格式 cred_xxx
`type`	string	固定为 credential
`vault_id`	string	所属 Vault ID
`display_name`	string	Credential 可读名称
`auth`	object	认证信息，敏感值已脱敏
`metadata`	object	业务自定义键值对
`archived_at`	string \| null	归档时间，未归档时为 null
`created_at`	string	创建时间，ISO 8601
`updated_at`	string	最近更新时间，ISO 8601
`request_id`	string	请求唯一标识

错误码

状态码	错误码	说明
400	`InvalidParameter`	Required parameter missing or invalid.
401	`InvalidApiKey`	Invalid API-key provided.