Zum Inhalt springen

Amazon S3 List Objects-Aktivität in Jitterbit Studio

Einführung

Eine Amazon S3 List Objects-Aktivität verwendet ihre Amazon S3-Verbindung und gibt einige oder alle (bis zu 100.000) Objekte in einem Amazon S3-Bucket zurück. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Voraussetzungen

Die List Objects-Aktivität erfordert die folgenden Amazon S3-Berechtigungen:

Erforderliche Berechtigung Funktionalität
s3:ListAllMyBuckets Testen der [Verbindung] und Abrufen von Aktivitätsmetadaten während der Aktivitätskonfiguration
s3:GetObject, s3:GetObjectTagging und s3:ListBucket Ausführung der [List Objects-Aktivität]

Erstellen einer Amazon S3 List Objects-Aktivität

Eine Instanz einer Amazon S3 List Objects-Aktivität wird aus einer Amazon S3-Verbindung mit ihrem Aktivitätstyp List Objects erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Amazon S3 List Objects-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Amazon S3 List Objects-Aktivität

Führen Sie diese Schritte aus, um eine Amazon S3 List Objects-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Bucket auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie einen zu verwendenden Bucket aus.

Die in diesem Konfigurationsschritt einer Amazon S3 List Objects-Aktivität verwendete Benutzeroberfläche hängt von den ausgewählten Bucket-Optionen ab:

Bucket aus Liste auswählen

Wenn Bucket aus Liste auswählen für Bucket-Optionen ausgewählt ist, wird die unten beschriebene Benutzeroberfläche angezeigt.

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

  • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Amazon S3 List Objects-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Bucket auswählen: Wählen Sie aus der aufgefüllten Liste den Bucket aus, der die Objekte enthält.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern.

    • Objektpräfix: Geben Sie ein Präfix ein, um die Antwort auf Schlüssel zu beschränken, die mit dem angegebenen Präfix beginnen.

      • Genaue Übereinstimmung des Präfix aus Ergebnissen ausschließen: Wählen Sie diese Option, um genaue Übereinstimmungen für das in Objektpräfix angegebene Präfix auszuschließen.

    • Trennzeichen: Geben Sie ein Zeichen ein, das als Trennzeichen verwendet werden soll (maximal 1 Zeichen).

    • Max. Schlüssel: Geben Sie die maximale Anzahl der Schlüssel ein, die in der Antwort zurückgegeben werden sollen. Standardmäßig gibt die Aktivität bis zu 1.000 Schlüsselnamen zurück. Das Maximum beträgt 100.000 Schlüssel.

    • Nach folgendem starten: Geben Sie einen Schlüssel ein, um eine Antwort zurückzugeben, die nach dem angegebenen Schlüssel beginnt. Der Maximalwert beträgt 1.024 Zeichen.

    • AWS-Region (überschreibt die Region des Buckets): Wählen Sie eine Amazon S3-Region.

S3-Bucket manuell bereitstellen

Wenn S3-Bucket manuell bereitstellen für Bucket-Optionen ausgewählt ist, wird die nachfolgend beschriebene Benutzeroberfläche angezeigt.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Amazon S3 List Objects-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Bucket-Name: Geben Sie den Namen des Amazon S3-Buckets ein, der die Objekte enthält.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern.

    • Objektpräfix: Geben Sie ein Präfix ein, um die Antwort auf Schlüssel zu beschränken, die mit dem angegebenen Präfix beginnen.

      • Genaue Übereinstimmung des Präfix aus Ergebnissen ausschließen: Wählen Sie diese Option, um genaue Übereinstimmungen für das in Objektpräfix angegebene Präfix auszuschließen.

    • Trennzeichen: Geben Sie ein Zeichen ein, das als Trennzeichen verwendet werden soll (maximal 1 Zeichen).

    • Max. Schlüssel: Geben Sie die maximale Anzahl der Schlüssel ein, die in der Antwort zurückgegeben werden sollen. Standardmäßig gibt die Aktivität 1.000 Schlüssel zurück. Das Maximum beträgt 100.000 Schlüssel.

    • Nach folgendem starten: Geben Sie einen Schlüssel ein, um eine Antwort zurückzugeben, die nach dem angegebenen Schlüssel beginnt. Der Maximalwert beträgt 1.024 Zeichen.

    • AWS-Region (überschreibt die Region des Buckets): Wählen Sie eine Amazon S3-Region.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle aus dem Endpunkt generierten Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschemas: Die Request- und Response-Schemas für diese Aktivität werden angezeigt. Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Datenzuordnung erneut angezeigt.

    Der Amazon S3-Connector verwendet die Amazon Simple Storage Service API. Informationen zu den Schemaknoten und Feldern finden Sie in der Dokumentation zur ListObjects-Aktion.

    Das Response-Datenschema besteht aus diesen Knoten und Feldern:

    Response-Schemafeld Beschreibung
    keyCount Die Anzahl der zurückgegebenen Schlüssel
    List Die Liste der Schlüssel, Ergebnisse in UTF-8-Binärreihenfolge zurückgegeben
    key String mit dem Schlüssel des initiierten mehrteiligen Uploads
    size Größe
    ETag Das Entity Tag (ETag), das das neue Objekt identifiziert
    lastModified Datetime-Wert des Last-Modified-Headers, der das Datum und die Uhrzeit angibt, zu der Amazon S3 zuletzt eine Änderung am zugehörigen Objekt aufgezeichnet hat
    error Container für alle Fehlerelemente
    errorCode Eine Zeichenfolge, die eine Fehlerbedingung eindeutig identifiziert
    message Eine allgemeine Beschreibung der Fehlerbedingung

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Amazon S3-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Amazon S3-Aktivität List Objects schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Amazon S3-Aktivitäten List Objects können als Ziel mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.