ListDataInsightDirectories - 获取数据洞察目录结构
获取数据洞察目录结构。
接口说明
当前邀测使用,如需使用请提交工单申请。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
nas:ListDataInsightDirectories |
list |
*FileSystem
|
无 | 无 |
请求语法
GET HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| FileSystemId |
string |
是 |
文件系统 ID。
说明
仅 CPFS 智算版文件系统支持。 |
bmcpfs-030wldnqm8evtpy**** |
| ParentDir |
string |
否 |
父目录路径。指定要查询的父目录,默认为根目录"/"。 |
/ |
| NextToken |
string |
否 |
查询凭证,取值为上一次 API 调用返回的 NextToken 参数值。首次请求可不填,默认为 ""。 |
"" |
| MaxResults |
integer |
否 |
查询返回目录的最大个数。 取值范围:10~100。 默认值:10。 |
10 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| NextToken |
string |
本次调用返回的查询凭证值。 |
/subDir |
| MaxResults |
integer |
查询返回目录的最大个数。 |
10 |
| FileSystemId |
string |
文件系统 ID。 |
bmcpfs-370lx1ev9ss27o0**** |
| Directory |
object |
目录信息集合。 |
|
| Inode |
integer |
目录 Inode 号 |
2343 |
| FileCount |
integer |
文件数量。 |
2343232 |
| FileCountOnline |
integer |
标准文件数量 |
204800 |
| FileCountOffline |
integer |
低频文件数量。 |
204800 |
| DirCapacity |
integer |
目录容量。 |
10240 |
| DirCapacityOnline |
integer |
标准文件容量。 |
10240 |
| DirCapacityOffline |
integer |
低频文件容量。 |
10240 |
| SubDirectories |
array<object> |
子目录集合信息。 |
|
|
object |
|||
| DirName |
string |
子目录名。 |
/dir_l1_n000 |
| DirLevel |
integer |
子目录级别。 |
1 |
| FileCount |
integer |
子目录文件数量。 |
84846 |
| FileCountOnline |
integer |
子目录标准文件数量。 |
84355 |
| FileCountOffline |
integer |
子目录低频文件数量。 |
2343 |
| DirCapacity |
integer |
子目录目录容量。 |
345518080 |
| DirCapacityOnline |
integer |
子目录标准文件容量。 |
345518080 |
| DirCapacityOffline |
integer |
子目录低频文件容量。 |
0 |
| CreatedAt |
string |
目录创建时间。按照 ISO 8601 标准表示,并使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ。 |
2026-07-23T12:47:14Z |
| UpdatedAt |
string |
目录最近访问时间。按照 ISO 8601 标准表示,并使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ。 |
2026-07-29T03:41:12Z |
| LastAccessTime |
string |
数据库目录数据记录更新时间。按照 ISO 8601 标准表示,并使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ。 |
2026-07-29T03:41:12Z |
| Inode |
integer |
子目录 Inode 号 |
140288 |
示例
正常返回示例
JSON格式
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"NextToken": "/subDir",
"MaxResults": 10,
"FileSystemId": "bmcpfs-370lx1ev9ss27o0****\n",
"Directory": {
"Inode": 2343,
"FileCount": 2343232,
"FileCountOnline": 204800,
"FileCountOffline": 204800,
"DirCapacity": 10240,
"DirCapacityOnline": 10240,
"DirCapacityOffline": 10240,
"SubDirectories": [
{
"DirName": "/dir_l1_n000",
"DirLevel": 1,
"FileCount": 84846,
"FileCountOnline": 84355,
"FileCountOffline": 2343,
"DirCapacity": 345518080,
"DirCapacityOnline": 345518080,
"DirCapacityOffline": 0,
"CreatedAt": "2026-07-23T12:47:14Z",
"UpdatedAt": "2026-07-29T03:41:12Z",
"LastAccessTime": "2026-07-29T03:41:12Z",
"Inode": 140288
}
]
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | 参数非法。 |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | 未指定FileSystemId参数。 |
| 400 | InvalidFilesystemType.NotSupport | This Api does not support this fileSystem type. | 当前接口不支持该类型文件系统。 |
| 400 | FeatureOrAPI.NotSupported | The Feature/API is not supported in this region now. | 目前该地区不支持该功能或API。 |
| 400 | DataInsight.NotEnabled | Data insight is not enabled on this file system. | 数据洞察开关未打开。 |
| 400 | Feature.NotSupport | The feature is not supported. | 特性不支持。 |
| 400 | DataInsight.NotSupported | Data insight is not supported on this file system. | 数据洞察不支持。 |
| 400 | InvalidParameter.ParentDirPath | The specified ParentDirPath is invalid. | 指定的父目录路径参数无效。 |
| 403 | InvalidStatus.ResourceMismatch | Resource status mismatch. | 文件系统和UID不匹配。 |
| 403 | InvalidStatus | FileSystem status is invalid. | 文件系统状态不符合要求。 |
| 404 | InvalidFileSystem.NotFound | The specified filesystem does not exist. | 指定的文件系统不存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。