AWS S3-Module

Mit den Adobe Workfront Fusion AWS S3-Modulen können Sie Vorgänge an Ihren S3-Buckets durchführen.

Zugriffsanforderungen

Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:

Adobe Workfront Plan*
Pro oder höher
Adobe Workfront Lizenz*
Plan, Work
Adobe Workfront Fusion Lizenz **

Aktuelle Lizenzanforderung: Keine Workfront Fusion.

Oder

Legacy-Lizenzanforderung: Workfront Fusion für Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select oder Prime Adobe Workfront verfügen, muss Ihr Unternehmen Adobe Workfront Fusion kaufen und Adobe Workfront, die in diesem Artikel beschriebenen Funktionen zu verwenden. Workfront Fusion ist im Ultimate Workfront enthalten.

Oder

Legacy-Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion erwerben und Adobe Workfront, die in diesem Artikel beschriebenen Funktionen zu verwenden.

Wenden Sie sich an Ihren Workfront, um herauszufinden, über welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie verfügen.

Informationen zu Adobe Workfront Fusion finden Sie unter Adobe Workfront Fusion Lizenzen.

Voraussetzungen

Um AWS S3 Module verwenden zu können, müssen Sie über ein Amazon Web Service-Konto verfügen.

AWS S3-API-Informationen

Der AWS S3-Connector verwendet Folgendes:

Basis-URL
https://s3.{{parameters.region}}.amazonaws.com
API-Tag
v1.5.21

AWS mit Workfront Fusion verbinden connect-aws-to-workfront-fusion

Um AWS S3 mit Workfront Fusion zu verbinden, müssen Sie Ihr AWS-Konto mit Workfront Fusion verbinden. Dazu müssen Sie zunächst einen API-Benutzer in AWS IAM erstellen.

  1. Melden Sie sich bei Ihrem AWS IAM Konto an.

  2. Navigieren Sie zu Identity and Access Management > Access Management > Users.

  3. Klicken Sie auf Add User.

  4. Geben Sie den Namen des neuen Benutzers ein und wählen Sie die Option Programmatic access im Abschnitt Access type aus.

  5. Klicken Sie auf Attach existing policies directly und suchen Sie dann in der Suchleiste nach AmazonS3FullAccess. Klicken Sie, wenn es angezeigt wird, und klicken Sie dann auf Next.

  6. Gehen Sie durch die anderen Dialogfelder und klicken Sie dann auf Create User.

  7. Kopieren Sie die bereitgestellten Access key ID und Secret access key.

  8. Navigieren Sie zu Workfront Fusion und öffnen Sie das Create a connection-Dialogfeld des AWS S3.

  9. Geben Sie die Access key ID und Secret access key aus Schritt 7 in die entsprechenden Felder ein und klicken Sie auf Continue , um die Verbindung herzustellen.

Die Verbindung wurde hergestellt. Sie können mit der Einrichtung des Moduls fortfahren.

AWS S3 Module und ihre Felder

Beim Konfigurieren AWS S3 Module zeigt Workfront Fusion die unten aufgeführten Felder an. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der App oder dem Service weitere AWS S3 angezeigt werden. Ein fett gedruckter Titel in einem Modul gibt ein erforderliches Feld an.

Wenn die Zuordnungsschaltfläche über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen von einem Modul zu einem anderen.

Umschalter für Zuordnung

Aktionen

Create Bucket

Connection
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie unter Verbinden von AWS mit Workfront Fusion in diesem Artikel.
Name
Geben Sie den Namen des neuen Buckets ein.
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der Dokumentation zu regionalen Endpunkten in AWS.

Get File

Lädt eine Datei aus einem Bucket herunter.

Connection
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie unter Verbinden von AWS mit Workfront Fusion in diesem Artikel.
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der AWS-Dokumentation unter vonregionalen Endpunkten“.
Bucket
Wählen Sie den Bucket aus, von dem Sie die Datei herunterladen möchten.
Path
Geben Sie den Pfad zur Datei ein. Beispiel: /photos/2019/February/image023.jpg.

Upload File

Connection
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie unter Verbinden von AWS mit Workfront Fusion in diesem Artikel.
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der AWS-Dokumentation unter vonregionalen Endpunkten“.
Folder (optional)
Geben Sie den Zielordner an, in den Sie eine Datei hochladen möchten.
Source file
Wählen Sie eine Quelldatei aus einem vorherigen Modul aus oder ordnen Sie den Namen und die Daten der Quelldatei zu.
Headers (optional)
Anfrage-Header einfügen. Verfügbare Kopfzeilen finden Sie in der AWS S3-Dokumentation - PUT Objekt.

Make an API Call

Eine ausführliche Erläuterung der Amazon S3-API finden Sie unter Einführung in Amazon S3 REST API.

Connection
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie unter Verbinden von AWS mit Workfront Fusion in diesem Artikel.
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der AWS-Dokumentation unter vonregionalen Endpunkten“.
URL
URL Geben Sie eine Host-URL ein. Der Pfad muss relativ sein zu https://s3.<selected-region>.amazonaws.com/.
Method
Wählen Sie die HTTP Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP von Anfragemethoden in Adobe Workfront Fusion.
Headers

Fügen Sie einen Anfrage-Header hinzu. Sie können die folgenden allgemeinen Anfragekopfzeilen verwenden. Weitere Informationen zu Anfragekopfzeilen finden Sie in AWS S3 API-.

Workfront Fusion Fügt automatisch Autorisierungskopfzeilen hinzu.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
Header-Name Beschreibung
Content-Length Länge der Nachricht (ohne Kopfzeilen) gemäß RFC 2616. Dieser Header ist für PUT und Vorgänge erforderlich, die XML laden, z. B. Protokollierung und ACLs.
Content-Type Der Content-Typ der Ressource, falls sich der Anfrageinhalt im Hauptteil befindet. Beispiel: text/plain.
Content-MD5 Der base64-kodierte MD5-Digest der Nachricht (ohne die Header) mit 128 Bit gemäß RFC 1864. Dieser Header kann als Integritätsprüfung von Nachrichten verwendet werden, um sicherzustellen, dass es sich bei den Daten um dieselben Daten handelt, die ursprünglich gesendet wurden. Obwohl dies optional ist, empfehlen wir, den Content-MD5-Mechanismus als End-to-End-Integritätsprüfung zu verwenden. Weitere Informationen zur Authentifizierung für REST-Anfragen finden Sie unter REST-AuthentifizierungEntwicklerhandbuch für den Amazon Simple Storage Service.
Date Das aktuelle Datum und die aktuelle Uhrzeit gemäß dem Anforderer. Beispiel: Wed, 01 Mar 2006 12:00:00 GMT. Wenn Sie den Authorization Header“ angeben, müssen Sie entweder den x-amz-date oder den Date Header“ angeben.
Expect

Wenn Ihre Anwendung 100-continue verwendet, sendet sie den Anfragetext erst, wenn sie eine Bestätigung erhält. Wenn die Nachricht anhand der Kopfzeilen abgelehnt wird, wird der Nachrichtentext nicht gesendet. Dieser Header kann nur verwendet werden, wenn Sie einen Textkörper senden.

Gültige Werte: 100-continue

Host

Bei Anfragen im Pfadstil ist der Wert s3.amazonaws.com. Bei Anfragen im virtuellen Stil lautet der Wert BucketName.s3.amazonaws.com. Weitere Informationen finden Sie unter Virtuelles Hosting im Amazon Simple Storage Service-Entwicklerhandbuch.

Dieser Header ist für HTTP 1.1 erforderlich (die meisten Toolkits fügen diesen Header automatisch hinzu); optional für HTTP/1.0-Anfragen.

x-amz-content-sha256 Wenn Sie die Signaturversion 4 zum Authentifizieren der Anfrage verwenden, liefert dieser Header einen Hash der Anfrage-Payload. Wenn Sie ein -Objekt in Blöcken hochladen, setzen Sie den Wert auf STREAMING-AWS4-HMAC-SHA256-PAYLOAD , um anzugeben, dass die Signatur nur Kopfzeilen abdeckt und keine Payload vorhanden ist. Weitere Informationen finden Sie unter Signaturberechnungen für den Autorisierungs-Header: Übertragen von Payload in mehreren Blöcken (Chunked Upload) (AWS Signature Version 4).
x-amz-date Das aktuelle Datum und die aktuelle Uhrzeit gemäß dem Anforderer. Beispiel: Wed, 01 Mar 2006 12:00:00 GMT. Wenn Sie den Authorization Header“ angeben, müssen Sie entweder den x-amz-date oder den Date Header“ angeben. Wenn Sie beide angeben, hat der für die x-amz-date Kopfzeile angegebene Wert Vorrang.
x-amz-security-token

Dieser Header kann in den folgenden Szenarien verwendet werden:

  • Geben Sie Sicherheits-Token für Amazon DevPay Vorgänge an. Für jede Anfrage, die Amazon DevPay verwendet, sind zwei x-amz-security-token-Kopfzeilen erforderlich: eine für das Produkt-Token und eine für das Benutzer-Token. Wenn Amazon S3 eine authentifizierte Anfrage erhält, vergleicht es die berechnete Signatur mit der bereitgestellten Signatur. Falsch formatierte Kopfzeilen mit mehreren Werten, die zur Berechnung einer Signatur verwendet werden, können zu Authentifizierungsproblemen führen.
  • Geben Sie bei Verwendung temporärer Sicherheitsberechtigungen ein Sicherheits-Token an. Wenn Sie Anfragen mit temporären Sicherheitsanmeldeinformationen stellen, die Sie von IAM erhalten haben, müssen Sie mithilfe dieser Kopfzeile ein Sicherheits-Token angeben. Weitere Informationen zu temporären Sicherheitsberechtigungen finden Sie unter Anfragen stellen .

Dieser Header ist für Anfragen erforderlich, die Amazon DevPay verwenden, und für Anfragen, die mit temporären Sicherheitsberechtigungen signiert sind.

Query String
Fügen Sie die gewünschten Abfragezeichenfolgen wie Parameter oder Formularfelder hinzu.
Body

Fügen Sie den Hauptteil des Inhalts für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Hinweis:

Wenn Sie bedingte Anweisungen wie if in Ihrer JSON-Datei verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Suchvorgänge

List Files

Gibt eine Liste mit Dateien von einem angegebenen Speicherort zurück.

Connection
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie unter Verbinden von AWS mit Workfront Fusion in diesem Artikel.
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der AWS-Dokumentation unter vonregionalen Endpunkten“.
Bucket
Wählen Sie den Amazon S3-Bucket aus, nach dem Sie nach Dateien suchen möchten.
Prefix (optional)
Pfad zu einem Ordner, in dem Dateien nachgeschlagen werden sollen, z. B. workfrontfusion/work.

List Folders

Gibt eine Liste mit Ordnern von einem angegebenen Speicherort zurück.

Connection
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie unter Verbinden von AWS mit Workfront Fusion in diesem Artikel.
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der Dokumentation zu regionalen Endpunkten in AWS.
Bucket
Wählen Sie den Amazon S3-Bucket aus, nach dem Sie nach Ordnern suchen möchten.
Prefix (optional)
Pfad zu einem Ordner, in dem Ordner gesucht werden sollen, z. B. workfrontfusion/work.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3