查询网关实例详情
更新时间：2026-09-04
接口描述
根据网关实例 ID 查询实例详情，可通过 srcProduct 过滤来源产品视图。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1GET /v1/aigateway/{instanceId}?srcProduct={srcProduct} HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string请求头域
除公共头域外，还需传入以下头域：
| 请求头 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| X-Region | String | 是 | 地域代码，如 bj、gz、su、cd、yq、bd |
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | URL参数 | 网关实例 ID |
| srcProduct | String | 否 | Query参数 | 来源产品过滤条件 |
返回状态码
成功返回 200；参数缺失返回 400；实例不存在返回 404。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| instanceId | String | 网关实例 ID |
| name | String | 实例名称 |
| ingressStatus | String | 网关状态 |
| internalIP | String | 内网 IP |
| externalIP | String | 公网 IP |
| createTime | String | 创建时间 |
| region | String | 地域 |
| replicas | Integer | 副本数 |
| installMode | String | 部署模式 |
| vpcCidr | String | VPC CIDR |
| vpcId | String | VPC ID |
| subnetId | String | 子网 ID |
| gatewayType | String | 网关规格 |
| publicAccessible | Boolean | 是否公网可访问 |
| deleteProtection | Boolean | 是否开启删除保护 |
| description | String | 实例描述 |
| namespace | String | 网关命名空间 |
| enableIngress | Boolean | 是否开启 Ingress |
| enableAllIngressClasses | Boolean | 是否监听全部 IngressClass |
| enableAllNamespaces | Boolean | 是否监听全部命名空间 |
| ingressClasses | List |
IngressClass 列表 |
| watchNamespaces | List |
监听命名空间列表 |
| baEndpoint | VpcEndpoint | VPC Endpoint 信息 |
| associatedCluster | String | 关联集群 |
| srcProduct | String | 来源产品 |
| blbLongId | String | BLB 长 ID |
| wafId | String | WAF ID |
| wafEnable | Boolean | WAF 是否开启 |
| privateDomainName | String | 默认私网域名 |
| publicDomainName | String | 默认公网域名 |
| networkType | String | 网络类型 |
| domainStatus | String | 域名状态 |
| securityGroupId | String | 安全组 ID |
| tags | List |
实例标签 |
| version | String | Higress 版本 |
| aihcArgs | AihcArgs | AIHC 网络参数 |
请求示例
Plain Text
1GET /v1/aigateway/aigw-example HTTP/1.1
2Host: aigw.bj.baidubce.com
3X-Region: bj
4Authorization: authorization string返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3
4{
5 "instanceId": "aigw-example",
6 "name": "aigw-demo",
7 "ingressStatus": "running",
8 "internalIP": "10.0.0.10",
9 "region": "bj",
10 "replicas": 2,
11 "gatewayType": "small",
12 "publicAccessible": false,
13 "deleteProtection": true,
14 "namespace": "istio-system-aigw-example"
15}评价此篇文章