Il connettore FTP è in versione beta. Le funzioni e la documentazione sono soggette a modifiche. Consulta la Panoramica sulle origini per ulteriori informazioni sull’utilizzo di connettori con etichetta beta.
Una connessione di base rappresenta la connessione autenticata tra un'origine e Adobe Experience Platform.
Questo tutorial illustra i passaggi necessari per creare una connessione di base per FTP (File Transfer Protocol) utilizzando Flow Service API.
Questa guida richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per connettersi correttamente a un FTP server che utilizza Flow Service API.
Per ottenere Flow Service per connettersi a FTP, è necessario fornire valori per le seguenti proprietà di connessione:
Credenziali | Descrizione |
---|---|
host |
Nome o indirizzo IP associato al FTP server. |
username |
Il nome utente con accesso al FTP server. |
password |
La password per FTP server. |
connectionSpec.id |
La specifica di connessione restituisce le proprietà del connettore di un'origine, incluse le specifiche di autenticazione relative alla creazione delle connessioni di base e di origine. ID della specifica di connessione per FTP è: fb2e94c9-c031-467d-8103-6bd6e0a432f2 . |
Per informazioni su come effettuare correttamente chiamate alle API di Platform, consulta la guida su introduzione alle API di Platform.
Una connessione di base mantiene le informazioni tra l’origine e Platform, incluse le credenziali di autenticazione dell’origine, lo stato corrente della connessione e l’ID univoco della connessione di base. L’ID della connessione di base consente di esplorare e navigare tra i file dall’interno dell’origine e identificare gli elementi specifici che desideri acquisire, comprese le informazioni relative ai tipi di dati e ai formati.
Per creare un ID di connessione di base, effettua una richiesta POST al /connections
endpoint durante la fornitura del FTP credenziali di autenticazione come parte dei parametri della richiesta.
Formato API
POST /connections
Richiesta
La richiesta seguente crea una connessione di base per FTP:
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": "FTP connector with password",
"description": "FTP connector password",
"auth": {
"specName": "Basic Authentication for FTP",
"params": {
"host": "{HOST}",
"userName": "{USERNAME}",
"password": "{PASSWORD}"
}
},
"connectionSpec": {
"id": "fb2e94c9-c031-467d-8103-6bd6e0a432f2",
"version": "1.0"
}
}'
Proprietà | Descrizione |
---|---|
auth.params.host |
Il nome host del server FTP. |
auth.params.username |
Il nome utente associato al server FTP. |
auth.params.password |
La password associata al server FTP. |
connectionSpec.id |
ID specifica connessione server FTP: fb2e94c9-c031-467d-8103-6bd6e0a432f2 |
Risposta
In caso di esito positivo, la risposta restituisce l’identificatore univoco (id
) della connessione appena creata. Questo ID è necessario per esplorare il server FTP nella prossima esercitazione.
{
"id": "bf367b0d-3d9b-4060-b67b-0d3d9bd06094",
"etag": "\"1700cc7b-0000-0200-0000-5e3b3fba0000\""
}
Seguendo questa esercitazione, hai creato una connessione FTP utilizzando Flow Service e hanno ottenuto il valore ID univoco della connessione. Puoi usare questo ID connessione per esplorare gli archivi cloud utilizzando l’API del servizio Flow.