Amazon S3

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keine der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Operations-Liste aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabeparameter. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Aktionen

In diesem Abschnitt werden einige der vom Connector unterstützten Aktionen aufgeführt. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

CopyObject-Aktion

Mit dieser Aktion können Sie ein Objekt von einem Bucket in einen anderen oder innerhalb desselben Buckets kopieren.

Eingabeparameter der CopyObject-Aktion

Ausgabeparameter der CopyObject-Aktion

Bei erfolgreichem Kopieren wird der Status „200 (OK)“ zurückgegeben.

Informationen zum Konfigurieren der Aktion CopyObject finden Sie unter Beispiele für Aktionen.

DownloadObjects-Aktion

Mit dieser Aktion werden ein oder mehrere Objekte aus einem Bucket abgerufen.

Eingabeparameter der Aktion „DownloadObjects“

Ausgabeparameter der Aktion „DownloadObjects“

Bei einem erfolgreichen Download wird der Status 200 (OK) zurückgegeben.

Informationen zum Konfigurieren der Aktion DownloadObjects finden Sie unter Beispiele für Aktionen.

UploadObject-Aktion

Mit dieser Aktion können Sie ein Objekt in einen Bucket hochladen.

Eingabeparameter der UploadObject-Aktion

Ausgabeparameter der Aktion „UploadObject“

Diese Aktion gibt den Status 200 (OK) zurück, wenn der Objekt-Upload erfolgreich war.

Informationen zum Konfigurieren der Aktion UploadObject finden Sie unter Beispiele für Aktionen.

DeleteObject-Aktion

Mit dieser Aktion können Sie ein Objekt aus einem Bucket löschen.

Eingabeparameter der DeleteObject-Aktion

Ausgabeparameter der DeleteObject-Aktion

Bei erfolgreichem Löschen wird der Status 200 (OK) zurückgegeben.

Informationen zum Konfigurieren der DeleteObject-Aktion finden Sie unter Beispiele für Aktionen.

MoveObject-Aktion

Mit dieser Aktion können Nutzer ein vorhandenes Objekt eines bestimmten Buckets in einen anderen oder in denselben Bucket verschieben.

Eingabeparameter der MoveObject-Aktion

Ausgabeparameter der MoveObject-Aktion

Bei erfolgreicher Verschiebung wird der Status 200 (OK) zurückgegeben.

Informationen zum Konfigurieren der MoveObject-Aktion finden Sie unter Beispiele für Aktionen.

PutBucketAcl-Aktion

Mit dieser Aktion können Sie die Access Control List (ACL) eines Buckets aktualisieren.

Eingabeparameter der PutBucketAcl-Aktion

Ausgabeparameter der Aktion „PutBucketAcl“

Diese Aktion gibt den Status 200 (OK) zurück, wenn die Aktualisierung der Bucket-ACL erfolgreich war.

Informationen zum Konfigurieren der PutBucketAcl-Aktion finden Sie unter Beispiele für Aktionen.

PutObjectAcl-Aktion

Mit dieser Aktion können Sie die Access Control List (ACL) eines Objekts in einem Bucket aktualisieren.

Eingabeparameter der PutObjectAcl-Aktion

Ausgabeparameter der PutObjectAcl-Aktion

Diese Aktion gibt den Status 200 (OK) zurück, wenn die Aktualisierung der Objekt-ACL erfolgreich war.

Informationen zum Konfigurieren der PutObjectAcl-Aktion finden Sie unter Beispiele für Aktionen.

Beispiele für Aktionen

In diesem Abschnitt wird beschrieben, wie Sie einige der Aktionen in diesem Connector ausführen.

Beispiel – Objekt kopieren

In diesem Beispiel wird ein Objekt von einem Bucket in einen anderen kopiert.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion CopyObject aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "BucketSource": "aws-s3-bucket-source",
   "ObjectSource": "pic.jpg",
   "BucketDestination": "aws-s3-bucket-destination",
   "ObjectDestination": "new_pic.jpg"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CopyObject-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Status": "Success"
}]

Beispiel – Objekt herunterladen

In diesem Beispiel wird ein Objekt aus dem angegebenen Bucket heruntergeladen.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion DownloadObjects aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "Bucket": "aws-s3-bucket-source",
   "HasBytes": true
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadObjects-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Success": "True",
"RemoteFile": "prefix1%2Faws-s3-bucket-source%2Finventory-test-1%2F2023-09-10T01-00Z%2Fmanifest.json",
"ContentBytes": "ewogICJzb3VyY2VCdWNrZXQiIDogImF3cy1zMy1idWNrZXQtYmNvbmUiLAogICJnOK"
},
{
"Success": "True",
"RemoteFile": "upload1.txt",
"ContentBytes": "VGhpcyBpcyBhIHRlc3RpbmcgZmlsZQ=="
}]

Beispiel: Objekt hochladen

In diesem Beispiel wird ein Objekt in den angegebenen Bucket hochgeladen.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UploadObject aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "Bucket": "aws-s3-bucket-source",
   "FileName": "upload_1.txt",
   "Content": "This is a testing file",
   "AccessPolicy": "PUBLIC"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UploadObject-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Status": "success",
"bucket": "aws-s3-bucket-source",
"rss:title": "Object 'upload_1.txt' was created in the bucket: aws-s3-bucket-source",
"object": "upload_1.txt"
}]

Beispiel – Objekt löschen

In diesem Beispiel wird ein Objekt aus dem angegebenen Bucket gelöscht.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion DeleteObject aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "Bucket": "aws-s3-bucket-source",
   "Object": "abc.png"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeleteObject-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Status": "Success"
}]

Beispiel – Objekt verschieben

In diesem Beispiel wird ein Objekt von einem Bucket in einen anderen verschoben.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion MoveObject aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "BucketSource": "aws-s3-bucket-source",
   "ObjectSource": "abc.png",
   "BucketDestination": "aws-s3-bucket-destination",
   "ObjectDestination": "moved.png"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des MoveObject-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Status": "Success"
}]

Beispiel: ACL eines Buckets aktualisieren

In diesem Beispiel werden die Zugriffssteuerungsberechtigungen für einen Bucket aktualisiert.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion PutBucketAcl aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "BucketSource": "aws-s3-bucket-source",
   "ACL": "public-read"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des PutBucketAcl-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Status": "Success"
}]

Beispiel: ACL eines Objekts aktualisieren

In diesem Beispiel werden die Berechtigungen für die Zugriffssteuerung für ein Objekt in einem Bucket aktualisiert.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion PutObjectAcl aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "Bucket": "aws-s3-bucket-source",
   "ACL": "aws-exec-read",
   "Key": "AWS_S3_BusinessCase_V2.xlsx"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des PutObjectAcl-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Status": "Success"
}]

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Metadaten aller Objekte auflisten

In diesem Beispiel werden die Metadaten aller Objekte in der Object-Entität abgerufen.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Object aus der Liste Entity aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Optional können Sie im Bereich Aufgabeneingabe der Aufgabe Connectors das Ergebnisset filtern, indem Sie eine Filterklausel angeben. Geben Sie den Wert der Filterklausel immer in einfachen Anführungszeichen (') an, z. B. Bucket='test-bucket'. Mit den Logikoperatoren können Sie auch mehrere Filterbedingungen angeben. Zum Beispiel: Bucket='test-bucket' and OwnerId='b1ecc809ad8467088afb'.

Beispiel – Metadaten eines Buckets abrufen

In diesem Beispiel werden die Metadaten des Buckets mit der angegebenen ID aus der Bucket-Entität abgerufen.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Bucket aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf EntityId und geben Sie dann demo_replication in das Feld Standardwert ein.

   Dabei ist demo_replication eine eindeutige Bucket-ID in der Bucket-Entität.

Beispiel: Bucket erstellen

In diesem Beispiel wird ein Bucket in der Bucket-Entität erstellt.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Bucket aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "Bucket": "Demo1697528098686"
   }

   Wenn die Integration erfolgreich ist, hat das Feld connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

   [{
   "Bucket": "Demo1697528098686"
   }]

Beispiel: Bucket löschen

In diesem Beispiel wird der Bucket mit der angegebenen ID in der Bucket-Entität gelöscht.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Bucket aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann demo1697528098686 in das Feld Standardwert ein.