In alcuni casi, potrebbe essere necessario aggiornare i dettagli di una connessione di origine esistente. Flow Service consente di aggiungere, modificare ed eliminare dettagli di una connessione batch o in streaming esistente, inclusi nome, descrizione e credenziali.
Questa esercitazione descrive i passaggi per aggiornare i dettagli e le credenziali di una connessione utilizzando l' Flow Service API.
Questa esercitazione richiede una connessione esistente e un ID di connessione valido. Se non si dispone di una connessione esistente, selezionare l'origine di scelta tra le origini overview e seguire i passaggi descritti prima di eseguire l'esercitazione.
Questa esercitazione richiede inoltre di conoscere i seguenti componenti di Adobe Experience Platform:
Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per aggiornare correttamente una connessione utilizzando l'API Flow Service.
Questa esercitazione fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consultate la sezione relativa a come leggere chiamate API di esempio nella guida alla risoluzione dei problemi del Experience Platform .
Per effettuare chiamate alle API della piattaforma, è innanzitutto necessario completare l'esercitazione sull'autenticazione a1/>. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte chiamate API di Experience Platform, come illustrato di seguito:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
Tutte le risorse in Experience Platform, incluse quelle appartenenti a Flow Service, sono isolate in sandbox virtuali specifiche. Tutte le richieste alle API della piattaforma richiedono un'intestazione che specifica il nome della sandbox in cui avrà luogo l'operazione:
x-sandbox-name: {SANDBOX_NAME}
Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un'intestazione aggiuntiva per il tipo di supporto:
Content-Type: application/json
Il primo passo per aggiornare la connessione è recuperare i dettagli utilizzando l'ID di connessione. Per recuperare i dettagli correnti della connessione, effettuate una richiesta di GET all'API Flow Service fornendo l'ID connessione della connessione che desiderate aggiornare.
Formato API
GET /connections/{CONNECTION_ID}
Parametro | Descrizione |
---|---|
{CONNECTION_ID} |
Valore id univoco per la connessione che si desidera recuperare. |
Richiesta
La seguente richiesta recupera informazioni relative alla connessione.
curl -X GET \
'https://platform.adobe.io/data/foundation/flowservice/connections/139f6a5f-a78b-4744-9f6a-5fa78bd74431' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
Una risposta corretta restituisce i dettagli correnti della connessione, incluse le relative credenziali, l'identificatore univoco (id
) e la versione. Il valore della versione è richiesto per aggiornare la connessione.
{
"items": [
{
"createdAt": 1597973312000,
"updatedAt": 1597973312000,
"createdBy": "{CREATED_BY}",
"updatedBy": "{UPDATED_BY}",
"createdClient": "{CREATED_CLIENT}",
"updatedClient": "{UPDATED_CLIENT}",
"sandboxName": "{SANDBOX_NAME}",
"id": "139f6a5f-a78b-4744-9f6a-5fa78bd74431",
"name": "E2E_SF Base_Connection",
"connectionSpec": {
"id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
"version": "1.0"
},
"state": "enabled",
"auth": {
"specName": "Basic Authentication",
"params": {
"securityToken": "{SECURITY_TOKEN}",
"password": "{PASSWORD}",
"username": "my-salesforce-account",
"environmentUrl": "login.salesforce.com"
}
},
"version": "\"1400dd53-0000-0200-0000-5f3f23450000\"",
"etag": "\"1400dd53-0000-0200-0000-5f3f23450000\""
}
]
}
Per aggiornare il nome, la descrizione e le credenziali della connessione, eseguite una richiesta PATCH all'API Flow Service fornendo al contempo l'ID connessione, la versione e le nuove informazioni che desiderate utilizzare.
L'intestazione If-Match
è necessaria quando si effettua una richiesta di PATCH. Il valore di questa intestazione è la versione univoca della connessione che si desidera aggiornare.
Formato API
PATCH /connections/{CONNECTION_ID}
Parametro | Descrizione |
---|---|
{CONNECTION_ID} |
Valore id univoco per la connessione da aggiornare. |
Richiesta
La richiesta seguente fornisce un nuovo nome e una nuova descrizione, nonché un nuovo set di credenziali, con cui aggiornare la connessione.
curl -X PATCH \
'https://platform.adobe.io/data/foundation/flowservice/connections/139f6a5f-a78b-4744-9f6a-5fa78bd74431' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-H 'If-Match: 1400dd53-0000-0200-0000-5f3f23450000' \
-d '[
{
"op": "replace",
"path": "/auth/params",
"value": {
"username": "salesforce-connector-username",
"password": "{NEW_PASSWORD}",
"securityToken": "{NEW_SECURITY_TOKEN}"
}
},
{
"op": "replace",
"path": "/name",
"value": "Test salesforce connection"
},
{
"op": "add",
"path": "/description",
"value": "A test salesforce connection"
}
]'
Parametro | Descrizione |
---|---|
op |
Chiamata di operazione utilizzata per definire l'azione necessaria per aggiornare la connessione. Le operazioni includono: add , replace e remove . |
path |
Percorso del parametro da aggiornare. |
value |
Il nuovo valore con cui si desidera aggiornare il parametro. |
Risposta
Una risposta corretta restituisce l’ID connessione e un tag aggiornato. È possibile verificare l'aggiornamento eseguendo una richiesta di GET all'API Flow Service, fornendo al contempo l'ID di connessione.
{
"id": "139f6a5f-a78b-4744-9f6a-5fa78bd74431",
"etag": "\"3600e378-0000-0200-0000-5f40212f0000\""
}
Seguendo questa esercitazione, hai aggiornato le credenziali e le informazioni associate alla tua connessione utilizzando l'API Flow Service. Per ulteriori informazioni sull'utilizzo dei connettori di origine, vedere la panoramica delle sorgenti.