翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# リモートディレクトリの内容を一覧表示する
<a name="sftp-connector-list-dir"></a>

リモート SFTP サーバーからファイルを取得する前に、リモート SFTP サーバー上のディレクトリのコンテンツを取得できます。これを行うには、 [https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html) API オペレーションを使用します。

次の の例では、コネクタの設定で指定されているリモート SFTP サーバーの `home`フォルダの内容を一覧表示します。結果は Amazon S3 の場所 に配置され`/amzn-s3-demo-bucket/connector-files`、 という名前のファイルに配置されます`c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json`。

```
aws transfer start-directory-listing  \
   --connector-id c-AAAA1111BBBB2222C  \ 
   --output-directory-path /amzn-s3-demo-bucket/example/connector-files  \
   --remote-directory-path /home
```

この AWS CLI コマンドは、リスト ID と結果を含むファイルの名前を返します。

```
{
    "ListingId": "6666abcd-11aa-22bb-cc33-0000aaaa3333",
    "OutputFileName": "c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json"
}
```

**注記**  
出力ファイルの命名規則は です`connector-ID-listing-ID.json`。

JSON ファイルには、次の情報が含まれています。
+ `filePath`: リモートサーバーの SFTP コネクタのリストリクエストのディレクトリに対するリモートファイルの完全なパス。
+ `modifiedTimestamp`: ファイルが最後に変更された時刻、秒単位、協定世界時 (UTC) 形式。このフィールドはオプションです。リモートファイル属性にタイムスタンプが含まれていない場合、ファイルリストから除外されます。
+ `size`: ファイルのサイズ、バイト単位。このフィールドはオプションです。リモートファイル属性にファイルサイズが含まれていない場合、ファイルリストから除外されます。
+ `path`: リモートサーバーの SFTP コネクタのリストリクエストのディレクトリに対するリモートディレクトリの完全なパス。
+ `truncated`: リスト出力にリモートディレクトリに含まれるすべての項目が含まれているかどうかを示すフラグ。`truncated` 出力値が true の場合、オプションの`max-items`入力属性で指定された値を増やして、より多くの項目を一覧表示できます (最大許容リストサイズは 10,000 項目まで）。

以下は、リモートディレクトリに 2 つのファイルと 2 つのサブディレクトリ (パス`c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json`) が含まれている出力ファイル () の内容の例です。

```
{
    "files": [
        {
            "filePath": "/home/what.txt",
            "modifiedTimestamp": "2024-01-30T20:34:54Z",
            "size" : 2323
        },
        {
            "filePath": "/home/how.pgp",
            "modifiedTimestamp": "2024-01-30T20:34:54Z",
            "size" : 4691
        }
    ],
    "paths": [
        {
            "path": "/home/magic"
        },
        {
            "path": "/home/aws"
        },
    ],
    "truncated": "false"
}
```