指定されたディレクトリからIAストレージメディアにダンプされたファイルの情報を照会します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 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

クエリ結果のタイプ。

設定可能な値は以下のとおりです。

  • File
  • ディレクトリ
HasInfrequentAccessFile Boolean true

ファイルにIAストレージメディアにダンプされたデータが含まれているかどうかを示します。

このパラメーターの値は、Typeパラメーターの値がFileの場合にのみ返されます。

設定可能な値は以下のとおりです。

  • true: The files contain data that is dumped to the IA storage medium.
  • false: ファイルには、IAストレージメディアにダンプされたデータが含まれていません。
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の場合にのみ返されます。

有効な値は

  • 標準: 汎用NASファイルシステム
  • Infrequency Access: IAストレージメディア
パラメーター名 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 エラーセンター」をご参照ください。