Inhalt eines Remote-Verzeichnisses auflisten

Bevor Sie Dateien von einem Remote-SFTP-Server abrufen, können Sie den Inhalt eines Verzeichnisses auf dem Remote-SFTP-Server abrufen. Dazu verwenden Sie den StartDirectoryListingAPI-Aufruf.

Das folgende Beispiel listet den Inhalt des home Ordners auf dem Remote-SFTP-Server auf, der in der Konfiguration des Connectors angegeben ist. Die Ergebnisse werden am Amazon S3 S3-Speicherort /DOC-EXAMPLE-BUCKET/connector-files und in einer Datei mit dem Namen abgelegtc-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json.

aws transfer start-directory-listing  \
   --connector-id c-AAAA1111BBBB2222C  \ 
   --output-directory-path /DOC-EXAMPLE-BUCKET/example/connector-files  \
   --remote-directory-path /home 

Dieser AWS CLI Befehl gibt eine Listing-ID und den Namen der Datei zurück, die die Ergebnisse enthält.

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

Anmerkung

Die Benennungskonvention für die Ausgabedatei lautetconnector-ID-listing-ID.json.

Die JSON-Datei enthält die folgenden Informationen:

• filePath: Der vollständige Pfad einer Remote-Datei, relativ zum Verzeichnis der Listing-Anfrage für Ihren SFTP-Connector auf dem Remoteserver.

• modifiedTimestamp: das letzte Mal, als die Datei geändert wurde, in Sekunden, UTC-Format (Coordinated Universal Time). Dies ist ein optionales Feld. Wenn die Attribute der Remote-Datei keinen Zeitstempel enthalten, wird dieser in der Dateiliste weggelassen.

• size: Die Größe der Datei in Byte. Dies ist ein optionales Feld. Wenn die Remote-Dateiattribute keine Dateigröße enthalten, wird sie in der Dateiliste weggelassen.

• path: der vollständige Pfad eines Remote-Verzeichnisses, relativ zum Verzeichnis der Listing-Anfrage für Ihren SFTP-Connector auf dem Remoteserver.

• truncated: ein Flag, das angibt, ob die Listenausgabe alle im Remote-Verzeichnis enthaltenen Elemente enthält oder nicht. Wenn Ihr truncated Ausgabewert wahr ist, können Sie den im optionalen max-items Eingabeattribut angegebenen Wert erhöhen, um mehr Elemente auflisten zu können (bis zur maximal zulässigen Listengröße von 10.000 Elementen).

Das Folgende ist ein Beispiel für den Inhalt der Ausgabedatei (c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json), wobei das Remote-Verzeichnis zwei Dateien und zwei Unterverzeichnisse (Pfade) enthält.

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