You need to enable JavaScript to run this app.
文档中心
私有网络

私有网络

复制全文
下载 pdf
前缀列表
DescribePrefixListAssociations - 查询前缀列表的关联关系
复制全文
下载 pdf
DescribePrefixListAssociations - 查询前缀列表的关联关系
调用 DescribePrefixListAssociations 接口,查询指定前缀列表关联的资源。​
使用说明​
  • 传入多个请求参数,按照传入的参数进行查询,返回符合所有条件的前缀列表,若没有符合条件的前缀列表,则返回空值。​
  • 若请求参数非必选参数均未传入,则按照当前登录账号查询,返回当前账号下的所有前缀列表。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:DescribePrefixListAssociations​
接口名称。当前 API 的名称为DescribePrefixListAssociations。​
​
Version String 必选 示例值:2020-04-01​
接口版本。当前 API 的版本为 2020-04-01。​
​
PrefixListId String 必选 示例值:pl-bp1fg655nh68xyz9****​
前缀列表的ID。​
您可以调用 DescribePrefixLists 接口,查询前缀列表的ID。​
​
ResourceType String 可选 示例值:VpcRouteTable​
关联资源类型,取值如下:​
  • VpcRouteTable:路由表。​
  • VpcSecurityGroup:安全组。​
  • TrRouteTable:转发路由器的路由表。​
  • TrRoutePolicyTable:转发路由器的路由策略表。​
​
PageNumber Integer 可选 示例值:1​
列表的页码。默认值为1。​
说明​
本参数即将下线,建议您使用NextToken和MaxResults进行分页查询。​
​
PageSize Integer 可选 示例值:20​
分页查询时每页的行数。最大值为100,默认值为20。​
说明​
本参数即将下线,建议您使用NextToken和MaxResults进行分页查询。​
​
NextToken String 可选 示例值:caeba0bbb2be03f84eb48b699f0a****​
分页查询凭证,用于标记分页的位置。​
  • 不填则从头开始查询。​
  • 传入之前调用本API返回的NextToken,则从该次API调用标记分页的位置往后开始查询。​
​
MaxResults Integer 可选 示例值:50​
查询的数量,默认为 10,最大为100。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId String 示例值:2021062415303301022514515207C4****​
请求ID。​
​
TotalCount Integer 示例值:2​
符合条件的前缀列表关联资源总数。​
说明​
本参数即将下线,使用NextToken和MaxResults分页查询时,此参数无意义。​
​
PageNumber Integer 示例值:1​
当前页码。​
说明​
本参数即将下线,建议您使用NextToken和MaxResults进行分页查询。​
​
PageSize Integer 示例值:10​
当前分页的行数。​
说明​
本参数即将下线,建议您使用NextToken和MaxResults进行分页查询。​
​
NextToken String 示例值:caeba0bbb2be03f84eb48b699f0a****​
本次API调用返回的查询凭证,标记分页的位置,用于下一次查询。返回为空表示没有下一页。​
​
PrefixListAssociations Object[] 示例值:-​
VPC前缀列表关联资源集合。​
ResourceId String 示例值:vtb-bp1drpcfz9srr393h****​
关联的资源ID。​
​
ResourceType String 示例值:VpcRouteTable​
关联的资源类型。​
​
​
​
​
请求示例​
​
GET /?Action=DescribePrefixListAssociations&Version=2020-04-01&PrefixListId=pl-0b78hw45f****&ResourceType=VpcRouteTable HTTP/1.1​
Host: vpc.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribePrefixListAssociations",​
"Version": "2020-04-01",​
"Service": "vpc",​
"Region": "cn-beijing"​
},​
"Result": {​
"NextToken": "caeba0bbb2be03f84eb48b699f0a****",​
"PageNumber": 1,​
"PageSize": 10,​
"PrefixListAssociations": [​
{​
"ResourceId": "vtb-bp1drpcfz9srr393h****",​
"ResourceType": "VpcRouteTable"​
}​
],​
"RequestId": "2021062415303301022514515207C4****",​
"TotalCount": 2​
}​
}​
​
错误码​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
400​
InvalidMaxResults.Malformed​
The specified parameter MaxResults is malformed.​
查询数量不合法。​
400​
InvalidNextToken.Malformed​
The specified parameter NextToken is invalid.​
查询 NextToken 不合法。​
400​
InvalidPage.Malformed​
The specified page is malformed.​
指定的分页参数不合法。​
400​
InvalidParameter.ResourceType​
The specified type of resource is not supported.​
指定的资源类型不支持。​
404​
InvalidPrefixList.NotFound​
The specified prefix list does not exist.​
指定的前缀列表不存在。​
​
​
最近更新时间:2026.10.19 10:20:11
这个页面对您有帮助吗?
有用
有用
无用
无用