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 den folgenden Zugriff verfügen, um die Funktionalität in diesem Artikel verwenden zu können:

Adobe Workfront plan*
Pro oder höher
Adobe Workfront license*
Plan, Arbeit
Adobe Workfront Fusion license**

Aktuelle Lizenzanforderungen: Keine Workfront Fusion Lizenzanforderungen.

Oder

Alte Lizenzanforderung: Workfront Fusion für die Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select- oder Prime Adobe Workfront-Plan verfügen, muss Ihr Unternehmen Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebene Funktionalität nutzen zu können. Workfront Fusion ist im Ultimate Workfront-Plan enthalten.

Oder

Alte Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebenen Funktionen nutzen zu können.

Wenden Sie sich an Ihren Workfront -Administrator, um zu erfahren, welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie haben.

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

Voraussetzungen

Um die Module AWS S3 zu verwenden, 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{{parameter.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 Identitäts- und Zugriffsverwaltung > Zugriffsverwaltung > Benutzer.

  3. Klicken Sie auf Benutzer hinzufügen.

  4. Geben Sie den Namen des neuen Benutzers ein und wählen Sie im Abschnitt Zugriffstyp die Option Programmatischer Zugriff aus.

  5. Klicken Sie auf Vorhandene Richtlinien direkt anhängen und suchen Sie dann in der Suchleiste nach AmazonS3FullAccess . Klicken Sie darauf, wenn es angezeigt wird, und klicken Sie dann auf Weiter.

  6. Fahren Sie mit den anderen Dialogfeldern fort und klicken Sie dann auf Benutzer erstellen.

  7. Kopieren Sie die bereitgestellte Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel.

  8. Wechseln Sie zu Workfront Fusion und öffnen Sie das Dialogfeld Verbindung erstellen des AWS S3 Moduls.

  9. Geben Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel aus Schritt 7 in die entsprechenden Felder ein und klicken Sie auf Weiter , um die Verbindung herzustellen.

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

AWS S3 Module und ihre Felder

Wenn Sie AWS S3 -Module konfigurieren, 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 im Dienst zusätzliche AWS S3 -Felder angezeigt werden. Ein fett hervorgehobener Titel in einem Modul zeigt ein erforderliches Feld an.

Wenn Sie die Zuordnungsschaltfläche über einem Feld oder einer Funktion sehen, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Informationen von einem Modul einem anderen zuordnen in Adobe Workfront Fusion.

Aktionen

Behälter erstellen

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

Datei abrufen

Lädt eine Datei aus einem Behälter herunter.

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

Datei hochladen

Verbindung
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie in diesem Artikel unter Verbinden von AWS mit Workfront Fusion .
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der Diskussion zu regionalen Endpunkten in der Dokumentation zu AWS .
Ordner (optional)
Geben Sie den Zielordner an, in den Sie eine Datei hochladen möchten.
Source-Datei
Wählen Sie eine Quelldatei aus einem vorherigen Modul aus oder ordnen Sie den Namen und die Daten der Quelldatei zu.
Header (optional)
Fügen Sie Anforderungsheader ein. Die verfügbaren Kopfzeilen finden Sie in der AWS S3 -Dokumentation - PUT-Objekt.

API-Aufruf durchführen

Eine ausführliche Beschreibung der Amazon S3-API finden Sie unter Amazon S3 REST API-Einführung.

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

Fügen Sie eine Anfrage-Kopfzeile hinzu. Sie können die folgenden allgemeinen Anforderungsheader verwenden. Weitere Anfragekopfzeilen finden Sie in der AWS S3 API-Dokumentation.

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 die Kopfzeilen) gemäß RFC 2616. Dieser Header ist für PUTs und Vorgänge erforderlich, die XML laden, z. B. Protokollierung und ACLs.
Content-Type Der Inhaltstyp der Ressource, falls sich der Anfrageinhalt im Hauptteil befindet. Beispiel: text/plain.
Content-MD5 Der base64-kodierte 128-Bit-MD5-Digest der Nachricht (ohne Kopfzeilen) gemäß RFC 1864. Dieser Header kann als Integritätsprüfung für die Nachricht verwendet werden, um zu überprüfen, ob es sich bei den Daten um dieselben Daten handelt, die ursprünglich gesendet wurden. Obwohl dies optional ist, empfehlen wir die Verwendung des Content-MD5-Mechanismus als End-to-End-Integritätsprüfung. Weitere Informationen zur Authentifizierung von REST-Anfragen finden Sie unter REST Authentication im Amazon Simple Storage Service Developer Guide.
Datum Das aktuelle Datum und die aktuelle Uhrzeit entsprechend dem Anfragenden. Beispiel: Wed, 01 Mar 2006 12:00:00 GMT. Wenn Sie die Kopfzeile Authorization angeben, müssen Sie entweder die Kopfzeile x-amz-date oder die Kopfzeile Date angeben.
Expect

Wenn Ihre Anwendung 100-continue verwendet, sendet sie den Anfragetext erst, wenn sie eine Bestätigung erhält. Wenn die Nachricht aufgrund der Header abgelehnt wird, wird der Hauptteil der Nachricht nicht gesendet. Diese Kopfzeile kann nur verwendet werden, wenn Sie einen Hauptteil senden.

Gültige Werte: 100-continue

Host

Bei Pfadanforderungen ist der Wert s3.amazonaws.com. Bei Anforderungen im virtuellen Stil ist der Wert BucketName.s3.amazonaws.com. Weitere Informationen finden Sie unter Virtuelles Hosting im Amazon Entwicklerhandbuch für einfachen Speicherdienst.

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

x-amz-content-sha256 Wenn Sie die Signaturversion 4 zum Authentifizieren der Anfrage verwenden, stellt dieser Header einen Hash der Anfrage-Payload bereit. Setzen Sie beim Hochladen eines Objekts in Teilen den Wert auf "STREAMING-AWS4-HMAC-SHA256-PAYLOAD", um anzugeben, dass die Signatur nur Kopfzeilen abdeckt und dass keine Payload vorhanden ist. Weitere Informationen finden Sie unter Signaturberechnungen für die Autorisierungskopfzeile: Übertragen der Payload in mehrere Blöcke (Chunked Upload) (AWS Signature Version 4).
x-amz-date Das aktuelle Datum und die aktuelle Uhrzeit entsprechend dem Anfragenden. Beispiel: Wed, 01 Mar 2006 12:00:00 GMT. Wenn Sie die Kopfzeile Authorization angeben, müssen Sie entweder die Kopfzeile x-amz-date oder die Kopfzeile Date angeben. Wenn Sie beide angeben, hat der für die Kopfzeile x-amz-date angegebene Wert Vorrang.
x-amz-security-token

Diese Kopfzeile kann in den folgenden Szenarien verwendet werden:

  • Stellen Sie Sicherheits-Token für Amazon DevPay-Vorgänge bereit. Für jede Anfrage, die Amazon DevPay verwendet, sind zwei x-amz-security-token -Header erforderlich: eine für das Produkt-Token und eine für das Benutzer-Token. Wenn Amazon S3 eine authentifizierte Anforderung erhält, wird die berechnete Signatur mit der bereitgestellten Signatur verglichen. Fehlerhaft formatierte Header mit mehreren Werten, die zur Berechnung einer Signatur verwendet werden, können Authentifizierungsprobleme verursachen.
  • Stellen Sie bei Verwendung temporärer Sicherheitsberechtigungen ein Sicherheits-Token bereit. Bei Anfragen mit temporären Sicherheitsberechtigungen, die Sie von IAM erhalten haben, müssen Sie mithilfe dieses Headers ein Sicherheits-Token bereitstellen. Weitere Informationen zu temporären Sicherheitsberechtigungen finden Sie unter Anforderungen erstellen .

Diese Kopfzeile ist für Anfragen erforderlich, die Amazon DevPay verwenden, und für Anfragen, die mit temporären Sicherheitsberechtigungen signiert werden.

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

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

Hinweis:

Bei Verwendung von bedingten Anweisungen wie if in Ihrer JSON platzieren Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Suchvorgänge

Listendateien

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

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

Listenordner

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

Verbindung
Anweisungen zum Verbinden Ihres AWS-Kontos mit Workfront Fusion finden Sie in diesem Artikel unter Verbinden von AWS mit Workfront Fusion .
Region
Wählen Sie Ihren regionalen Endpunkt aus. Weitere Informationen finden Sie in der Diskussion zu regionalen Endpunkten in der AWS-Dokumentation.
Bucket
Wählen Sie den Bucket Amazon S3 aus, nach dem Sie nach Ordnern suchen möchten.
Präfix (optional)
Pfad zu einem Ordner, in dem Ordner nachschlagen sollen, z. B. workfrontfusion/work.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43