DescribePolarFsObjects - 查询目录项 - 云原生数据库 PolarDB

列出指定路径下的文件和子目录信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET / HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
PolarFsInstanceId	string	是	PolarFs 实例 ID	pfs-2ze0i74ka607*****
Path	string	是	目录绝对路径	/test

返回参数

名称	类型	描述	示例值
	object	查询成功
PolarFsInstanceId	string	PolarFs 实例 ID	pfs-2ze0i7*****
Items	array<object>	目录项列表
	object	目录项对象
Path	string	目录绝对路径	/test
Type	string	文件类型	directory
Capacity	string	容量	100
CreationTime	integer	创建时间	2025-03-25T09:37:10Z
Nlink	integer	链接数	test
Mode	string	文件系统权限	755
Owner	string	Owner	test
LastModified	integer	更新时间	2025-03-25T09:37:10Z
LinkTarget	string	符号连接的 realPath	test
TotalRecordCount	string	总记录数	50
Path	string	目录绝对路径	/test
PageSize	string	每页记录数，取值为 30、50 或 100。默认值为 30。	30
PageRecordCount	string	当前页可展示的最大记录数。	30
RequestId	string	请求 id。	CDB3258F-B5DE-43C4-8935-CBA0CA******

示例

正常返回示例

JSON格式

{
  "PolarFsInstanceId": "pfs-2ze0i7*****",
  "Items": [
    {
      "Path": "/test",
      "Type": "directory",
      "Capacity": "100",
      "CreationTime": 0,
      "Nlink": 0,
      "Mode": "755",
      "Owner": "test",
      "LastModified": 0,
      "LinkTarget": "test"
    }
  ],
  "TotalRecordCount": "50",
  "Path": "/test",
  "PageSize": "30",
  "PageRecordCount": "30",
  "RequestId": "CDB3258F-B5DE-43C4-8935-CBA0CA******"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。