指定されたディレクトリからIAストレージメディアにダンプされたファイルの情報を照会します。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | GetDirectoryOrFileProperties |
実行する操作です。 値をGetDirectoryOrFilePropertiesに設定します。 |
FileSystemId | String | 必須 | 31a8e4 **** |
ファイルシステムの ID。 |
パス | String | 必須 | /pathway/to /フォルダ |
ディレクトリの絶対パスを指定します。 The path must be prefixed by a forward slash (/). マウントターゲットに存在するパスである必要があります。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
エントリ | オブジェクト |
The details about the files or directories. |
|
データ型 | String | File |
クエリ結果のタイプ。 設定可能な値は以下のとおりです。
|
HasInfrequentAccessFile | Boolean | true |
ファイルにIAストレージメディアにダンプされたデータが含まれているかどうかを示します。 このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。 設定可能な値は以下のとおりです。
|
MTime | String | 2021-02-11T10:08:08Z |
ファイルが最後に変更された日時。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。 |
ATime | String | 2021-02-01T10:08:08Z |
クエリの時間範囲。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。 |
Size | Long | 1024 |
ファイルのサイズ。 単位:バイト このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。 |
CTime | String | 2021-02-11T10:08:10Z |
生データが変更された時刻。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。 |
StorageType | String | 非頻繁なアクセス |
ファイルのストレージタイプ。 このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。 有効な値は
|
パラメーター名 | String | file.txt |
The name of the files or directory. |
RetrieveTime | String | 2021-02-11T10:08:08Z |
The time when the last data retrieval job was run. 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。 |
イノード | String | イノード |
ファイルまたはディレクトリのinode。 |
RequestId | String | 2D69A58F-345C-4FDE-88E4-BF518948 **** |
リクエストの ID です。 |
サンプル
リクエストの例
http(s)://[Endpoint]/?Action=GetDirectoryOrFileProperties
&FileSystemId=31a8e4 ****
&パス=/pathway/to/folder
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetDirectoryOrFilePropertiesResponse>
<エントリー>
<Type> ファイル </Type>
<HasInfrequency AccessFile>true</HasInfrequency AccessFile>
<MTime>2021-02-11T10:08:08Z</MTime>
<ATime>2021-02-01T10:08:08Z</ATime>
<サイズ> 1024</サイズ>
<CTime>2021-02-11T10:08:10Z</CTime>
<StorageType> 非自動アクセス </StorageType>
<Name>file.txt</Name>
<RetrieveTime>2021-02-11T10:08:08Z</RetrieveTime>
<イノード> イノード </イノード>
</Entry>
<RequestId>2D69A58F-345C-4FDE-88E4-BF518948 ****</RequestId>
</GetDirectoryOrFilePropertiesResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"エントリー" : {
"Type" : "File",
"HasInfrequency AccessFile" : true、
"MTime" : "2021-02-11T10:08:08Z" 、
"ATime" : "2021-02-01T10:08:08Z" 、
「サイズ」: 1024、
"CTime" : "2021-02-11T10:08:10Z" 、
"StorageType" : "Infrequency Access" 、
"Name" : "file.txt" 、
"RetrieveTime" : "2021-02-11T10:08:08Z" 、
"Inode" : "Inode"
},
"RequestId" : "2D69A58F-345C-4FDE-88E4-BF518948 ****"
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 必須/任意 |
---|---|---|---|
404 | InvalidFileSystem.NotFound | 指定されたファイルシステムが存在しません。 | The error message returned because the specified file system does not exist. |
404 | InvalidParameter.PathNotExist | 指定されたパスは存在しません。 | 指定されたURLは存在しません。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。