Listar o conteúdo de um diretório remoto - AWS Transfer Family

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

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 StartDirectoryListingOperaçã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"
}