DescribeAiGateways

1. 接口描述

本接口 (DescribeAiGateways) 用于查询 AI 网关实例列表。

注意事项

• 本接口认证方式请参考认证方式

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数。

参数名称	必选	类型	描述
pageSize	否	Integer	每页返回的记录数，默认值为 20，最大不超过 200。
pageNum	否	Integer	分页页码，默认值为 1。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 requestId。
response	Object	业务响应数据。
response.totalCount	Integer	总记录数。
response.dataSet	Array of AiGatewayInfo	AI 网关实例列表。

4. 代码示例

示例

1. 分页查询 AI 网关列表。

POST / HTTP/1.1
Host: console.zenlayer.com/api/v2/aigw
Content-Type: application/json
X-TC-Action: DescribeAiGateways
<Common Request Params>

Request:
{
    "pageSize": 200,
    "pageNum": 1
}
Response:
{
    "requestId": "TCD1C4FC9-CF4B-4E48-AA9B-63FB4D7DC191",
    "response": {
        "requestId": "TCD1C4FC9-CF4B-4E48-AA9B-63FB4D7DC191",
        "totalCount": 2,
        "dataSet": [
            {
                "createdAt": "2025-12-04T08:39:13Z",
                "accessLimit": 0,
                "gatewayUuid": "1568676002379339603",
                "expireTime": "2025-12-11T07:14:55Z",
                "gatewayName": "AI-Gateway-01",
                "expireType": "CUSTOM",
                "resourceGroupId": "47e7f7e0-d7e9-4b28-b4b2-20da9439a294",
                "modelAccess": "UNLIMITED",
                "enabled": true,
                "updatedAt": "2025-12-24T07:30:35Z"
            },
            {
                "createdAt": "2025-12-24T05:45:53Z",
                "accessLimit": 0,
                "gatewayUuid": "1583084275941508435",
                "expireTime": null,
                "gatewayName": "AI-Gateway-02",
                "expireType": "LONG_LIVED",
                "resourceGroupId": "47e7f7e0-d7e9-4b28-b4b2-20da9439a294",
                "modelAccess": "UNLIMITED",
                "enabled": true,
                "updatedAt": "2025-12-24T07:30:43Z"
            }
        ]
    }
}

5. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码