Skapa en Phoenix-basanslutning med API:t Flow Service

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 ditt Phoenix-konto till Adobe Experience Platform med API:t för Flow Service.

Komma igång

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

  • Källor: Med Experience Platform kan data hämtas från olika källor samtidigt som du kan strukturera, etikettera 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 API:t Flow Service.

Samla in nödvändiga inloggningsuppgifter

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

Autentiseringsuppgifter
Beskrivning
host
IP-adressen eller värdnamnet för servern Phoenix.
username
Användarnamnet som du använder för att komma åt servern Phoenix.
password
Lösenordet som motsvarar användaren.
port
TCP-porten som servern Phoenix använder för att avlyssna klientanslutningar. Om du ansluter till Azure HDInsights anger du porten som 443. Om den här parametern inte anges används standardvärdet 8765.
httpPath
Den partiella URL som motsvarar servern Phoenix. 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 plattforms-API:er finns i guiden 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 slutpunkten /connections samtidigt som du anger autentiseringsuppgifterna för Phoenix 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 servern Phoenix.
auth.params.username
Användarnamnet som är associerat med din Phoenix-anslutning.
auth.params.password
Lösenordet som är kopplat till din Phoenix-anslutning.
auth.params.port
TCP-porten för din Phoenix-anslutning.
auth.params.httpPath
Den partiella http-sökvägen för din Phoenix-anslutning.
auth.params.enableSsl
Det booleska värdet som anger om anslutningarna till servern är krypterade med SSL.
connectionSpec.id
Anslutningsspecifikations-ID Phoenix: 102706fb-a5cd-42ee-afe0-bc42f017ff43.

Svar

Ett lyckat svar returnerar information om den nyligen skapade 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 API:t Flow Service. Du kan använda detta grundläggande anslutnings-ID i följande självstudier:

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