全部文档
当前文档
最近更新时间：2025-12-16 17:00:56
本接口（DescribeDirQuota）用于查询账号下可用的存储集群信息。
GET
请求参数包含公共请求参数和接口请求参数。其中，公共请求参数是每个接口都会用到的请求参数，具体参见公共参数及签名机制；接口请求参数是各个接口所特有的，具体参见下方说明：
请求头
名称 | 是否必须 | 值 |
|---|---|---|
Content-Type | 是 | application/json |
Accept | 是 | application/json |
请求体
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
Region | string | 否 | 查询对应地域下支持的存储池类型，有效值：
|
AvailZone | string | 否 | 可用区，需与地域参数配合使用，有效值：
|
StoreClass | string | 否 | 文件系统存储类型，有效值：
|
SRoceCluster | string | 否 | 存储RoCE集群名称，仅性能Ⅰ型、性能Ⅱ型支持，若传入存储RoCE集群，则返回对应存储RoCE集群下的存储集群信息。 |
StorePoolType | string | 否 | 存储池类型。 |
Action | string | 是 | 该参数为公共参数，取值：DescribeClusterInfo。 |
Version | string | 是 | 该参数为公共参数，取值：2024-09-30。 |
名称 | 类型 | 描述 |
|---|---|---|
RequestId | string | 唯一请求ID，每次请求都会返回。 |
Data | object[] | 存储集群信息。 |
—Region | string | 地域。 |
—AvailZone | string | 可用区。 |
—StoreClasses | string[] | 存储类型。 |
—StorePoolType | string | 存储池类型。 |
—SRoceCluster | string | 存储RoCE集群名称，仅性能Ⅰ型、性能Ⅱ型支持。 |
—ClusterCode | string | 存储池Code，仅性能Ⅰ型、性能Ⅱ型支持，在通过创建文件系统OpenAPI创建性能Ⅰ型、性能Ⅱ型文件系统时需传入该字段。 |
请求示例
http://kpfs.api.ksyun.com?Region=cn-qingyangtest-1&SRoceCluster=QYYC01-Sroce-Cluster-01&StoreClass=KPFS-P-S01&StorePoolType=KPFS-P2返回示例
{
"RequestId": "d8659c83615c47cab734f95cdfcdc34f",
"Data": [
{
"Region": "cn-qingyangtest-1",
"AvailZone": "cn-qingyangtest-1a",
"StoreClasses": [
"KPFS-capacity2",
"KPFS-standard",
"KPFS-capacity"
],
"StorePoolType": "KPFS-C1",
"SRoceCluster": "",
"ClusterCode": ""
},
{
"Region": "cn-qingyangtest-1",
"AvailZone": "cn-qingyangtest-1a",
"StoreClasses": [
"KPFS-capacity2",
"KPFS-standard",
"KPFS-capacity"
],
"StorePoolType": "KPFS-C1",
"SRoceCluster": "",
"ClusterCode": ""
},
{
"Region": "cn-qingyangdev-2",
"AvailZone": "cn-qingyangdev-2a",
"StoreClasses": [
"KPFS-capacity2",
"KPFS-capacity"
],
"StorePoolType": "KPFS-C1",
"SRoceCluster": "",
"ClusterCode": ""
},
{
"Region": "cn-qingyangtest-1",
"AvailZone": "cn-qingyangtest-1a",
"StoreClasses": [
"KPFS-capacity2",
"KPFS-standard",
"KPFS-capacity"
],
"StorePoolType": "KPFS-C1",
"SRoceCluster": "",
"ClusterCode": ""
},
{
"Region": "cn-qingyangtest-1",
"AvailZone": "cn-qingyangtest-1a",
"StoreClasses": [
"KPFS-capacity2",
"KPFS-standard",
"KPFS-capacity"
],
"StorePoolType": "KPFS-C2",
"SRoceCluster": "",
"ClusterCode": ""
},
{
"Region": "cn-qingyangtest-1",
"AvailZone": "cn-qingyangtest-1a",
"StoreClasses": [
"KPFS-P-S02",
"KPFS-P-S01"
],
"StorePoolType": "KPFS-P1",
"SRoceCluster": "QYYC01-Sroce-Cluster-01",
"ClusterCode": "7c2cd53b-8eec-440d-a450-18b7db2b0040-1"
},
{
"Region": "cn-shanghai-3",
"AvailZone": "cn-shanghai-3a",
"StoreClasses": [
"KPFS-P-S02",
"KPFS-P-S01"
],
"StorePoolType": "KPFS-P1",
"SRoceCluster": "QYYC01-Sroce-Cluster-01",
"ClusterCode": "7c2cd53b-8eec-440d-a450-18b7db2b0040-3"
},
{
"Region": "cn-shanghai-3",
"AvailZone": "cn-shanghai-3b",
"StoreClasses": [
"KPFS-P-S02",
"KPFS-P-S01"
],
"StorePoolType": "KPFS-P1",
"SRoceCluster": "QYYC01-Sroce-Cluster-01",
"ClusterCode": "7c2cd53b-8eec-440d-a450-18b7db2b0040-4"
},
{
"Region": "cn-qingyangtest-1",
"AvailZone": "cn-qingyangtest-1a",
"StoreClasses": [
"KPFS-P-S02",
"KPFS-P-S01"
],
"StorePoolType": "KPFS-P2",
"SRoceCluster": "QHDX01-Sroce-Cluster-01",
"ClusterCode": "123e4567-e89b-12d3-a456-426614174123"
}
]
}纯净模式