DokumentationExperience PlatformAnvändarhandbok om Source Connectors

Skapa en Oracle Object Storage-basanslutning med API:t Flow Service

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

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

I den här självstudien får du hjälp med att skapa en basanslutning för Oracle Object Storage med Flow Service API.

Komma igång

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

  • Källor: Experience Platform tillåter data att hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med hjälp av plattformstjänster.
  • Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enda plattformsinstans 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 Oracle Object Storage med API:t Flow Service.

Samla in nödvändiga inloggningsuppgifter

För att Flow Service ska kunna ansluta till Oracle Object Storage måste du ange värden för följande anslutningsegenskaper:

Autentiseringsuppgifter
Beskrivning
serviceUrl
Slutpunkten Oracle Object Storage krävs för autentisering. Slutpunktsformatet är: https://{OBJECT_STORAGE_NAMESPACE}.compat.objectstorage.eu-frankfurt-1.oraclecloud.com
accessKey
Åtkomstnyckel-ID Oracle Object Storage krävs för autentisering.
secretKey
Lösenordet Oracle Object Storage krävs för autentisering.
bucketName
Det tillåtna bucket-namn som krävs om användaren har begränsad åtkomst. Bucketnamnet måste innehålla mellan tre och 63 tecken, det måste börja och sluta med en bokstav eller en siffra och får bara innehålla gemena bokstäver, siffror eller bindestreck (-). Det går inte att formatera bucket-namnet som en IP-adress.
folderPath
Den tillåtna mappsökväg som krävs om användaren har begränsad åtkomst.
connectionSpec.id
Anslutningsspecifikationen returnerar en källas kopplingsegenskaper, inklusive autentiseringsspecifikationer för att skapa bas- och källanslutningarna. Anslutningsspecifikations-ID för Oracle Object Storage är: c85f9425-fb21-426c-ad0b-405e9bd8a46c.

Mer information om hur du hämtar de här värdena finns i autentiseringsguiden för Oracle Object Storage.

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 ett grundläggande anslutnings-ID skickar du en POST till slutpunkten /connections och anger dina autentiseringsuppgifter för Oracle Object Storage som en del av parametrarna för begäran.

API-format

POST /connections

Begäran

Följande begäran skapar en basanslutning för Oracle Object 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": "Oracle Object Storage connection",
        "description": "Oracle Object Storage connection",
        "auth": {
            "specName": "Access Key",
            "params": {
                "serviceUrl": "{SERVICE_URL}",
                "accessKey": "{ACCESS_KEY}",
                "secretKey": "{SECRET_KEY}",
                "bucketName": "{BUCKET_NAME}",
                "folderPath", "{FOLDER_PATH}"
            }
        },
        "connectionSpec": {
            "id": "c85f9425-fb21-426c-ad0b-405e9bd8a46c",
            "version": "1.0"
        }
    }'
Egenskap
Beskrivning
auth.params.serviceUrl
Slutpunkten Oracle Object Storage krävs för autentisering.
auth.params.accessKey
Åtkomstnyckel-ID Oracle Object Storage krävs för autentisering.
auth.params.secretKey
Lösenordet Oracle Object Storage krävs för autentisering.
auth.params.bucketName
Det tillåtna bucket-namn som krävs om användaren har begränsad åtkomst.
auth.params.folderPath
Den tillåtna mappsökväg som krävs om användaren har begränsad åtkomst.
connectionSpec.id
Anslutningens spec-ID Oracle Object Storage: c85f9425-fb21-426c-ad0b-405e9bd8a46c.

Svar

Ett lyckat svar returnerar anslutnings-ID:t för den nya anslutningen. Detta ID krävs för att du ska kunna utforska dina molnlagringsdata i nästa självstudiekurs.

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}

Nästa steg

Genom att följa den här självstudiekursen har du skapat en Oracle Object Storage-anslutning med API:t Flow Service och har fått dess unika anslutnings-ID. Du kan använda det här anslutnings-ID:t för att utforska molnlagring med API:t för Flow Service.

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