DocumentatieExperience PlatformHandleiding voor bronaansluitingen

Een Oracle Object Storage basisverbinding met de Flow Service API

Last update: Wed Jan 11 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.

Dit leerprogramma begeleidt u door de stappen om een basisverbinding tot stand te brengen voor Oracle Object Storage met de Flow Service API.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:

  • Bronnen: Met Experience Platform kunnen gegevens uit verschillende bronnen worden ingepakt en kunt u inkomende gegevens structureren, labelen en verbeteren met behulp van de services van Platforms.
  • Sandboxen: Experience Platform biedt virtuele sandboxen die één Platform-instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.

De volgende secties bevatten aanvullende informatie die u nodig hebt om verbinding te kunnen maken met Oracle Object Storage met de Flow Service API.

Vereiste referenties verzamelen

Om Flow Service om verbinding te maken met Oracle Object Storagemoet u waarden opgeven voor de volgende eigenschappen van de verbinding:

Credentials
Beschrijving
serviceUrl
De Oracle Object Storage eindpunt dat voor authentificatie wordt vereist. De eindpuntnotatie is: https://{OBJECT_STORAGE_NAMESPACE}.compat.objectstorage.eu-frankfurt-1.oraclecloud.com
accessKey
De Oracle Object Storage toegangssleutel-id vereist voor verificatie.
secretKey
De Oracle Object Storage wachtwoord vereist voor verificatie.
bucketName
De toegestane emmernaam wordt vereist als de gebruiker toegang beperkt heeft. De naam van het emmertje moet tussen drie en 63 karakters lang zijn, moet beginnen en met of een letter of een aantal beëindigen, en kan slechts kleine letters, aantallen, of koppeltekens bevatten (-). De emmernaam kan niet als IP adres worden geformatteerd.
folderPath
Het toegestane mappad dat is vereist als de gebruiker de toegang heeft beperkt.
connectionSpec.id
De verbindingsspecificatie keert de schakelaareigenschappen van een bron, met inbegrip van authentificatiespecificaties met betrekking tot het creëren van de basis en bronverbindingen terug. De verbindingsspecificatie-id voor Oracle Object Storage is: c85f9425-fb21-426c-ad0b-405e9bd8a46c.

Raadpleeg voor meer informatie over het verkrijgen van deze waarden de Handleiding voor verificatie van oracle Object Storage.

Platform-API's gebruiken

Zie de handleiding voor informatie over hoe u aanroepen naar Platform-API's kunt uitvoeren aan de slag met Platform-API's.

Een basisverbinding maken

Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Om een identiteitskaart van de basisverbinding te creëren, doe een verzoek van de POST aan /connections eindpunt terwijl het verstrekken van uw Oracle Object Storage verificatiereferenties als onderdeel van de aanvraagparameters.

API-indeling

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding gemaakt voor 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"
        }
    }'
Eigenschap
Beschrijving
auth.params.serviceUrl
De Oracle Object Storage eindpunt dat voor authentificatie wordt vereist.
auth.params.accessKey
De Oracle Object Storage toegangssleutel-id vereist voor verificatie.
auth.params.secretKey
De Oracle Object Storage wachtwoord vereist voor verificatie.
auth.params.bucketName
De toegestane emmernaam wordt vereist als de gebruiker toegang beperkt heeft.
auth.params.folderPath
Het toegestane mappad dat is vereist als de gebruiker de toegang heeft beperkt.
connectionSpec.id
De Oracle Object Storage verbinding, specificatie-id: c85f9425-fb21-426c-ad0b-405e9bd8a46c.

Antwoord

Een geslaagde reactie retourneert de verbinding-id van de nieuwe verbinding. Deze id is vereist voor het verkennen van uw gegevens voor cloudopslag in de volgende zelfstudie.

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

Volgende stappen

Aan de hand van deze zelfstudie hebt u een Oracle Object Storage verbinding met de Flow Service API, en hebben zijn unieke verbindingsID verkregen. U kunt deze verbindings-id gebruiken om verkennen van cloudopslag met de Flow Service API.

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