调用DescribePrefixListAttributes查询指定前缀列表的详细信息,包含前缀列表的名称、地址族、最大条目容量以及条目的详细信息等。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribePrefixListAttributes |
系统规定参数。取值:DescribePrefixListAttributes。 |
RegionId | String | 是 | cn-chengdu |
地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
PrefixListId | String | 是 | pl-x1j1k5ykzqlixdcy**** |
前缀列表ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
CreationTime | String | 2021-02-20T07:11Z |
前缀列表的创建时间。 |
MaxEntries | Integer | 10 |
前缀列表支持的最大条目容量。 |
RequestId | String | 38793DB8-A4B2-4AEC-BFD3-111234E9188D |
请求ID。 |
Description | String | This is description. |
前缀列表的描述信息。 |
AddressFamily | String | IPv4 |
前缀列表的地址族。可能值:
|
PrefixListName | String | PrefixListNameSample |
前缀列表的名称。 |
PrefixListId | String | pl-x1j1k5ykzqlixdcy**** |
前缀列表ID。 |
Entries | Array of Entry |
前缀列表中的条目信息组成的数组。 |
|
Entry | |||
Description | String | Description Sample 01 |
前缀列表条目的描述信息。 |
Cidr | String | 192.168.1.0/24 |
前缀列表条目的CIDR地址块信息。 |
示例
请求示例
http(s)://ecs.aliyuncs.com/?Action=DescribePrefixListAttributes
&RegionId=cn-chengdu
&PrefixListId=pl-x1j1k5ykzqlixdcy****
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribePrefixListAttributesResponse>
<CreationTime>2021-02-20T07:11Z</CreationTime>
<MaxEntries>10</MaxEntries>
<RequestId>38793DB8-A4B2-4AEC-BFD3-111234E9188D</RequestId>
<Description>This is description.</Description>
<AddressFamily>IPv4</AddressFamily>
<PrefixListName>PrefixListNameSample</PrefixListName>
<PrefixListId>pl-x1j1k5ykzqlixdcy****</PrefixListId>
<Entries>
<Description>Description Sample 01</Description>
<Cidr>192.168.1.0/24</Cidr>
</Entries>
</DescribePrefixListAttributesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"CreationTime" : "2021-02-20T07:11Z",
"MaxEntries" : 10,
"RequestId" : "38793DB8-A4B2-4AEC-BFD3-111234E9188D",
"Description" : "This is description.",
"AddressFamily" : "IPv4",
"PrefixListName" : "PrefixListNameSample",
"PrefixListId" : "pl-x1j1k5ykzqlixdcy****",
"Entries" : [ {
"Description" : "Description Sample 01",
"Cidr" : "192.168.1.0/24"
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidPrefixListId.NotFound | The specified prefix list was not found. | 前缀列表不存在。 |
访问错误中心查看更多错误码。