取得資料洞察目錄結構。
介面說明
目前為邀測階段，如需使用請提交工單申請。
調試
您可以在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. | 指定的 Status 非法。 |
| 404 | InvalidFileSystem.NotFound | The specified filesystem does not exist. | 指定的檔案系統不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。