调用 DescribePrefixListEntries 接口，查看指定前缀列表的前缀条目。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=DescribePrefixListEntries&serviceCode=vpc&version=2020-04-01&groupName=) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** String 必选 `示例值：DescribePrefixListEntries` 接口名称。当前 API 的名称为`DescribePrefixListEntries`。 **Version** String 必选 `示例值：2020-04-01` 接口版本。当前 API 的版本为 `2020-04-01`。 **PrefixListId** String 必选 `示例值：pl-bp1fg655nh68xyz9****` 前缀列表的ID。您可以调用 [DescribePrefixLists](https://www.volcengine.com/docs/6401/1124629) 接口，查询前缀列表的ID。 **PageNumber** Integer `可选` `示例值：1` 列表的页码。默认值为1。

说明

本参数即将下线，建议您使用NextToken和MaxResults进行分页查询。

**PageSize** Integer `可选` `示例值：20` 分页查询时每页的行数。最大值为100，默认值为20。

说明

本参数即将下线，建议您使用NextToken和MaxResults进行分页查询。

**NextToken** String `可选` `示例值：caeba0bbb2be03f84eb48b699f0a****` 分页查询凭证，用于标记分页的位置。 * 不填则从头开始查询。 * 传入之前调用本API返回的`NextToken`，则从该次API调用标记分页的位置往后开始查询。 **MaxResults** Integer `可选` `示例值：50` 查询的数量，默认为 10，最大为100。 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **RequestId** String `示例值：2021062415303301022514515207C4****` 请求ID。 **TotalCount** Integer `示例值：2` 符合条件的前缀列表条目总数。

说明

本参数即将下线，使用NextToken和MaxResults分页查询时，此参数无意义。

**PageNumber** Integer `示例值：1` 当前页码。

说明

本参数即将下线，建议您使用NextToken和MaxResults进行分页查询。

**PageSize** Integer `示例值：10` 当前分页的行数。

说明

本参数即将下线，建议您使用NextToken和MaxResults进行分页查询。

**NextToken** String `示例值：caeba0bbb2be03f84eb48b699f0a****` 本次API调用返回的查询凭证，标记分页的位置，用于下一次查询。返回为空表示没有下一页。 **PrefixListEntries** Object[] `示例值：-` 前缀条目的集合。 **Cidr** String `示例值：1.1.1.0/24` 前缀条目的CIDR。 **Description** String `示例值：TestDescription` 前缀条目的描述。 **PrefixListId** String `示例值：pl-bp1fg655nh68xyz9****` 前缀列表的ID。 ## 请求示例 ```json GET /?Action=DescribePrefixListEntries&Version=2020-04-01&PrefixListId=pl-bp1fg655nh68xyz9**** 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 ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "DescribePrefixListEntries", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "NextToken": "caeba0bbb2be03f84eb48b699f0a****", "PageNumber": 1, "PageSize": 10, "PrefixListEntries": [ { "Cidr": "1.1.1.0/24", "Description": "TestDescription", "PrefixListId": "pl-bp1fg655nh68xyz9****" } ], "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. |指定的分页参数不合法。 |

私有网络