创建网关实例
更新时间：2026-09-04
接口描述
创建 AI 网关实例，配置 VPC、子网、网关规格、部署模式、网络类型及可选的集群和监控参数。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v1/aigateway 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 |
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| name | String | 是 | RequestBody参数 | 网关实例名称 |
| vpcId | String | 是 | RequestBody参数 | VPC ID |
| vpcCidr | String | 是 | RequestBody参数 | VPC CIDR |
| subnetId | String | 是 | RequestBody参数 | 子网 ID |
| gatewayType | String | 是 | RequestBody参数 | 网关规格：small、medium、large |
| isInternal | String | 否 | RequestBody参数 | 是否使用内网模式 |
| networkTypes | List |
否 | RequestBody参数 | 网络类型：private、public，可多选 |
| replicas | Integer | 否 | RequestBody参数 | 副本数，默认共享模式 2、独占模式 3 |
| installMode | String | 否 | RequestBody参数 | 部署模式：shared 或 exclusive，默认 shared |
| description | String | 否 | RequestBody参数 | 实例描述 |
| deleteProtection | Boolean | 否 | RequestBody参数 | 删除保护，默认 true |
| srcProduct | String | 否 | RequestBody参数 | 来源产品；不同来源有额外必填字段 |
| accountId | String | 否 | RequestBody参数 | AgentOS 来源时必填的账号 ID |
| workspaceId | String | 否 | RequestBody参数 | AgentOS 工作空间 ID |
| workspaceName | String | 否 | RequestBody参数 | AgentOS 工作空间名称 |
| blbId | String | 否 | RequestBody参数 | CFC 来源时必填的 BLB 长 ID |
| blbIp | String | 否 | RequestBody参数 | BLB IP |
| clusters | List |
否 | RequestBody参数 | 关联 CCE 集群列表 |
| cpromInstanceId | String | 否 | RequestBody参数 | CProm 实例 ID，用于开启业务指标监控 |
| cpromBearerToken | String | 否 | RequestBody参数 | CProm 访问 Token |
| blsEnabled | Boolean | 否 | RequestBody参数 | 是否开启 BLS 日志 |
| logStoreName | String | 否 | RequestBody参数 | BLS 日志仓库名称 |
| version | String | 否 | RequestBody参数 | Higress 版本，不传时使用默认版本 |
| tags | List |
否 | RequestBody参数 | 实例标签列表 |
| resourceGroupId | String | 否 | RequestBody参数 | 资源分组 ID |
| aihcArgs | AihcArgs | 否 | RequestBody参数 | aihc-pom 来源的 AIHC 网络参数 |
返回状态码
成功返回 200；参数错误返回 400；配额不足或资源创建失败返回对应错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| instanceId | String | 新创建的网关实例 ID |
| requestId | String | 请求 ID |
| taskId | String | 异步创建任务 ID |
| securityGroupId | String | 创建或复用的安全组 ID |
请求示例
Plain Text
1POST /v1/aigateway HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string
5Content-Type: application/json
6
7{
8 "name": "aigw-demo",
9 "vpcId": "vpc-example",
10 "vpcCidr": "192.168.0.0/16",
11 "subnetId": "subnet-example",
12 "gatewayType": "small",
13 "installMode": "shared",
14 "networkTypes": ["private"],
15 "replicas": 2,
16 "description": "测试网关实例"
17}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3
4{
5 "instanceId": "aigw-example",
6 "requestId": "req-202609030001",
7 "taskId": "task-202609030001",
8 "securityGroupId": "sg-example"
9}评价此篇文章