Skapa en Phoenix basanslutning med Flow Service API

En basanslutning representerar den autentiserade anslutningen mellan en källa och Adobe Experience Platform.

I den här självstudiekursen beskrivs hur du skapar en basanslutning och ansluter Phoenix till Adobe Experience Platform med Flow Service API.

Komma igång

Handboken kräver en fungerande förståelse av följande komponenter i Experience Platform:

  • Källor: Experience Platform tillåter att data kan hämtas från olika källor samtidigt som du kan strukturera, märka och förbättra inkommande data med hjälp av Experience Platform-tjänster.
  • Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enda Experience Platform-instans till separata virtuella miljöer för att utveckla och utveckla program för digitala upplevelser.

I följande avsnitt finns ytterligare information som du behöver känna till för att kunna ansluta till Phoenix med Flow Service API.

Samla in nödvändiga inloggningsuppgifter

Du måste ange följande autentiseringsuppgifter för att kunna ansluta Phoenix konto till Experience Platform.

Autentiseringsuppgifter
Beskrivning
host
IP-adressen eller värdnamnet för Phoenix server.
username
Användarnamnet som du använder för att komma åt Phoenix Server.
password
Lösenordet som motsvarar användaren.
port
TCP-porten som Phoenix servern använder för att avlyssna klientanslutningar. Om du ansluter till Azure HDInsightsanger du porten som 443. Om den här parametern inte anges används standardvärdet 8765.
httpPath
Den del av URL som motsvarar Phoenix server. Ange /hbasephoenix0 om du använder Azure HDInsights-kluster.
enableSsl
Ett booleskt värde. Anger om anslutningar till servern krypteras med SSL.
connectionSpec.id
Anslutningsspecifikationen returnerar en källas kopplingsegenskaper, inklusive autentiseringsspecifikationer för att skapa bas- och källanslutningarna. Anslutningsspecifikations-ID för Phoenix är: 102706fb-a5cd-42ee-afe0-bc42f017ff43

Mer information om hur du kommer igång finns i det här Phoenix-dokumentet.

Använda plattforms-API:er

Mer information om hur du kan anropa API:er för plattformar finns i handboken komma igång med plattforms-API:er.

Skapa en basanslutning

En basanslutning bevarar information mellan källan och plattformen, inklusive källans autentiseringsuppgifter, anslutningsstatus och ditt unika basanslutnings-ID. Med det grundläggande anslutnings-ID:t kan du utforska och navigera bland filer inifrån källan och identifiera de specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa en basanslutning skickar du en POST till /connections slutpunkt när du ger Phoenix autentiseringsuppgifter i begärandetexten.

API-format

POST /connections

Begäran

Följande begäran skapar en basanslutning för Phoenix:

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": "Phoenix test connection",
      "description": "Phoenix test connection",
      "auth": {
          "specName": "Basic Authentication",
      "params": {
          "host":  "{HOST}",
          "username": "{USERNAME}",
          "password":"{PASSWORD}",
          "port": {PORT},
          "httpPath": "{PATH}",
          "enableSsl": {SSL}
          }
      },
      "connectionSpec": {
          "id": "102706fb-a5cd-42ee-afe0-bc42f017ff43",
          "version": "1.0"
      }
  }'
Egenskap
Beskrivning
auth.params.host
Värden för Phoenix server.
auth.params.username
Användarnamnet som är associerat med din Phoenix anslutning.
auth.params.password
Lösenordet som är kopplat till Phoenix anslutning.
auth.params.port
TCP-porten för din Phoenix anslutning.
auth.params.httpPath
Den partiella http-sökvägen för Phoenix anslutning.
auth.params.enableSsl
Det booleska värdet som anger om anslutningarna till servern är krypterade med SSL.
connectionSpec.id
The Phoenix anslutningsspecifikation-ID: 102706fb-a5cd-42ee-afe0-bc42f017ff43.

Svar

Ett godkänt svar returnerar information om den nya anslutningen, inklusive dess unika identifierare (id). Detta ID krävs för att utforska dina data i nästa självstudiekurs.

{
    "id": "0d982fff-c443-403e-982f-ffc443f03e37",
    "etag": "\"830082dc-0000-0200-0000-5e84ee560000\""
}

Nästa steg

Genom att följa den här självstudiekursen har du skapat en Phoenix basanslutning med Flow Service API. Du kan använda detta grundläggande anslutnings-ID i följande självstudier:

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089