Documentazione Experience Platform Guida ai connettori di origini

Connetti Azure Blob Storage ad Experience Platform utilizzando l'API

Last update: Thu Aug 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore

Leggi questa guida per scoprire come collegare il tuo account Azure Blobg Storage a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:

Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Utilizzo delle API di Experience Platform

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, consulta la guida introduttiva alle API di Experience Platform.

Raccogli le credenziali richieste

Per informazioni sull'autenticazione, leggere la Azure Blob Storage panoramica.

Connetti il tuo account Azure Blob Storage ad Experience Platform connect

Per informazioni su come collegare il tuo account Azure Blob Storage ad Experience Platform, leggi i passaggi seguenti.

Creare una connessione di base

NOTE

Una volta creata, non è possibile modificare il tipo di autenticazione di una connessione di base Azure Blob Storage. Per modificare il tipo di autenticazione, è necessario creare una nuova connessione di base.

Una connessione di base collega l’origine ad Experience Platform, memorizzando i dettagli di autenticazione, lo stato della connessione e un ID univoco. Utilizza questo ID per sfogliare i file sorgente e identificare elementi specifici da acquisire, compresi i relativi tipi di dati e formati.

È possibile connettere l'account Azure Blob Storage ad Experience Platform utilizzando i seguenti tipi di autenticazione:

Autenticazione chiave account: utilizza la chiave di accesso dell'account di archiviazione per autenticare e connettersi all'account Azure Blob Storage.
Firma di accesso condiviso (SAS): utilizza un URI SAS per fornire accesso delegato e limitato nel tempo alle risorse nell'account Azure Blob Storage.
Autenticazione basata sull'entità servizio: utilizza un'entità servizio Azure Active Directory (AAD) (ID client e segreto) per l'autenticazione sicura nell'account di archiviazione BLOB di Azure.

Formato API

POST /connections

Per creare un ID connessione di base, effettuare una richiesta POST all'endpoint /connections e fornire le credenziali di autenticazione come parte dei parametri della richiesta.

Autenticazione chiave account

Per utilizzare l'autenticazione della chiave dell'account, fornire i valori per connectionString, container e 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 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
Parametro	Descrizione
`connectionString`	Stringa di connessione per l'account Azure Blob Storage. Schema della stringa di connessione: `DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY};EndpointSuffix=core.windows.net`.
`container`	Nome del contenitore Azure Blob Storage in cui sono archiviati i file di dati.
`folderPath`	Percorso all’interno del contenitore specificato in cui si trovano i file.
`connectionSpec.id`	ID della specifica di connessione dell'origine Azure Blob Storage. Questo ID è corretto come: `4c10e202-c428-4796-9208-5f1f5732b1cf`.

Firma di accesso condiviso

Per utilizzare la firma di accesso condiviso, fornire i valori per sasUri, container e 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
Parametro	Descrizione
`sasUri`	URI della firma di accesso condiviso che è possibile utilizzare come tipo di autenticazione alternativo per connettere l'account. Schema URI SAS: `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`	Nome del contenitore Azure Blob Storage in cui sono archiviati i file di dati.
`folderPath`	Percorso all’interno del contenitore specificato in cui si trovano i file.
`connectionSpec.id`	ID della specifica di connessione dell'origine Azure Blob Storage. Questo ID è corretto come: `4c10e202-c428-4796-9208-5f1f5732b1cf`.

Autenticazione basata su entità servizio

Per connettersi tramite autenticazione basata su entità servizio, fornire valori per: serviceEndpoint, servicePrincipalId, servicePrincipalKey, accountKind, tenant, container e 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
Parametro	Descrizione
`serviceEndpoint`	L'URL dell'endpoint dell'account Azure Blob Storage. In genere nel formato: `https://{ACCOUNT_NAME}.blob.core.windows.net`.
`servicePrincipalId`	ID client/applicazione dell'entità servizio Azure Active Directory (AAD) utilizzata per l'autenticazione.
`servicePrincipalKey`	Il segreto client o la password associata all'entità servizio Azure.
`accountKind`	Il tipo del tuo account Azure Blob Storage. I valori comuni includono `Storage` (finalità generale V1), `StorageV2` (finalità generale V2), `BlobStorage` e `BlockBlobStorage`.
`tenant`	ID tenant di Azure Active Directory (AAD) in cui è registrata l'entità servizio.
`container`	Nome del contenitore Azure Blob Storage in cui sono archiviati i file di dati.
`folderPath`	Percorso all’interno del contenitore specificato in cui si trovano i file.
`connectionSpec.id`	ID della specifica di connessione dell'origine Azure Blob Storage. Questo ID è corretto come: `4c10e202-c428-4796-9208-5f1f5732b1cf`.

In caso di esito positivo, la risposta restituisce i dettagli della connessione di base appena creata, incluso il relativo identificatore univoco (id). Questo ID è necessario nel passaggio successivo per creare una connessione sorgente.

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

Passaggi successivi

Seguendo questa esercitazione, hai creato una connessione Blob utilizzando le API ed è stato ottenuto un ID univoco come parte del corpo della risposta. Puoi usare questo ID connessione per esplorare gli archivi cloud utilizzando l'API del servizio Flusso.

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089