Elenca il contenuto di una directory remota - AWS Transfer Family

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Elenca il contenuto di una directory remota

Prima di recuperare i file da un server SFTP remoto, è possibile recuperare il contenuto di una directory sul server SFTP remoto. A tale scopo, si utilizza il StartDirectoryListingFunzionamento dell'API.

L'esempio seguente elenca il contenuto della home cartella sul server SFTP remoto, specificato nella configurazione del connettore. I risultati vengono inseriti nella posizione /amzn-s3-demo-bucket/connector-files Amazon S3 e in un file denominato. 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

Questo AWS CLI comando restituisce l'ID dell'elenco e il nome del file che contiene i risultati.

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

La convenzione di denominazione per il file di output èconnector-ID-listing-ID.json.

Il file JSON contiene le seguenti informazioni:

  • filePath: il percorso completo di un file remoto, relativo alla directory della richiesta di quotazione per il connettore SFTP sul server remoto.

  • modifiedTimestamp: l'ultima volta che il file è stato modificato, in secondi, in formato UTC (Coordinated Universal Time). Questo campo è facoltativo. Se gli attributi del file remoto non contengono un timestamp, questo viene omesso dall'elenco dei file.

  • size: la dimensione del file, in byte. Questo campo è facoltativo. Se gli attributi del file remoto non contengono una dimensione del file, questo viene omesso dall'elenco dei file.

  • path: il percorso completo di una directory remota, relativo alla directory della richiesta di elenco per il connettore SFTP sul server remoto.

  • truncated: un flag che indica se l'output della lista contiene o meno tutti gli elementi contenuti nella directory remota. Se il valore di truncated output è vero, puoi aumentare il valore fornito nell'attributo max-items input opzionale per poter elencare più elementi (fino alla dimensione massima consentita dell'elenco di 10.000 elementi).

Di seguito è riportato un esempio del contenuto del file di output (c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json), in cui la directory remota contiene due file e due sottodirectory (percorsi).

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