查询AIHC资源池列表
更新时间：2026-06-18
描述
如果用户需要将缓存节点部署在 AIHC 集群中，则需要购买 Master 托管部署模式的 RapidFS 实例，同时缓存接入类型选择 AIHC。
本接口用于按 VPC 查询可用的 AIHC 资源池列表，需要注意：
- 如果返回的 AIHC 资源池已绑定 RapidFS 实例，则无法使用该资源池 ID 购买 Master 托管部署模式的 RapidFS 实例；
- 响应中会根据资源池关联的子网自动聚合出可用区信息，调用方无需再次查询子网。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/aihcresourcepool?action=DescribeAihcResourcePools HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "vpcId": "vpc-abc123",
7 "maxKeys": 100,
8 "marker": ""
9}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| vpcId | String | 是 | RequestBody参数 | VPC ID，仅返回归属该 VPC 的资源池 |
| maxKeys | Int | 否 | RequestBody参数 | 返回列表长度，有效范围 [1, 1000]，默认 100 |
| marker | String | 否 | RequestBody参数 | 批量获取列表的查询的起始位置，取值为上一次返回的 nextMarker |
返回状态码
成功返回 200，失败见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| aihcResourcePoolInfos | List<AihcResourcePoolInfo> | 资源池信息列表，见数据类型说明 |
| marker | String | 当前查询起始位置 |
| isTruncated | Boolean | true 表示后面还有数据，false 表示已经是最后一页 |
| nextMarker | String | 下一页起始位置，为 null 表示后面没有数据了 |
| maxKeys | Int | 返回的列表元素个数 |
请求示例
Plain Text
1POST /v2/aihcresourcepool?action=DescribeAihcResourcePools HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "vpcId": "vpc-abc123"
6}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
4{
5 "marker": "",
6 "isTruncated": false,
7 "nextMarker": null,
8 "maxKeys": 100,
9 "aihcResourcePoolInfos": [
10 {
11 "resourcePoolId": "rp-xxx",
12 "name": "pool-a",
13 "type": "AIHC",
14 "zones": ["zoneA", "zoneB"],
15 "boundInstanceIds": ["rapidfs-xxx"]
16 }
17 ]
18}评价此篇文章