分页查询网关实例列表 ListAIGatewayInstance--全站加速-火山引擎

文档中心

全站加速

AI 加速网关接口

分页查询网关实例列表 ListAIGatewayInstance

分页查询 AI 加速网关实例列表。支持按实例名称、ID、类型、域名状态等条件筛选和排序。

使用限制

节流限制：您每秒最多可以提交 20 个 API 请求。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=ListAIGatewayInstance&Version=2021-04-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `ListAIGatewayInstance`。
Version	String	是	接口版本。当前 API 的版本为 `2021-04-01`。

Body

参数名称	数据类型	是否必选	参数说明	示例
ID	String	否	AI 加速网关实例的唯一标识。可通过 `ListAIGatewayInstance` 接口获取。	`ga-123456789`
Name	String	否	实例名称。用作筛选条件，支持模糊查询。	`my-maas-gateway`
InstanceType	Integer	否	实例类型。取值： `0`：MaaS API 加速。	`0`
PageNumber	Integer	是	页码。从 1 开始，默认为 1。	`1`
PageSize	Integer	是	每页数量。最大值为 `100`。	`10`
CreatedAtOrder	String	否	按创建时间排序。取值： `ascending`：升序。 `descending`：降序。	`descending`
AccountID	String	是	火山引擎账号 ID。	`210000XXXX`

返回参数

参数名称	数据类型	参数说明	示例
Total	Integer	符合筛选条件的实例总数。	`25`
PageNumber	Integer	页码。从 1 开始，默认为 1。	`1`
PageSize	Integer	每页数量。	`10`
Infos	Object[]	实例信息列表。

请求示例

POST https://open.volcengineapi.com?Action=ListAIGatewayInstance&Version=2021-04-01
{
    "AccountID": "210000XXXX",
    "PageNumber": 1,
    "PageSize": 10
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ListAIGatewayInstance",
        "Version": "2021-04-01",
        "Service": "dcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "Infos": [
            {
                "APIKey": "n/a",
                "AccountID": "210000XXXX",
                "Advanced": {
                    "Acceleration": {
                        "Domain": "my-maas-gateway.aig.volcdngateway.com",
                        "Enabled": true,
                        "Modified": 1700000000,
                        "Scope": "domestic",
                        "Status": "",
                        "Error": ""
                    },
                    "Cache": {
                        "Config": {
                            "Mode": 0,
                            "TTL": 3600
                        },
                        "Enabled": true
                    },
                    "Limit": {
                        "Enabled": false
                    }
                },
                "CreatedAt": 1700000000,
                "Description": "生产环境文本生成网关",
                "ID": "ga-123456789",
                "InstanceType": 0,
                "MaasAPI": {
                    "Models": [
                        {
                            "APIKey": "n/a",
                            "BaseURL": "https://ark.cn-beijing.volces.com/api/v3",
                            "Category": "Text",
                            "ID": "ga-123456789",
                            "Model": "doubao-seed-2-0-mini-260215",
                            "Protocol": 1,
                            "Provider": "bytedance",
                            "Source": 0,
                            "Weight": 50
                        }
                    ],
                    "RoutePolicies": {
                        "Fallback": {
                            "Enabled": true
                        },
                        "LB": {
                            "Enabled": false
                        }
                    }
                },
                "Name": "my-maas-gateway",
                "Project": "default",
                "Tags": [
                    {
                        "Value": "production",
                        "Key": "env"
                    }
                ],
                "UpdatedAt": 1700003600
            }
        ],
        "PageNumber": 1,
        "PageSize": 10,
        "Total": 25
    }
}

最近更新时间：2026.06.11 21:20:01

这个页面对您有帮助吗？

有用

无用

全站加速

使用限制 #

请求说明 #

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #