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

Senast uppdaterad: 4 april 2025
  • Ä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: 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 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:

AutentiseringsuppgifterBeskrivning
serviceUrlSlutpunkten 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.
secretKeyLösenordet Oracle Object Storage krävs för autentisering.
bucketNameDet 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.
folderPathDen tillåtna mappsökväg som krävs om användaren har begränsad åtkomst.
connectionSpec.idAnslutningsspecifikationen 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 dessa värden finns i autentiseringsguiden för Oracle Object Storage.

Använda Experience Platform API:er

Information om hur du kan anropa Experience Platform API:er finns i guiden Komma igång med Experience Platform API:er.

Skapa en basanslutning

En basanslutning bevarar information mellan källan och Experience Platform, inklusive autentiseringsuppgifter för källan, anslutningens aktuella tillstånd 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 basanslutnings-ID skickar du en POST-begäran till /connections-slutpunkten och anger dina Oracle Object Storage-autentiseringsuppgifter 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"
        }
    }'
EgenskapBeskrivning
auth.params.serviceUrlSlutpunkten Oracle Object Storage krävs för autentisering.
auth.params.accessKeyÅtkomstnyckel-ID Oracle Object Storage krävs för autentisering.
auth.params.secretKeyLösenordet Oracle Object Storage krävs för autentisering.
auth.params.bucketNameDet tillåtna bucket-namn som krävs om användaren har begränsad åtkomst.
auth.params.folderPathDen tillåtna mappsökväg som krävs om användaren har begränsad åtkomst.
connectionSpec.idAnslutningens 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\""
}