AWS S3 Get Plugin (veraltet) für Jitterbit-Cloud und private Agentengruppen
Einführung
Das AWS S3 Get Plugin liest, benennt um oder löscht eine Datei aus Amazon AWS S3. Eine gelesene Datei kann als Quelle in einem Operation verwendet werden.
Dieses Plugin ist standardmäßig in Jitterbit-Cloud-Agent-Gruppen verfügbar und können auch mit privaten Agentengruppen verknüpft werden.
Auf dieser Seite werden die Schritte zur Verwendung des AWS S3 Get Plugin detailliert beschrieben:
- Laden Sie das Plugin herunter und fügen Sie es hinzu
- Verknüpfen Sie das Plugin mit einer Agentengruppe
- Das Plugin einer Quelle zuordnen
- Globale Variablen für das Plugin festlegen
- Operation abschließen
Wichtig
Von Jitterbit bereitgestellte Plugins sind veraltet.
Verschlüsselung
Das AWS S3 Get Plugin übergibt die von Ihnen bereitgestellte AWS S3-Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel (siehe unten Globale Variablen für das Plugin festlegen) an Amazon. Die Sicherheit wird von Amazon gemäß der Amazon-Dokumentation zu AWS-Sicherheitsanmeldeinformationen gehandhabt.
Verwendung
Das AWS S3 Get Plugin kann immer dann verwendet werden, wenn Sie Dateien von AWS abrufen, umbenennen oder löschen müssen.
Zusätzliche Funktionalität
Darüber hinaus bieten diese Optionen zusätzliche Funktionen, die über das AWS S3 Get Plugin hinausgehen:
-
AWS S3 erstellen: AWS S3 erstellen ist ein von Jitterbit bereitgestelltes Plugin, das zum Hochladen einer Datei auf Amazon AWS S3 als Ziel verwendet wird innerhalb einer Operation in Design Studio.
-
AWS REST API: Auf die AWS REST API kann über eine HTTP-Quelle zugegriffen werden oder HTTP-Ziel in Design Studio. Bei der Konfiguration kann es notwendig sein, den HMAC-SHA256-Generator zu verwenden Plugin, abhängig von Ihrer Authentifizierungsmethode. Wenn Sie Hilfe benötigen, kontaktieren Sie bitte den Support.
Laden Sie das Plugin herunter und fügen Sie es hinzu
Das AWS S3 Get Plugin ist ein Standard-Jitterbit Plugin, das bereits in der Management Console verfügbar ist Plugins Seite und muss nicht heruntergeladen oder zur Organisation hinzugefügt werden.
Vorsicht
Version 1.0.0.0 des Jitterbit AWS S3 Get Plugin ist nicht kompatibel mit Transport Layer Security (TLS) Version 1.3. So beheben Sie den Fehler Invalid SSL master secret
Verwenden Sie während der Plugin-Ausführung Version 1.0.1.0 des Jitterbit AWS S3 Get Plugin.
Verknüpfen Sie das Plugin mit einer Agentengruppe
Beide Versionen des AWS S3 Get Plugin sind standardmäßig mit Jitterbit-Cloud-Agent-Gruppen verknüpft. Wir empfehlen die Verwendung von Version 1.0.1.0.
Wenn Sie eine private Agentengruppe verwenden, müssen Sie das Plugin-In vor der Verwendung mit der privaten Agentengruppe verknüpfen, um das Plugin-In für alle Agenten in der Gruppe verfügbar zu machen.
Die Plugins sind in der Management Console Plugins aufgelistet Seite mit diesen Anzeigenamen:
-
Jitterbit AWS S3 Get (Version 1.0.1.0)
-
Jitterbit AWS S3 Get (Version 1.0.0.0)
Weisen Sie das Plugin einer Quelle zu
In einem Design Studio Projekt müssen Sie das Plugin einer Quelle zuweisen innerhalb einer Operation. Ein Beispiel für einen Operation finden Sie am Ende dieser Seite.
Im Rahmen des Projekts:
- Operation erstellen. Es kann jede Operation verwendet werden, die eine Quelle verwendet.
- Erstellen Sie eine Dummy-Quelle, der das Plugin zugewiesen wird. Diese Quelle wird als Platzhalter verwendet und wird nicht tatsächlich gelesen. Wir empfehlen die Verwendung einer globalen Variablenquelle. Wenn andere Dateitypquellen verwendet werden, wie z. B. Temporärer Speicher, lokale Datei oder FTP, wird während der Konfiguration der Quelle empfohlen, einen Get Files-Wert von
[file].[ext]
. - Weisen Sie das Plugin der Quelle zu. Klicken Sie dazu mit der rechten Maustaste auf die Quelle und wählen Sie Plugin. Wählen Sie im Popup unter Verfügbare Plugins „Jitterbit AWS S3 Get“ aus und klicken Sie auf Zuweisen. Klicken Sie anschließend auf OK.
Tipp
Eine detaillierte Dokumentation zum Zuweisen von Plugins finden Sie unter Pipeline-Plugins anwenden.
Festlegen globaler Variablen für das Plugin
Damit ein einer Quelle zugewiesenes Plugin funktioniert, müssen alle globalen Variablen müssen vom Plugin benötigt werden. Diese Variablen werden in einem Script gesetzt, welches in der Operation vor der Quelle platziert werden sollte, damit die Variablen initialisiert werden können.
So fügen Sie vor der Quelle ein Script hinzu:
-
Klicken Sie im Operation mit der rechten Maustaste auf die Quelle und wählen Sie Davor einfügen > Script.
-
Erstellen Sie ein neues Jitterbit Script, das Variablen festlegt, die das Plugin zur Authentifizierung bei Ihrem S3-Bucket und zum Lesen der von Ihnen angegebenen Datei verwendet. Unten finden Sie eine Script für erforderliche Variablen, gefolgt von einer Dokumentation aller möglichen Variablen, die im Script enthalten sein können.
AWS S3 Get Script<trans> $AWS.S3.BUCKET_NAME="<YOUR_BUCKET_NAME>"; $AWS.S3.ACCESS_KEY_ID="<YOUR_ACCESS_KEY>"; $AWS.S3.SECRET_ACCESS_KEY="<YOUR_SECRET_KEY>"; $AWS.S3.OBJECT_KEY="<myfile.txt>"; </trans>
Name | Typ | Erforderlich. | Beschreibung |
---|---|---|---|
AWS.S3.ENDPOINT | Zeichenfolge | Optional | Die URL des Amazon AWS S3- Endpoint. Standardmäßig "s3.amazonaws.com" wenn nicht festgelegt. Gültige Endpoint nach Region finden Sie in der Amazon-Dokumentation AWS-Regionen und Endpoints. |
AWS.S3.BUCKET_NAME | Zeichenfolge | Erforderlich | Der Name des S3-Quell-Buckets (z. B. "my_bucket" ). |
AWS.S3.ACCESS_KEY_ID | Zeichenfolge | Erforderlich | Der S3-Zugriffsschlüssel (z. B. "ABCDEFGHI1JK2LM3NOPQ" ). |
AWS.S3.SECRET_ACCESS_KEY | Zeichenfolge | Erforderlich | Der geheime S3-Zugriffsschlüssel (z. B. "1aBCd2e/F34gH56IJ7Kl/Mno8pqRsTUvw9x0yzzz" ). |
AWS.S3.REGION | Zeichenfolge | Optional | Die S3-Region. Standardmäßig "DEFAULT_REGION" wenn nicht festgelegt (nicht empfohlen). Aktuelle Regionsnamen finden Sie in der Amazon-Dokumentation AWS-Regionen und Endpoints. |
AWS.S3.OBJECT_KEY | Zeichenfolge | Erforderlich | Der zu lesende S3-Objektschlüssel. Dies ist der Name der spezifischen Datei, die zurückgegeben werden soll, z. B. "myfile.txt" . Um aus einem Ordner im Bucket zu lesen, fügen Sie den Ordnernamen nach einem Schrägstrich hinzu (z. B. "my_folder/myfile.txt" ). Die Datei muss bereits vorhanden sein. Beim Objektschlüssel wird die Groß- und Kleinschreibung beachtet. Die Angabe mehrerer Dateien oder die Verwendung von Platzhaltern wird nicht unterstützt. |
AWS.S3.DELETE | Boolesch | Optional | Wenn gesetzt auf "true" , löscht das Objekt nach dem Lesen aus dem S3-Bucket. Der Standardwert ist "false" . Nicht verwenden mit dem AWS.S3.NEWNAME variabel.Warnung Diese Variable löscht das angegebene Objekt im S3-Bucket selbst. |
AWS.S3.NEWNAME | Zeichenfolge | Optional | Der Name, der zum Umbenennen des Objekts im S3-Bucket nach dem Lesen verwendet wird. Die Verwendung dieser Variable ändert den S3-Objektschlüssel. Verwenden Sie nicht mit dem AWS.S3.DELETE variabel.Warnung Diese Variable löscht das angegebene Objekt im S3-Bucket selbst. |
Warnung
Obwohl im Plugin Manifest enthalten, ist die Variable AWS.S3.OBJECT_KEY_PREFIX
ist nicht funktionsfähig. Derzeit ist es nicht möglich, mehrere Dateien gleichzeitig zu lesen; es kann immer nur eine Datei gleichzeitig gelesen werden.
Vorsicht
Einige der oben genannten Variablen sollten nicht in Kombination mit anderen verwendet werden. Die gemeinsame Verwendung führt zu Fehlern bei Ihrem Operation.
Vollständige Operation
Der Plugin-Teil der Einrichtung der Operation ist abgeschlossen, wenn Sie (1) das Script haben, das die mit dem Plugin zu verwendenden Variablen definiert, und (2) das Plugin einer Quelle in der Operation zugewiesen haben.
Um die Einrichtung Ihres Operation abzuschließen, definieren Sie ein Ziel zum Archivieren Ihrer S3-Daten oder fügen Sie sowohl ein Ziel als auch eine Transformation hinzu, wenn Sie Ihre Daten vor Erreichen des Ziels transformieren möchten.
Achtung
Bei Verwendung eines Temporären Speichers, lokale Datei oder FTP Site Ziel, damit der S3-Dateiname und die Erweiterung in das Ziel geschrieben werden, wird empfohlen, [AWS.S3.OBJECT_KEY]
im Feld Dateiname(n), um im Ziel den gleichen Dateinamen zu verwenden, der vom Plugin gelesen wird. Mit einem Wert von [file].[ext]
gibt die S3-ID der Datei zurück, statt des S3-Dateinamens.