更新凭证提供方
更新时间：2026-07-14
更新凭证提供方
- 更新凭证提供方的描述或凭证内容。desc 和 credential 至少提供一个，名称和类型不可修改。后端调用 KMS UpdateSecret 更新凭证值。OAUTH2 更新时 clientId 必填，clientSecret 仅在传入非空值时更新。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/agent-identity/credential-provider/update HTTP/1.1
2Host: identity.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| credentialProviderId | String | 是 | RequestBody参数 | 凭证提供方 ID |
| desc | String | 否 | RequestBody参数 | 新的描述，最多 128 字符 |
| credential | Object | 否 | RequestBody参数 | 新的凭证内容（与 desc 至少提供一个） |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 凭证提供方 ID |
| bceDomainId | String | BCE 账户 ID |
| bceUserId | String | BCE 用户 ID |
| name | String | 名称 |
| type | String | 凭证类型：API_KEY / OAUTH2 / STS |
| desc | String | 描述 |
| credential | CredentialConfig | 凭证配置内容（随 type 不同，见 CredentialConfig；敏感值为 KMS Secret ID，非明文） |
| createdAt | DateTime | 创建时间 |
| updatedAt | DateTime | 更新时间 |
请求示例
Plain Text
1{
2 "credentialProviderId": "cp-xxxxxxxxxx",
3 "desc": "更新后的描述",
4 "credential": {
5 "apiKey": "sk-new-xxxxxxxxxxxxxxxx"
6 }
7}返回示例
Plain Text
1{
2 "id": "cp-xxxxxxxxxx",
3 "bceDomainId": "d-xxxxxxxxxx",
4 "bceUserId": "u-xxxxxxxxxx",
5 "name": "openai-key",
6 "type": "API_KEY",
7 "desc": "更新后的描述",
8 "credential": {
9 "apiKey": "kms-secret-id-xxxxxxxxxx"
10 },
11 "createdAt": "2025-01-01T00:00:00Z",
12 "updatedAt": "2025-01-02T00:00:00Z"
13}评价此篇文章