文档中心

TrafficRoute DNS 套件

跨账号共享资源

ListZonesByVPC - 获取 VPC 关联的列表

查询指定 VPC 已关联的私网域名列表。

该接口由 VPC 所属账号调用，用于查询指定 VPC 当前关联的所有私网域名，包括：

当前账号创建并关联到该 VPC 的私网域名；

其他账号通过跨账号关联授权后与该 VPC 建立关联的私网域名。

使用说明

请求频率：每秒最多调用 10 次。

请求说明

请求方式：GET

请求地址：https://private-zone.volcengineapi.com/?Action=ListZonesByVPC&Version=2022-06-01

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListZonesByVPC

要执行的操作，取值：ListZonesByVPC。

Version string 必选示例值：2022-06-01

API的版本，取值：2022-06-01。

VpcRegion string 必选示例值：cn-beijing

VPC 所在地域。

VpcID string 必选示例值：vpc-3reow**hxad79k

VPC 实例 ID。

PageNumber integer 可选示例值：1

页码。API 返回该页码所包含的私网域名信息。默认值为 1。

PageSize integer 可选示例值：10

每页包含的私网域名数量。系统会将查询结果进行分页显示，页数由域名总数和 PageSize 确定。默认值为 10，最大值为 500。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

PageNumber integer 示例值：1

当前页码。

PageSize integer 示例值：10

每页返回的私网域名数量。

Total integer 示例值：25

符合条件的私网域名总数。

BindZones object[] 示例值：[ { "ZID": 1013, "AccountID": "210000xxxx" } ]

与该 VPC 关联的私网域名列表。

ZID long 示例值：1013

私网域名的唯一 ID。

AccountID string 示例值：2100xxxxx

该私网域名所属账号 ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	ErrParamInvalid	validation fail: params:[%s] , value:[%v]	参数校验失败
400	ErrParsingParams	parsing params error	解析请求失败。
500	ErrInternalServer	server internal error	服务内部错误

最近更新时间：2026.03.09 20:48:37

这个页面对您有帮助吗？

有用

无用