全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询特定目录的配额

最近更新时间:2025-09-23 19:00:26

1. 接口描述

本接口(DescribeDirQuota)用于查询文件系统特定目录的配额。

2. 请求方法

GET

3. 请求参数

请求参数包含公共请求参数和接口请求参数。其中,公共请求参数是每个接口都会用到的请求参数,具体参见公共参数及签名机制;接口请求参数是各个接口所特有的,具体参见下方说明:

  1. 请求头

名称

是否必须

Content-Type

application/json

Accept

application/json

  1. 请求体

名称

类型

是否必须

描述

FileSystemId

string

文件系统的实例ID

  • 性能Ⅰ型/性能Ⅱ型指定文件系统支持2种方式,建议择一使用:

    • 通过文件系统ID(FileSystemId)

    • 输入文件系统完整信息,文件系统信息,存储类型(StoreClass) + 存储池名称(ClusterName) + 文件系统名称(FileSystemName)同时必填。

  • 容量Ⅰ型/容量Ⅱ型/标准型支持2种方式,建议择一使用:

    • 通过文件系统ID(FileSystemId)

    • 输入文件系统完整信息,存储类型(StoreClass) + 文件系统名称(FileSystemName)同时必填。

StoreClass

string

存储类型,取值:

  • KPFS-capacity(容量Ⅰ型)

  • KPFS-capacity2(容量Ⅱ型)

  • KPFS-standard(标准型)

  • KPFS-P-S01(性能Ⅰ型)

  • KPFS-P-S02(性能Ⅱ型)

ClusterName

string

存储池名称,从控制台>文件系统详情>资源池获取。

FileSystemName

string

文件系统名称,名称最大长度63字节。

DirPath

string

目录完整路径,格式:dir/xxx或 /dir/xxx 或 dir/xxx/或/dir/×××/,匹配到 /dir/xxx/。

Action

string

该参数为公共参数,取值:DescribeDirQuota。

Version

string

该参数为公共参数,取值:2024-09-30。

4. 返回参数

名称

类型

描述

RequestId

string

唯一请求ID,每次请求都会返回。

LogicalHardThreshold

long

容量硬阈值,单位Byte。

LogicalUsedCapacity

long

已用容量,单位 Byte。

5. 示例

请求示例

http://kpfs.api.ksyun.com?FileSystemId=301c1d57a1b14aadbb34ffccbf25369e&Action=DescribeDirQuota&Version=2024-09-30

返回示例

{
 "RequestId": "ea82d72e-0169-4970-8beb-92d3a10964d7",
  "LogicalHardThreshold":102400,
  "LogicalUsedCapacity":10240
}

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈