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:
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 . |
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
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
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 | ||||||||||
|
accordion | ||
---|---|---|
Resposta | ||
Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (
|
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 | ||||||||||
|
accordion | ||
---|---|---|
Resposta | ||
Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (
|
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.