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
<a name="sftp-connector-list-dir"></a>

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 [https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html)Funzionamento 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"
}
```