ListDataInsightDirectories - 获取数据洞察目录结构

更新时间:
复制 MD 格式

获取数据洞察目录结构。

接口说明

  • 当前邀测使用,如需使用请提交工单申请。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

nas:ListDataInsightDirectories

list

*FileSystem

acs:nas:{#regionId}:{#accountId}:filesystem/{#FileSystemId}

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

FileSystemId

string

文件系统 ID。

  • CPFS 智算版:必须以bmcpfs-开头,例如 bmcpfs-0015****。

说明

仅 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. 指定的文件系统不存在。

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

变更历史

更多信息,参考变更详情