更新消费者
更新时间：2026-08-17
接口描述
更新指定消费者的描述、路由、标签、凭证或配额配置。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1PUT /v1/aigw/{instanceId}/consumer/{consumerId} HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string
5Content-Type: application/json请求头域
Plain Text
1必须传入 X-Region。请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | URL参数 | AI 网关实例 ID |
| consumerId | String | 是 | URL参数 | 消费者 ID 或名称 |
| keyType | String | 否 | Query参数 | id 或 name |
| description | String | 否 | RequestBody参数 | 描述 |
| routeNames | List |
否 | RequestBody参数 | 关联路由列表 |
| tags | List |
否 | RequestBody参数 | 标签列表 |
| credentialOp | CredentialOp | 否 | RequestBody参数 | add、delete 或 rotate |
| credentialLocation | ConsumerCredentialLocation | 否 | RequestBody参数 | 凭证位置 |
| iamCredential | IAMCredentialSpec | 否 | RequestBody参数 | IAM 凭证配置 |
返回状态码
成功返回 200；参数错误返回 400；消费者不存在返回 404。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功 |
| status | Integer | HTTP 状态码 |
| result | String | 成功时为空 |
请求示例
Plain Text
1PUT https://aigw.bj.baidubce.com/v1/aigw/aigw-example/consumer/consumer-id?keyType=id HTTP/1.1
2X-Region: bj
3Authorization: authorization string
4Content-Type: application/json
5
6{"description":"updated consumer"}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3
4{"success":true,"result":null,"status":200}评价此篇文章