You need to enable JavaScript to run this app.
文档中心
文件存储 vePFS

文件存储 vePFS

复制全文
下载 pdf
Fileset
DescribeFilesets - 查询 Fileset
复制全文
下载 pdf
DescribeFilesets - 查询 Fileset
调用 DescribeFilesets 接口,查询 Fileset 列表。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:DescribeFilesets​
要执行的操作,取值:DescribeFilesets。​
​
Version string 必选 示例值:2022-01-01​
API的版本,取值:2022-01-01。​
​
Filters object[] 可选 示例值:详情请参见返回示例。​
Fileset 查询过滤器。​
Key string 必选 示例值:FilesetName​
根据特性筛选指定特征的 Fileset。支持筛选的参数如下:​
  • FilesetName:按照 Fileset 名称筛选,模糊匹配。​
  • FilesetId:按照 Fileset ID 精确筛选。​
  • FilesetPath:按照文件系统中的路径筛选,模糊匹配。​
  • Status:按照 Fileset 状态筛选。​
​
Value string 必选 示例值:filset1​
筛选项目的值。​
​
​
OrderBy string 可选 示例值:CreateTimeDesc​
Fileset 列表排序方式,取值说明如下:​
  • CreateTimeDesc:按照 Fileset 的创建时间降序,默认排序方式。​
  • CreateTimeAsc:按照 Fileset 的创建时间升序。​
  • NameDesc:按照 Fileset 的名称降序。​
  • NameAsc:按 Fileset 的名称升序。​
​
PageSize integer 可选 示例值:10​
每个分页展示的 Fileset 记录数。取值为 1~100 的整数,默认取值为 10。​
​
PageNumber integer 可选 示例值:1​
Fileset 列表的页码,取值为不超过 Integer 数据类型的最大值,起始值为 1。​
​
FileSystemId string 必选 示例值:vepfs-cnbjbf3c46b6****​
文件系统 ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
TotalCount integer 示例值:2​
Fileset 个数。​
​
Filesets object[] 示例值:详情请参见返回示例。​
Fileset 详细信息。​
Status string 示例值:Running​
Fileset 状态,取值说明如下:​
  • Creating:创建中。​
  • CreateError:创建失败。​
  • Running:运行中。​
  • Updating:更新中。​
  • UpdateError:更新失败。​
  • Deleting:删除中。​
  • DeleteError:删除失败。​
  • Deleted:已删除。​
  • Error:错误。​
​
IOPSQos integer 示例值:0​
IOPS Qos。​
​
FileUsed long 示例值:3​
已用文件数量。​
​
FileLimit long 示例值:0​
文件或目录数量配额。返回 0 表示未设置文件或目录数量配额。​
​
FilesetId string 示例值:fset-5fa4****​
Fileset ID。​
​
CreateTime string 示例值:2023-08-17T14:49:37+08:00​
Fileset 创建时间。​
​
FilesetName string 示例值:fileset1​
Fileset 名称。​
​
FilesetPath string 示例值:/aaa​
Fileset 绝对路径。​
​
MaxInodeNum long 示例值:100000​
Fileset Inode 数量上限。​
​
BandwidthQos integer 示例值:0​
带宽 Qos。​
​
CapacityUsed integer 示例值:156​
已用容量,单位为 GiB。​
​
FileSystemId string 示例值:vepfs-cnbjbf3c46b6****​
文件系统 ID。​
​
CapacityLimit integer 示例值:500​
容量配额上限,单位为 GiB。​
​
​
PageSize integer 示例值:10​
每页记录数。取值为 1~100 间的整数,默认取值为 10。​
​
PageNumber integer 示例值:1​
Fileset 列表的页码,取值为不超过 Integer 数据类型的最大值,起始值为 1。​
​
​
​
请求示例​
​
POST /?Action=DescribeFilesets&Version=2022-01-01 HTTP/1.1​
Host: https://api.volcengine.com/api-explorer/?action=DescribeMountServices&groupName=%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F&serviceCode=vepfs&version=2022-01-01​
Content-Type: application/json; charset=UTF-8​
X-Date: 20250728T081644Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250728/cn-beijing/vepfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"Filters": [​
{​
"Key": "FilesetName",​
"Value": "filset1"​
}​
],​
"OrderBy": "CreateTimeDesc",​
"PageSize": 10,​
"PageNumber": 1,​
"FileSystemId": "vepfs-cnbjbf3c46b6****"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202507281616471930030752429D5A5D",​
"Action": "DescribeFilesets",​
"Version": "2022-01-01",​
"Service": "vepfs",​
"Region": "cn-beijing"​
},​
"Result": {​
"TotalCount": 2,​
"Filesets": [​
{​
"Status": "Running",​
"IOPSQos": 0,​
"FileUsed": 3,​
"FileLimit": 0,​
"FilesetId": "fset-5fa4****",​
"CreateTime": "2023-08-17T14:49:37+08:00",​
"FilesetName": "fileset1",​
"FilesetPath": "/aaa",​
"MaxInodeNum": 100000,​
"BandwidthQos": 0,​
"CapacityUsed": 156,​
"FileSystemId": "vepfs-cnbjbf3c46b6****",​
"CapacityLimit": 500​
}​
],​
"PageSize": 10,​
"PageNumber": 1​
}​
}​
​
错误码​
您可访问公共错误码,获取更多错误码信息。​
​
最近更新时间:2025.08.06 11:04:45
这个页面对您有帮助吗?
有用
有用
无用
无用