Una connessione di base rappresenta la connessione autenticata tra un'origine e Adobe Experience Platform.
Questa esercitazione descrive i passaggi necessari per creare una connessione di base per Google Cloud Storage utilizzando Flow Service API.
Questa guida richiede una buona comprensione dei seguenti componenti di Adobe Experience Platform:
Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per connettersi correttamente a un account di Google Cloud Storage utilizzando Flow Service API.
Per Flow Service per connettersi con Google Cloud Storage account, è necessario fornire valori per le seguenti proprietà di connessione:
Credenziali | Descrizione |
---|---|
accessKeyId |
Una stringa alfanumerica di 61 caratteri utilizzata per autenticare il tuo Google Cloud Storage a Platform. |
secretAccessKey |
Una stringa con codifica base a 64 caratteri utilizzata per l'autenticazione Google Cloud Storage a Platform. |
bucketName |
Il nome del tuo Google Cloud Storage secchio. È necessario specificare un nome per il bucket se si desidera fornire l’accesso a una sottocartella specifica nell’archiviazione cloud. |
folderPath |
Percorso della cartella a cui si desidera fornire l'accesso. |
Per ulteriori informazioni su questi valori, consulta la sezione Chiavi HMAC di Google Cloud Storage guida. Per i passaggi su come generare il tuo ID chiave di accesso e la chiave di accesso segreta, consulta Google Cloud Storage panoramica.
Per informazioni su come effettuare correttamente le chiamate alle API di Platform, consulta la guida su guida introduttiva alle API di Platform.
Una connessione di base conserva le informazioni tra l'origine e la piattaforma, incluse le credenziali di autenticazione dell'origine, lo stato corrente della connessione e l'ID di connessione di base univoco. L’ID di connessione di base consente di esplorare e navigare tra i file di origine e di identificare gli elementi specifici da acquisire, comprese le informazioni relative ai tipi di dati e ai formati corrispondenti.
Per creare un ID di connessione di base, invia una richiesta POST al /connections
l'endpoint durante la fornitura del Google Cloud Storage credenziali di autenticazione come parte dei parametri della richiesta.
Durante questo passaggio, puoi anche definire le sottocartelle a cui l’account avrà accesso definendo il nome del bucket e il percorso della sottocartella.
Formato API
POST /connections
Richiesta
La richiesta seguente crea una connessione di base per Google Cloud Storage:
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": "Google Cloud Storage connection",
"description": "Connector for Google Cloud Storage",
"auth": {
"specName": "Basic Authentication for google-cloud",
"params": {
"accessKeyId": "accessKeyId",
"secretAccessKey": "secretAccessKey",
"bucketName": "acme-google-cloud-bucket",
"folderPath": "/acme/customers/sales"
}
},
"connectionSpec": {
"id": "32e8f412-cdf7-464c-9885-78184cb113fd",
"version": "1.0"
}
}'
Proprietà | Descrizione |
---|---|
auth.params.accessKeyId |
L'ID chiave di accesso associato al tuo Google Cloud Storage conto. |
auth.params.secretAccessKey |
Chiave di accesso segreto associata al tuo Google Cloud Storage conto. |
auth.params.bucketName |
Il nome del tuo Google Cloud Storage secchio. È necessario specificare un nome per il bucket se si desidera fornire l’accesso a una sottocartella specifica nell’archiviazione cloud. |
auth.params.folderPath |
Percorso della cartella a cui si desidera fornire l'accesso. |
connectionSpec.id |
La Google Cloud Storage ID specifica di connessione: 32e8f412-cdf7-464c-9885-78184cb113fd |
Risposta
Una risposta corretta restituisce i dettagli della nuova connessione creata, incluso il relativo identificatore univoco (id
). Questo ID è necessario per esplorare i dati di archiviazione cloud nell’esercitazione successiva.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}
Seguendo questa esercitazione, hai creato un Google Cloud Storage è stata ottenuta una connessione utilizzando le API e un ID univoco come parte del corpo della risposta. Puoi usare questo ID connessione per esplorare gli archivi cloud utilizzando l’API del servizio di flusso.