更新服务
更新时间：2026-09-04
接口描述
更新固定 IP、DNS_DOMAIN 或 AI_PROXY 类型服务的配置。路径参数在文档中命名为 serviceNamePath，实际请求值仍为当前服务名称；请求体字段 serviceName 保持不变。固定 IP/DNS_DOMAIN 支持修改服务名称、地址和协议；AI_PROXY 支持更新供应商端点、API Key、凭证来源及 Failover 配置。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1PUT /v1/aigw/{instanceId}/{serviceNamePath}/service HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string
5Content-Type: application/json请求头域
除公共头域外，还需传入以下头域：
| 请求头 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| X-Region | String | 是 | 地域代码，如 bj、gz、su、cd、yq、bd |
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | URL参数 | AI 网关实例 ID |
| serviceNamePath | String | 是 | URL参数 | 当前服务名称；路径变量，映射到后端 serviceName |
| serviceName | String | 否 | RequestBody参数 | 更新后的服务名称 |
| serviceAddresses | List |
否 | RequestBody参数 | 更新后的服务地址列表 |
| serviceProtocol | String | 否 | RequestBody参数 | HTTP、HTTPS 或 HTTP&HTTPS |
| provider | String | 否 | RequestBody参数 | AI_PROXY 模型供应商 |
| endpoint | String | 否 | RequestBody参数 | AI_PROXY 上游端点 |
| apiKeys | List |
否 | RequestBody参数 | AI_PROXY API Key 列表；IAM 模式禁止传入 |
| failoverEnabled | Boolean | 否 | RequestBody参数 | 是否启用 Failover |
| failoverModel | String | 否 | RequestBody参数 | Failover 健康检查模型 |
| credentialSource | String | 否 | RequestBody参数 | AI_PROXY 凭证来源：DEFAULT 或 IAM |
| credentialNames | List |
否 | RequestBody参数 | IAM CredentialProvider 名称列表 |
返回状态码
成功返回 200；参数错误返回 400；实例或服务不存在返回 404；服务类型不支持更新时返回 403。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否更新成功 |
| status | Integer | HTTP 状态码 |
| message | String | 操作结果描述 |
请求示例
Plain Text
1PUT /v1/aigw/aigw-example/qianfan-service/service HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string
5Content-Type: application/json
6
7{
8 "apiKeys": ["<QIANFAN_API_KEY>"]
9}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3
4{
5 "success": true,
6 "status": 200,
7 "message": "服务更新成功"
8}评价此篇文章