Documentatie Experience Platform Handleiding Source-connectors

Verbind Azure Blob Storage met Experience Platform gebruikend API

Laatst bijgewerkt: 24 mei 2026

Onderwerpen:
Sources

Gemaakt voor:

Developer

Lees deze gids om te leren hoe te om uw Azure Blobg Storage rekening met Adobe Experience Platform te verbinden gebruikend Flow Service API .

Aan de slag

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

Bronnen : Met Experience Platform kunt u gegevens uit verschillende bronnen innemen en binnenkomende gegevens structureren, labelen en verbeteren met behulp van Experience Platform-services.
Sandboxes : Experience Platform biedt virtuele sandboxen die één Experience Platform-instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.

Experience Platform API’s gebruiken

Voor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken, zie de gids op begonnen wordt met Experience Platform APIs .

Vereiste referenties verzamelen

Lees het Azure Blob Storage overzicht voor informatie over authentificatie.

Sluit uw Azure Blob Storage -account aan op Experience Platform connect

Lees de onderstaande stappen voor informatie over hoe u uw Azure Blob Storage -account kunt verbinden met Experience Platform.

Een basisverbinding maken

NOTE

Nadat u een Azure Blob Storage basisverbinding hebt gemaakt, kunt u het verificatietype niet wijzigen. Als u het verificatietype wilt wijzigen, moet u een nieuwe basisverbinding maken.

Een basisverbinding koppelt uw bron aan Experience Platform, die authentificatiedetails, verbindingsstatus, en een unieke identiteitskaart opslaat. Met deze id kunt u door bronbestanden bladeren en specifieke items identificeren die u wilt invoeren, inclusief de gegevenstypen en indelingen.

U kunt uw Azure Blob Storage -account verbinden met Experience Platform door de volgende verificatietypen te gebruiken:

de belangrijkste authentificatie van de Rekening: Gebruikt de toegangssleutel van de opslagaccount voor verificatie en verbinding met uw Azure Blob Storage -account.
Gedeelde toegangshandtekening (SAS): Gebruikt een SAS-URI om gedelegeerde, beperkte toegang tot bronnen in uw Azure Blob Storage -account te bieden.
de hoofd gebaseerde authentificatie van de Dienst: Gebruikt een Azure Active Directory (AAD) service principal (client-id en geheim) om veilig te verifiëren bij uw Azure Blob Storage-account.

API formaat

POST /connections

Om een identiteitskaart van de basisverbinding tot stand te brengen, doe een POST- verzoek aan het /connections eindpunt en verstrek uw authentificatiegeloofsbrieven als deel van de verzoekparameters.

de belangrijkste authentificatie van de Rekening

Geef waarden op voor uw connectionString , container en folderPath om verificatie met de accountsleutel te gebruiken.

code language-shell

code language-shell
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": "Azure Blob Storage connection using connectingString", "description": "Azure Blob Storage connection using connectionString", "auth": { "specName": "ConnectionString", "params": { "connectionString": "DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}", "container": "acme-blob-container", "folderPath": "/acme/customers/salesData" } }, "connectionSpec": { "id": "4c10e202-c428-4796-9208-5f1f5732b1cf", "version": "1.0" } }'

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": "Azure Blob Storage connection using connectingString",
    "description": "Azure Blob Storage connection using connectionString",
    "auth": {
      "specName": "ConnectionString",
      "params": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}",
        "container": "acme-blob-container",
        "folderPath": "/acme/customers/salesData"
      }
    },
    "connectionSpec": {
      "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
      "version": "1.0"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parameter	Beschrijving
`connectionString`	De verbindingstekenreeks voor uw Azure Blob Storage -account. Het patroon van de verbindingstekenreeks is: `DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY};EndpointSuffix=core.windows.net`.
`container`	De naam van de Azure Blob Storage -container waarin uw gegevensbestanden zijn opgeslagen.
`folderPath`	Het pad binnen de opgegeven container waarin de bestanden zich bevinden.
`connectionSpec.id`	De verbindingsspecificatie-id van de Azure Blob Storage -bron. Deze id is vast als: `4c10e202-c428-4796-9208-5f1f5732b1cf`.

Gedeelde toegangshandtekening

Als u een handtekening voor gedeelde toegang wilt gebruiken, geeft u waarden op voor de tekens sasUri, container en folderPath .

code language-shell

code language-shell
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": "Azure Blob Storage source connection using SAS URI", "description": "Azure Blob Storage source connection using SAS URI", "auth": { "specName": "SAS URI Authentication", "params": { "sasUri": "https://{ACCOUNT_NAME}.blob.core.windows.net/?sv={STORAGE_VERSION}&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}>", "container": "acme-blob-container", "folderPath": "/acme/customers/salesData" } }, "connectionSpec": { "id": "4c10e202-c428-4796-9208-5f1f5732b1cf", "version": "1.0" } }'

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": "Azure Blob Storage source connection using SAS URI",
    "description": "Azure Blob Storage source connection using SAS URI",
    "auth": {
      "specName": "SAS URI Authentication",
      "params": {
        "sasUri": "https://{ACCOUNT_NAME}.blob.core.windows.net/?sv={STORAGE_VERSION}&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}>",
        "container": "acme-blob-container",
        "folderPath": "/acme/customers/salesData"
      }
    },
    "connectionSpec": {
      "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
      "version": "1.0"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parameter	Beschrijving
`sasUri`	De URI van de handtekening voor gedeelde toegang die u kunt gebruiken als alternatief verificatietype om uw account te verbinden. Het patroon van SAS URI is: `https://{ACCOUNT_NAME}.blob.core.windows.net/?sv={STORAGE_VERSION}&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}`.
`container`	De naam van de Azure Blob Storage -container waarin uw gegevensbestanden zijn opgeslagen.
`folderPath`	Het pad binnen de opgegeven container waarin de bestanden zich bevinden.
`connectionSpec.id`	De verbindingsspecificatie-id van de Azure Blob Storage -bron. Deze id is vast als: `4c10e202-c428-4796-9208-5f1f5732b1cf`.

de dienst belangrijkste gebaseerde authentificatie

Om via de dienst belangrijkste gebaseerde authentificatie te verbinden, verstrek waarden voor uw: serviceEndpoint , servicePrincipalId , servicePrincipalKey , accountKind , tenant , container en folderPath .

code language-shell

code language-shell
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": "Azure Blob Storage source connection using service principal based authentication", "description": "Azure Blob Storage source connection using service principal based authentication", "auth": { "specName": "Service Principal Based Authentication", "params": { "serviceEndpoint": "{SERVICE_ENDPOINT}", "servicePrincipalId": "{SERVICE_PRINCIPAL_ID}", "servicePrincipalKey": "{SERVICE_PRINCIPAL_KEY}", "accountKind": "{ACCOUNT_KIND}", "tenant": "{TENANT}", "container": "acme-blob-container", "folderPath": "/acme/customers/salesData" } }, "connectionSpec": { "id": "4c10e202-c428-4796-9208-5f1f5732b1cf", "version": "1.0" } }'

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": "Azure Blob Storage source connection using service principal based authentication",
    "description": "Azure Blob Storage source connection using service principal based authentication",
    "auth": {
      "specName": "Service Principal Based Authentication",
      "params": {
        "serviceEndpoint": "{SERVICE_ENDPOINT}",
        "servicePrincipalId": "{SERVICE_PRINCIPAL_ID}",
        "servicePrincipalKey": "{SERVICE_PRINCIPAL_KEY}",
        "accountKind": "{ACCOUNT_KIND}",
        "tenant": "{TENANT}",
        "container": "acme-blob-container",
        "folderPath": "/acme/customers/salesData"
      }
    },
    "connectionSpec": {
      "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
      "version": "1.0"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
Parameter	Beschrijving
`serviceEndpoint`	Het eindpunt-URL van uw Azure Blob Storage -account. Doorgaans in de notatie: `https://{ACCOUNT_NAME}.blob.core.windows.net`.
`servicePrincipalId`	De client-/toepassings-id van de Azure Active Directory (AAD) service principal die voor verificatie wordt gebruikt.
`servicePrincipalKey`	Het clientgeheim of wachtwoord dat aan de Azure-serviceprincipal is gekoppeld.
`accountKind`	Het type van uw Azure Blob Storage account. Veelvoorkomende waarden zijn `Storage` (general purpose V1), `StorageV2` (general purpose V2), `BlobStorage` en `BlockBlobStorage` .
`tenant`	De Azure Active Directory (AAD) huurder-id waar de serviceprincipal is geregistreerd.
`container`	De naam van de Azure Blob Storage -container waarin uw gegevensbestanden zijn opgeslagen.
`folderPath`	Het pad binnen de opgegeven container waarin de bestanden zich bevinden.
`connectionSpec.id`	De verbindingsspecificatie-id van de Azure Blob Storage -bron. Deze id is vast als: `4c10e202-c428-4796-9208-5f1f5732b1cf`.

Een succesvolle reactie keert details van de pas gecreëerde basisverbinding, met inbegrip van zijn uniek herkenningsteken (id) terug. Deze id is vereist in de volgende stap om een bronverbinding te maken.

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}

Volgende stappen

Door deze zelfstudie te volgen, hebt u een Blob -verbinding gemaakt met behulp van API’s en is een unieke id verkregen als onderdeel van de hoofdtekst van de reactie. U kunt deze verbindingsidentiteitskaart gebruiken om wolkenopslag te onderzoeken gebruikend de Dienst API van de Stroom .

recommendation-more-help

experience-platform-help-sources