EBS レンズのディレクトリ構造を取得します。
操作説明
この特徴は現在、招待プレビュー中です。この特徴を使用するには、チケットを提出してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
nas:ListDataInsightDirectories |
list |
*FileSystem。
|
なし | なし |
リクエスト構文
GET HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemId |
string |
必須 |
ファイルシステムの ID。
説明
Lingjun 用 CPFS ファイルシステムのみがサポートされています。 |
bmcpfs-030wldnqm8evtpy**** |
| ParentDir |
string |
任意 |
親ディレクトリのパス。クエリ対象の親ディレクトリを指定します。デフォルト値: ルートディレクトリ "/"。 |
/ |
| NextToken |
string |
任意 |
ページネーショントークン。このパラメーターには、前の API 呼び出しで返された NextToken の値を設定します。最初のリクエストではこのパラメーターを空にします。デフォルト値: ""。 |
"" |
| MaxResults |
integer |
任意 |
返されるディレクトリの最大値。 有効な値: 10～100。 デフォルト値: 10。 |
10 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| 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 |
低頻度アクセス (IA) ファイルの数。 |
204800 |
| DirCapacity |
integer |
ディレクトリの容量。 |
10240 |
| DirCapacityOnline |
integer |
標準ファイルの容量。 |
10240 |
| DirCapacityOffline |
integer |
IA ファイルの容量。 |
10240 |
| SubDirectories |
array<object> |
サブディレクトリ情報。 |
|
|
object |
|||
| DirName |
string |
サブディレクトリ名。 |
/dir_l1_n000 |
| DirLevel |
integer |
サブディレクトリのレベル。 |
1 |
| FileCount |
integer |
サブディレクトリ内のファイルの数。 |
84846 |
| FileCountOnline |
integer |
サブディレクトリ内の標準ファイルの数。 |
84355 |
| FileCountOffline |
integer |
サブディレクトリ内の IA ファイルの数。 |
2343 |
| DirCapacity |
integer |
サブディレクトリの容量。 |
345518080 |
| DirCapacityOnline |
integer |
サブディレクトリ内の標準ファイルの容量。 |
345518080 |
| DirCapacityOffline |
integer |
サブディレクトリ内の IA ファイルの容量。 |
0 |
| CreatedAt |
string |
ディレクトリが作成された時間。時間は協定世界時 (UTC) の ISO 8601 標準に従います。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2026-07-23T12:47:14Z |
| UpdatedAt |
string |
ディレクトリに最後にアクセスした時間。時間は協定世界時 (UTC) の ISO 8601 標準に従います。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2026-07-29T03:41:12Z |
| LastAccessTime |
string |
データベースのディレクトリデータ Record が最後に更新された時間。時間は協定世界時 (UTC) の ISO 8601 標準に従います。フォーマット: yyyy-MM-ddTHH:mm:ssZ。 |
2026-07-29T03:41:12Z |
| Inode |
integer |
サブディレクトリの inode 番号。 |
140288 |
例
成功レスポンス
JSONJSON
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"NextToken": "/subDir",
"MaxResults": 10,
"FileSystemId": "bmcpfs-370lx1ev9ss27o0****",
"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 ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 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. | EBS レンズが有効化されていません。 |
| 400 | Feature.NotSupport | The feature is not supported. | この特徴はサポートされていません。 |
| 400 | DataInsight.NotSupported | Data insight is not supported on this file system. | EBS レンズはサポートされていません。 |
| 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. | 指定されたファイルシステムが存在しません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。