Verbinden von Amazon S3 mit Experience Platform mithilfe der Flow Service-API
Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr Amazon S3-Quellkonto mithilfe der -API mit Flow Service Adobe Experience Platform.
Erste Schritte
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:
- Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
- Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.
Verwenden von Platform-APIs
Informationen darüber, wie Sie Platform-APIs erfolgreich aufrufen können, finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.
Verbinden von Amazon S3 mit Experience Platform auf Azure azure
Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihrer Amazon S3 mit Experience Platform auf Azure zu erhalten.
Sammeln erforderlicher Anmeldedaten
Damit Flow Service eine Verbindung mit Ihrem Amazon S3-Speicher herstellen können, müssen Sie Werte für die folgenden Verbindungseigenschaften angeben:
s3AccessKey
s3SecretKey
serviceUrl
serviceUrl
ist: https://s3.{REGION}.amazonaws.com/)
.bucketName
-
) enthalten und kann nicht als IP-Adresse formatiert werden.folderPath
s3SessionToken
connectionSpec.id
ecadc60c-7455-4d87-84dc-2a0e293d997b
.Weitere Informationen zu den ersten Schritten finden Sie diesem Amazon Web Services Dokument.
Erstellen einer Basisverbindung für Amazon S3 auf Experience Platform in Azure
Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Platform gespeichert, einschließlich der Authentifizierungs-Anmeldedaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen Kennung der Basisverbindung. Mit der Kennung der Basisverbindung können Sie Dateien aus Ihrer Quelle heraus analysieren und darin navigieren und die spezifischen Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu ihren Datentypen und Formaten.
Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den Endpunkt /connections
und geben Sie dabei Ihre S3-Authentifizierungs-Anmeldedaten als Teil der Anfrageparameter an.
API-Format
POST /connections
Anfrage
Die folgende Anfrage erstellt eine Basisverbindung für Amazon S3:
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
Eigenschaft | Beschreibung |
auth.params.s3AccessKey |
Der Zugriffsschlüssel, der mit Ihrem S3-Bucket verknüpft ist. |
auth.params.s3SecretKey |
Ihr geheimer Schlüssel, der Ihrem S3 zugeordnet ist. |
auth.params.s3SessionToken |
(Optional) Das kurzfristige, temporäre S3-Token, das für den Zugriff auf Ihren Bucket verwendet wird. |
connectionSpec.id |
Die S3-Verbindungsspezifikations-ID: ecadc60c-7455-4d87-84dc-2a0e293d997b |
Antwort
Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id
). Diese ID ist erforderlich, um Ihren -Speicher im nächsten Tutorial zu untersuchen.
code language-json |
---|
|
Aktualisieren des S3 Sitzungstokens
Der s3SessionToken
ist temporär und muss bei Ablauf aktualisiert werden. Sie können das mit Ihrer Basisverbindung verknüpfte Sitzungs-Token aktualisieren, indem Sie eine PATCH-Anfrage an Flow Service -API senden. Weitere Informationen S3 temporären Sicherheitsberechtigungen für S3 finden Sie„Übersicht“.
If-Match
ist bei einer PATCH-Anfrage erforderlich. Der Wert für diese Kopfzeile ist das eindeutige eTag der Verbindung, die Sie aktualisieren möchten.API-Format
PATCH /connections
Anfrage
Die folgende Anfrage erstellt eine Basisverbindung für Amazon S3:
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Parameter | Beschreibung |
op |
Der Operationsaufruf, der für die Definition der zum Aktualisieren der Verbindung erforderlichen Aktion verwendet wird. Die Operationen umfassen add , replace und remove . |
path |
Der Pfad des zu aktualisierenden Parameters. |
value |
Der neue Wert, mit dem Sie Ihren Parameter aktualisieren möchten. |
Antwort
Bei einer erfolgreichen Antwort werden Ihre Basisverbindungs-ID und ein aktualisiertes E-Tag angegeben. Sie können die Aktualisierung überprüfen, indem Sie eine GET-Anfrage an die Flow Service-API stellen und dabei Ihre Verbindungs-ID angeben.
code language-json |
---|
|
Verbinden von Amazon S3 mit Experience Platform auf Amazon Web Services (AWS) aws
Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihrer Amazon S3 mit Experience Platform auf AWS zu erhalten.
Voraussetzungen
Um Ihr Amazon S3-Konto mit Experience Platform auf AWS zu verbinden, benötigen Sie Folgendes:
- Ein AWS-Konto mit Zugriff auf den Amazon S3-Bucket oder -Ordner, den Sie verbinden möchten.
- Die erforderlichen IAM-Berechtigungen, die
s3:GetObject
unds3:ListBucket
Aktionen ermöglichen.
Abrufen der IAM-Rolle für Ihre Bucket-Berechtigungen
API-Format
GET /connectionSpecs/{CONNECTION_SPEC_ID}/configs?authType={AUTH_TYPE}
Anfrage
code language-shell |
---|
|
Antwort
Eine erfolgreiche Antwort gibt Ihre IAM-Rolle zurück. Dieser Wert ist im nächsten Schritt erforderlich, um Berechtigungen in Ihrem Amazon S3 einzurichten.
code language-json |
---|
|
Einrichten von Berechtigungen in Ihrem Amazon S3 Bucket
- Melden Sie sich in der AWS-Verwaltungskonsole bei Ihrem Konto.
- Navigieren Sie zu Ihrem Amazon S3 und wählen Sie Permissions aus.
- Bearbeiten Sie die Bucket-Richtlinie und fügen Sie die folgenden Berechtigungen hinzu:
IAM_ROLE_TO_ALLOW_LIST
ist die IAM-Rolle, die im vorherigen Schritt über die API abgerufen wurde. Sie müssen {YOUR_BUCKET_NAME} durch den tatsächlichen Namen Ihres Amazon S3-Buckets ersetzen. Wenn Sie Zugriff auf einen bestimmten Ordner gewähren möchten, müssen Sie {YOUR_FOLDER_NAME} auch durch den tatsächlichen Namen des Ordners ersetzen, auf den Sie Zugriff gewähren möchten.{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AEP Get Object Related Policy Prod",
"Effect": "Allow",
"Principal": {
"AWS": "{IAM_ROLE_TO_ALLOW_LIST}"
},
"Action": "s3:Get*",
"Resource": "arn:aws:s3:::{YOUR_BUCKET_NAME}/{YOUR_FOLDER_NAME}"
},
{
"Sid": "AEP List Bucket Prod",
"Effect": "Allow",
"Principal": {
"AWS": "{IAM_ROLE_TO_ALLOW_LIST}"
},
"Action": "s3:ListBucket",
"Resource": "arn:aws:s3:::{YOUR_BUCKET_NAME}"
}
]
}
Erstellen einer Basisverbindung für Amazon S3 auf Experience Platform in AWS
API-Format
POST /connections
Anfrage
Die folgende Anfrage erstellt eine Basisverbindung für Amazon S3:
code language-shell |
---|
|
table 0-row-2 1-row-2 | |
---|---|
Eigenschaft | Beschreibung |
auth.params.bucketName |
Der Name Ihres Amazon S3. Dies ist derselbe Wert, der im vorherigen Schritt zu Berechtigungen hinzugefügt wurde. |
Antwort
Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id
). Diese ID ist erforderlich, um Ihren -Speicher im nächsten Tutorial zu untersuchen.
code language-json |
---|
|
Nächste Schritte
In diesem Tutorial haben Sie eine S3-Verbindung mithilfe von APIs erstellt und eine eindeutige ID als Teil der Antwort erhalten. Sie können diese Verbindungs-ID verwenden, um Cloud-Speicher mithilfe der Flow Service-API zu.