Criar um Azure Blob conexão básica usando o Flow Service API

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 básica para Azure Blob (a seguir designado por "Blob") usando o Flow Service API.

Introdução

Este manual necessita de uma compreensão funcional dos seguintes componentes da Adobe Experience Platform:

  • Origens: o Experience Platform permite que os dados sejam assimilados de várias fontes e, ao mesmo tempo, fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços da plataforma.
  • Sandboxes: o Experience Platform fornece sandboxes virtuais que particionam uma única instância da Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.

As seções a seguir fornecem as informações adicionais que você precisará saber para criar uma Blob conexão de origem usando o Flow Service API.

Coletar credenciais necessárias

A fim de Flow Service para se conectar com o seu Blob armazenamento, você deve fornecer valores para a seguinte propriedade de conexão:

Autenticação da cadeia de conexão
table 0-row-2 1-row-2 2-row-2
Credencial Descrição
connectionString Uma cadeia de caracteres que contém as informações de autorização necessárias para autenticação Blob para Experience Platform. A variável Blob o padrão da cadeia de conexão é: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}. Para obter mais informações sobre cadeias de conexão, consulte esta Blob documento ativado 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.
Autenticação URI SAS
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Credencial Descrição
sasUri O URI de assinatura de acesso compartilhado que você pode usar como um tipo de autenticação alternativo para conectar seu Blob conta. A variável Blob O padrão do 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}> Para obter mais informações, consulte esta Blob documento ativado URIs de assinatura de acesso compartilhado.
container O nome do container ao qual você deseja designar acesso. Ao criar uma nova conta com o Blob origem, você pode fornecer um nome de container 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 da plataforma

Para obter informações sobre como fazer chamadas para APIs da Platform com êxito, consulte o manual em introdução às APIs da Platform.

Crie uma conexão básica

TIP
Depois de criado, não é possível alterar o tipo de autenticação de um Blob conexão básica. Para alterar o tipo de autenticação, você deve criar uma nova conexão base.

Uma conexão base retém informações entre sua origem e a Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e sua 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 variável Blob A origem oferece 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 seu Blob conta. 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 um ID de conexão base, faça uma solicitação POST ao /connections ao fornecer sua Blob credenciais de autenticação como parte dos parâmetros de solicitação.

Formato da API

POST /connections

Solicitação

String de conexão

A solicitação a seguir cria uma conexão básica para Blob usando autenticação baseada em cadeia de conexão:

accordion
Solicitação
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 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"
      }
  }'
table 0-row-2 1-row-2 2-row-2
Propriedade Descrição
auth.params.connectionString A cadeia de conexão necessária para acessar dados no armazenamento Blob. O padrão da cadeia de conexão Blob é: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.
connectionSpec.id A ID da especificação da conexão de armazenamento Blob é: 4c10e202-c428-4796-9208-5f1f5732b1cf
accordion
Resposta

Uma 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.

code language-json
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}
Autenticação de URI SAS

Para criar um Blob conexão usando URI de assinatura de acesso compartilhado, faça uma solicitação POST para o Flow Service ao fornecer valores para a sua Blob sasUri.

accordion
Solicitação
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 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"
      }
  }'
table 0-row-2 1-row-2 2-row-2
Propriedade Descrição
auth.params.connectionString O URI SAS necessário para acessar dados em seu Blob armazenamento. A variável Blob O padrão do 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}>.
connectionSpec.id A variável Blob a ID da especificação da conexão de armazenamento é: 4c10e202-c428-4796-9208-5f1f5732b1cf
accordion
Resposta

Uma 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.

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

Próximas etapas

Ao seguir este tutorial, você criou um Blob Uma conexão usando APIs e uma ID exclusiva foi obtida como parte do corpo da resposta. Você pode usar essa ID de conexão para explorar armazenamentos em nuvem usando a API do Serviço de fluxo.

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