查询资源池列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ehpc:ListPools |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Filter |
object |
否 |
查询资源池过滤条件。 |
|
| PoolName |
array |
否 |
查询资源池名称列表。 |
|
|
string |
否 |
资源池名称。
|
PoolTest |
|
| Status |
array |
否 |
查询资源池状态列表。 |
|
|
string |
否 |
资源池状态。取值范围：
|
Working |
|
| TimeCreatedBefore |
integer |
否 |
在此时间之前创建的节点池，以所在地域的时间转化为（国内站为东八区）Unix 时间戳。 |
1703820113 |
| TimeCreatedAfter |
integer |
否 |
在此时间之后创建的节点池，以所在地域的时间转化为（国内站为东八区）Unix 时间戳。 |
1703819914 |
| PageSize |
integer |
否 |
分页查询时每页的行数，最大值为 50，默认值为 10。 |
10 |
| PageNumber |
integer |
否 |
当前页码。默认值：1。 |
1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
896D338C-E4F4-41EC-A154-D605E5DE**** |
| PageSize |
integer |
分页查询时每页的行数，最大值为 50，默认值为 10。 |
10 |
| PageNumber |
integer |
当前页码。默认值：1。 |
1 |
| TotalCount |
integer |
列表条目总数。 |
2 |
| PoolList |
array<object> |
查询资源池列表。 |
|
|
object |
列表中单个资源池信息。 |
||
| PoolName |
string |
资源池名称。
|
PoolTest |
| Status |
string |
资源池状态。取值范围：
|
Working |
| Priority |
integer |
资源池的优先级。
|
1 |
| IsDefault |
boolean |
是否是默认资源池。取值说明：
|
true |
| MaxExecutorNum |
integer |
在一个资源池内正在运行的执行节点用量。 |
100 |
| SchedulingPolicyId |
string |
调度策略 ID。 |
policy-xxx |
| CreateTime |
string |
资源池创建时间。 |
2026-04-20 11:09:59 |
| UpdateTime |
string |
资源池更新时间。 |
2026-04-20 11:09:59 |
示例
正常返回示例
JSON格式
{
"RequestId": "896D338C-E4F4-41EC-A154-D605E5DE****",
"PageSize": 10,
"PageNumber": 1,
"TotalCount": 2,
"PoolList": [
{
"PoolName": "PoolTest",
"Status": "Working",
"Priority": 1,
"IsDefault": true,
"MaxExecutorNum": 100,
"SchedulingPolicyId": "policy-xxx",
"CreateTime": "2026-04-20 11:09:59",
"UpdateTime": "2026-04-20 11:09:59"
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParams | The specified parameter %s is invalid. | 无效的参数：%s |
| 400 | InDebt | Your account has overdue payments. | 您的账户已欠费 |
| 400 | NotEnabled | You have not enabled this service. | 您的账户还未开通此服务 |
| 403 | GetResourceFailed | Failed to get resource. | 获取资源失败 |
| 403 | RecommendEmpty.InstanceTypeSoldOut | The resource is out of stock. | 资源已售罄 |
| 404 | ImageNotFound | The specified image does not exist. | 指定的镜像不存在，请您检查该参数是否正确。 |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 请求失败，服务暂时不可用 |
| 406 | AliyunError | An Alibaba Cloud product error occurred. | 阿里云产品错误. %s |
| 406 | EcsError | An error occurred while calling the ECS API operation. | ECS API调用出错 |
| 406 | DbError | A database error occurred. | 数据库错误 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。