文档中心

TrafficRoute DNS 套件

跨账号共享资源

ListResourceAssociationAuthorizations - 获取资源共享授权列表

查询指定私网域名的 VPC 跨账号关联授权列表及其绑定状态。

该接口由私网域名所属账号调用，用于查询当前账号创建的私网域名的跨账号关联授权信息，包括被授权的 VPC 信息及其与私网域名的绑定状态。

使用说明

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

请求说明

请求方式：GET

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

请求参数

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

Action string 必选示例值：ListResourceAssociationAuthorizations

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

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

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

ZID long 可选示例值：1013

标识域名的唯一 ID。您可以通过以下 API 获取：

添加域名 API

获取域名列表 API

PageNumber integer 可选示例值：1

页码。API 返回该页码所包含的授权信息。默认值为 1。

PageSize integer 可选示例值：10

每页包含的授权信息数量。系统会将获取的授权信息进行分页显示，页数由授权信息总数和 PageSize 确定。默认值为 10，最大值为 500。

返回参数

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

PageNumber integer 示例值：1

当前页码。

PageSize integer 示例值：10

每页返回的授权信息数量。

Total integer 示例值：100

符合条件的授权信息总数。

AuthorizationInfos object[] 示例值：[ { "ZID": 1013, "VpcID": "vpc-3reow**hxad79k", "VpcRegion": "cn-beijing", "Status": "Unbind" } ]

跨账号关联授权信息列表。

ZID long 示例值：1013

私网域名的唯一 ID。

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

已被授权关联该私网域名的 VPC ID。

VpcRegion string 示例值：cn-beijing

VPC 所在地域。

Status string 示例值：Binding

VPC 与私网域名的绑定状态。

取值说明：

Unbind：表示 VPC 尚未与私网域名建立关联。

Binding：表示 VPC 已与私网域名建立关联。

请求示例

返回示例

错误码

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

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

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

这个页面对您有帮助吗？

有用

无用