Erstellen einer Basisverbindung für Amazon S3 auf Experience Platform auf Azure
Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Experience Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen ID 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:
Anfragebeispiel auswählen, um es anzuzeigen
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Amazon S3 base connection",
"description": "Amazon S3 base connection with temporary session token",
"auth": {
"specName": "Access Key",
"params": {
"s3AccessKey": "{S3_ACCESS_KEY}",
"s3SecretKey": "{S3_SECRET_KEY}",
"s3SessionToken": "{S3_SESSION_TOKEN}
}
},
"connectionSpec": {
"id": "ecadc60c-7455-4d87-84dc-2a0e293d997b",
"version": "1.0"
}
}'
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.
Auswählen, um ein Beispiel für eine Antwort anzuzeigen
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}
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 stellen. 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:
Anfragebeispiel auswählen, um es anzuzeigen
curl -X PATCH \
'https://platform.adobe.io/data/foundation/flowservice/connections/4cb0c374-d3bb-4557-b139-5712880adc55' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'If-Match: "1700d77b-0000-0200-0000-5e3b41a10000"'
-d '[
{
"op": "replace",
"path": "/auth/params/s3SessionToken",
"value": "{SESSION_TOKEN}"
}
]'
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.
Auswählen, um ein Beispiel für eine Antwort anzuzeigen
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"3600e378-0000-0200-0000-5f40212f0000\""
}