Criar uma conexão de base Azure Blob usando a API Flow Service
Criado para:
- Desenvolvedor
Uma conexão base representa a conexão autenticada entre uma origem e o Adobe Experience Platform.
Este tutorial fornece etapas para criar uma conexão base para Azure Blob (a seguir denominada "Blob") usando a Flow Service API.
Introdução
Este manual necessita de uma compreensão funcional dos seguintes componentes da Adobe Experience Platform:
- Fontes: o Experience Platform permite a assimilação de dados de várias fontes, ao mesmo tempo em que fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
- Sandboxes: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
As seções a seguir fornecem informações adicionais que você precisará saber para criar com êxito uma conexão de origem do Blob usando a API Flow Service.
Coletar credenciais necessárias
Para que Flow Service se conecte ao armazenamento Blob, você deve fornecer valores para a seguinte propriedade de conexão:
| Credencial | Descrição |
|---|---|
connectionString | Uma cadeia de caracteres que contém as informações de autorização necessárias para autenticar Blob no Experience Platform. O padrão da cadeia de conexão Blob é: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}. Para obter mais informações sobre cadeias de conexão, consulte este documento Blob em configurando cadeias de conexão. |
connectionSpec.id | A especificação de conexão retorna as propriedades do conector de uma origem, incluindo especificações de autenticação relacionadas à criação das conexões de base e de origem. A ID da especificação de conexão para Blob é: d771e9c1-4f26-40dc-8617-ce58c4b53702. |
| Credencial | Descrição |
|---|---|
sasUri | O URI de assinatura de acesso compartilhado que você pode usar como um tipo de autenticação alternativo para conectar sua conta do Blob. O padrão do URI SAS Blob é: 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}> Para obter mais informações, consulte este Blob documento em URIs de assinatura de acesso compartilhado. |
container | O nome do container ao qual você deseja designar acesso. Ao criar uma nova conta com a origem Blob, você pode fornecer um nome de contêiner para especificar o acesso do usuário à subpasta de sua escolha. |
folderPath | O caminho para a pasta à qual você deseja fornecer acesso. |
connectionSpec.id | A especificação de conexão retorna as propriedades do conector de uma origem, incluindo especificações de autenticação relacionadas à criação das conexões de base e de origem. A ID da especificação de conexão para Blob é: d771e9c1-4f26-40dc-8617-ce58c4b53702. |
Uso de APIs do Experience Platform
Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.
Criar uma conexão básica
TIPUma conexão base retém informações entre sua origem e a Experience Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e a ID de conexão base exclusiva. A ID de conexão básica permite explorar e navegar pelos arquivos de dentro da origem e identificar os itens específicos que deseja assimilar, incluindo informações sobre os tipos de dados e formatos.
A origem Blob dá suporte à autenticação de cadeia de conexão e de assinatura de acesso compartilhado (SAS). Um URI de assinatura de acesso compartilhado (SAS) permite uma autorização delegada segura para sua conta Blob. Você pode usar SAS para criar credenciais de autenticação com vários graus de acesso, já que uma autenticação baseada em SAS permite definir permissões, datas de início e expiração, bem como provisões para recursos específicos.
Durante essa etapa, também é possível designar as subpastas às quais sua conta terá acesso definindo o nome do container e o caminho para a subpasta.
Para criar uma ID de conexão base, faça uma solicitação POST para o ponto de extremidade /connections ao fornecer suas credenciais de autenticação Blob como parte dos parâmetros de solicitação.
Formato da API
POST /connections
Solicitação
A solicitação a seguir cria uma conexão base para Blob usando autenticação baseada em cadeia de caracteres de conexão:
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 connection using connectionString",
"description": "Azure Blob 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"
}
}'
auth.params.connectionStringDefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.connectionSpec.id4c10e202-c428-4796-9208-5f1f5732b1cfUma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id). Essa ID é necessária na próxima etapa para criar uma conexão de origem.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}
Para criar uma conexão Blob usando o URI de assinatura de acesso compartilhado, faça uma solicitação POST para a API Flow Service enquanto fornece valores para o Blob sasUri.
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 source connection using SAS URI",
"description": "Azure Blob 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"
}
}'
auth.params.connectionStringhttps://{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}>.connectionSpec.id4c10e202-c428-4796-9208-5f1f5732b1cfUma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id). Essa ID é necessária na próxima etapa para criar uma conexão de origem.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}
Próximas etapas
Seguindo este tutorial, você criou uma conexão Blob usando APIs e uma ID exclusiva foi obtida como parte do corpo da resposta. Você pode usar esta ID de conexão para explorar armazenamentos em nuvem usando a API de Serviço de Fluxo.