汎用NASファイルシステムの指定されたディレクトリ内のサブディレクトリまたはファイルを照会します。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 ListDirectoriesAndFiles

実行する操作です。

値をListDirectoriesAndFilesに設定します。
FileSystemId String 必須 31a8e4 ****

ファイルシステムの ID。

パス String 必須 /pathway/to /フォルダ

ディレクトリの絶対パスを指定します。

The path must be prefixed by a forward slash (/). マウントターゲットに存在するパスである必要があります。

NextToken String 任意 TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=

現在のリクエストのレスポンスが切り捨てられた場合に、次のリクエストを開始するために使用されるトークン。 トークンを使用して別のリクエストを開始し、残りのコンテンツを取得できます。

StorageType String 必須 非頻繁なアクセス

ファイルのストレージタイプ。

デフォルト値: InfrequentAccess (IA) 。
DirectoryOnly Boolean 任意 false

ディレクトリのみを照会するかどうかを指定します。

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

  • false: ディレクトリとファイルの両方を照会します。
  • true: ディレクトリのみを照会します。
MaxResults Long 任意 100

各クエリの結果に含めるディレクトリまたはファイルの最大数。

有効な値: 10 ~ 128

デフォルト値: 100。

レスポンスパラメーター

パラメーター データ型 例 説明
NextToken String TGlzdFJlc291cmNlU **** mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=

現在のリクエストのレスポンスが切り捨てられた場合に、次のリクエストを開始するために使用されるトークン。 トークンを使用して別のリクエストを開始し、残りのレコードを取得できます。

RequestId String 2D69A58F-345C-4FDE-88E4-BF518948****

リクエストの ID です。

Entries エントリの配列

The array of information about the files or directories.

データ型 String File

クエリ結果のタイプ。

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

  • File
  • ディレクトリ
HasInfrequency AccessFile Boolean true

Indicates whether the files contain the data that is dumped to the IA storage medium.

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

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

  • true: The files contain data that is dumped to the IA storage medium.
  • false: The files do not contain data that is dumped to the IA storage medium.
Ctime String 2021-02-11T10:08:10Z

生データが変更された時刻。

時間はyyyy-MM-ddTHH:mm:ssZ形式のISO 8601標準に従います。

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

Mtime String 2021-02-11T10:08:08Z

ファイルが最後に変更された時刻。

The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.

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

Size Long 1024

The size of the files.

単位：バイト

The value of this parameter is returned and valid only if the value of the Type parameter is File.

StorageType String InfrequentAccess

ファイルのストレージタイプ。

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

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

  • 標準: 汎用NASファイルシステム
  • Infrequency Access: IAストレージメディア
アタイム String 2021-02-01T10:08:08Z

クエリの時間範囲。

The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.

The value of this parameter is returned and valid only if the value of the Type parameter is File.

パラメーター名 String file.txt

ファイルまたはディレクトリの名前。

RetrieveTime String 2021-02-11T10:08:08Z

The time when the last data retrieval job was run.

時間はyyyy-MM-ddTHH:mm:ssZ形式のISO 8601標準に従います。

The value of this parameter is returned and valid only if the value of the Type parameter is File.

Inode String Inode

ファイルまたはディレクトリのinode。

FileId String 04 *** 08

ディレクトリまたはファイルのID。

例

リクエストの例

http(s):// [エンドポイント]/?Action=ListDirectoriesAndFiles
&FileSystemId=31a8e4 ****
&パス=/pathway/to/folder
&StorageType=Infrequency Access
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<NextToken>aBcdeg ==</NextToken>
<RequestId>BC7C825C-5F65-4B56-BEF6-98C56C7C ****</RequestId>
<エントリ>
    <名前> test.txt</名前>
    <Type> ファイル </Type>
    <Inode>1000</Inode>
    <サイズ> 20</サイズ>
    <アタイム> 2019-10-30T10:08:08Z</アタイム>
    <Mtime>2019-10-30T10:08:08Z</Mtime>
    <CTime>2019-10-30T10:08:08Z</CTime>
    <RetrieveTime>2019-10-30T10:08:08Z</RetrieveTime>
    <StorageType> 非自動アクセス </StorageType>
</エントリ>
<エントリ>
    <Name>testDirectory</Name>
    <Type> ディレクトリ </Type>
    <Inode>1001</Inode>
    <HasInfrequency AccessFile>true</HasInfrequency AccessFile>
</エントリ>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "aBcdeg==" 、
  "RequestId" : "BC7C825C-5F65-4B56-BEF6-98C56C7C ****" 、
  "エントリ" : [ {
    "Name" : "test.txt",
    "タイプ" : "ファイル" 、
    "Inode" : 1000、
    「サイズ」: 20、
    "アタイム" : "2019-10-30T10:08:08Z" 、
    "Mtime" : "2019-10-30T10:08:08Z" 、
    "CTime" : "2019-10-30T10:08:08Z" 、
    "RetrieveTime" : "2019-10-30T10:08:08Z" 、
    "StorageType" : "Infrequency Access"
  }, {
    "Name" : "testDirectory" 、
    "Type" : "Directory",
    "Inode" : 1001,
    "HasInfrequentAccessFile" : true
  } ]
}

エラーコード

HttpCode エラーコード エラーメッセージ 必須／任意
400 OperationDenied.InvalidNextToken The specified NextToken is invalid. 指定されたNextTokenパラメーターが無効な場合に返されるエラーメッセージ。
404 InvalidFileSystem.NotFound 指定されたファイルシステムが存在しません。 指定されたファイルシステムが存在しない場合に返されるエラーメッセージ。
404 InvalidParameter.PathNotExist 指定されたパスは存在しません。 The error message returned because the specified URL does not exist.

エラーコードリストについては、「API エラーセンター」をご参照ください。