As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Listar o conteúdo de um diretório remoto
<a name="sftp-connector-list-dir"></a>

Antes de recuperar arquivos de um servidor SFTP remoto, você pode recuperar o conteúdo de um diretório no servidor SFTP remoto. Para fazer isso, você usa o [https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html)Operação da API.

O exemplo a seguir lista o conteúdo da `home` pasta no servidor SFTP remoto, que é especificado na configuração do conector. Os resultados são colocados no local `/amzn-s3-demo-bucket/connector-files` do Amazon S3 e em um arquivo chamado. `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
```

Esse AWS CLI comando retorna uma ID de listagem e o nome do arquivo que contém os resultados.

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

**nota**  
A convenção de nomenclatura para o arquivo de saída é`connector-ID-listing-ID.json`.

O arquivo JSON contém as seguintes informações:
+ `filePath`: o caminho completo de um arquivo remoto, relativo ao diretório da solicitação de listagem do seu conector SFTP no servidor remoto.
+ `modifiedTimestamp`: a última vez em que o arquivo foi modificado, em segundos, no formato UTC (Tempo Universal Coordenado). Esse campo é opcional. Se os atributos do arquivo remoto não contiverem um carimbo de data/hora, ele será omitido da lista de arquivos.
+ `size`: o tamanho do arquivo, em bytes. Esse campo é opcional. Se os atributos do arquivo remoto não contiverem um tamanho de arquivo, ele será omitido da lista de arquivos.
+ `path`: o caminho completo de um diretório remoto, relativo ao diretório da solicitação de listagem do seu conector SFTP no servidor remoto.
+ `truncated`: um sinalizador indicando se a saída da lista contém todos os itens contidos no diretório remoto ou não. Se o valor `truncated` de saída for verdadeiro, você poderá aumentar o valor fornecido no atributo `max-items` de entrada opcional para poder listar mais itens (até o tamanho máximo permitido da lista de 10.000 itens).

Veja a seguir um exemplo do conteúdo do arquivo de saída (`c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json`), em que o diretório remoto contém dois arquivos e dois subdiretórios (caminhos).

```
{
    "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"
}
```