Anslut Azure Blob Storage till Experience Platform med API:t
Skapat för:
- Utvecklare
Läs den här vägledningen när du vill lära dig hur du ansluter ditt Azure Blobg Storage-konto till Adobe Experience Platform 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.
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.
Samla in nödvändiga inloggningsuppgifter
Läs Azure Blob Storage översikten om du vill ha information om autentisering.
Anslut ditt Azure Blob Storage-konto till Experience Platform
Läs stegen nedan om du vill ha information om hur du ansluter ditt Azure Blob Storage-konto till Experience Platform.
Skapa en basanslutning
En basanslutning länkar källan till Experience Platform, lagrar autentiseringsinformation, anslutningsstatus och ett unikt ID. Använd detta ID för att bläddra bland källfiler och identifiera specifika objekt som ska importeras, inklusive deras datatyper och format.
Du kan ansluta ditt Azure Blob Storage-konto till Experience Platform med följande autentiseringstyper:
- Verifiering av kontonyckel: Lagringskontots åtkomstnyckel används för att autentisera och ansluta till ditt Azure Blob Storage-konto.
- Delad åtkomstsignatur (SAS): Använder en SAS-URI för att ge delegerad, tidsbegränsad åtkomst till resurser i ditt Azure Blob Storage-konto.
- Tjänsthuvudbaserad autentisering: Använder ett Azure Active Directory-tjänstens huvudnamn (AAD) (klient-ID och hemlighet) för att autentisera på ditt Azure Blob Storage-konto på ett säkert sätt.
API-format
POST /connections
Om du vill skapa ett basanslutnings-ID skapar du en POST-begäran till slutpunkten /connections
och anger dina autentiseringsuppgifter som en del av parametrarna för begäran.
Ange värden för connectionString
, container
och folderPath
om du vill använda kontonyckelautentisering.
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"
}
}'
connectionString
DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY};EndpointSuffix=core.windows.net
.container
folderPath
connectionSpec.id
4c10e202-c428-4796-9208-5f1f5732b1cf
.Om du vill använda signatur för delad åtkomst anger du värden för sasUri
, container
och folderPath
.
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"
}
}'
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
folderPath
connectionSpec.id
4c10e202-c428-4796-9208-5f1f5732b1cf
.Om du vill ansluta via huvudbaserad autentisering anger du värden för: serviceEndpoint
, servicePrincipalId
, servicePrincipalKey
, accountKind
, tenant
, container
och folderPath
.
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"
}
}'
serviceEndpoint
https://{ACCOUNT_NAME}.blob.core.windows.net
.servicePrincipalId
servicePrincipalKey
accountKind
Storage
(allmänt syfte V1), StorageV2
(allmänt syfte V2), BlobStorage
och BlockBlobStorage
.tenant
container
folderPath
connectionSpec.id
4c10e202-c428-4796-9208-5f1f5732b1cf
.Ett godkänt svar returnerar information om den nya basanslutningen, inklusive dess unika identifierare (id
). Detta ID krävs i nästa steg för att skapa en källanslutning.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}
Nästa steg
Genom att följa den här självstudiekursen har du skapat en Blob-anslutning med API:er och ett unikt ID har hämtats som en del av svarstexten. Du kan använda det här anslutnings-ID:t för att utforska molnlagring med API:t för Flow Service.