Crear una conexión base Azure Blob utilizando la API Flow Service

Una conexión base representa la conexión autenticada entre un origen y Adobe Experience Platform.

Este tutorial le guía por los pasos para crear una conexión base para Azure Blob (en adelante denominada "Blob") mediante la Flow Service API.

Primeros pasos

Esta guía requiere conocer los siguientes componentes de Adobe Experience Platform:

  • Fuentes: Experience Platform permite la ingesta de datos de varias fuentes, al mismo tiempo que le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Platform.
  • Simuladores para pruebas: Experience Platform proporciona entornos limitados virtuales que dividen una sola instancia de Platform en entornos virtuales independientes para ayudar a desarrollar y desarrollar aplicaciones de experiencia digital.

Las secciones siguientes proporcionan información adicional que deberá conocer para crear correctamente una conexión de origen Blob mediante la API Flow Service.

Recopilar las credenciales necesarias

Para que Flow Service se conecte con su almacenamiento Blob, debe proporcionar valores para la siguiente propiedad de conexión:

Credencial Descripción
connectionString Una cadena que contiene la información de autorización necesaria para autenticarse Blob en el Experience Platform. El patrón de cadena de conexión Blob es: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}. Para obtener más información sobre cadenas de conexión, consulte este Blob documento sobre configuración de cadenas de conexión.
sasUri El URI de firma de acceso compartido que puede utilizar como tipo de autenticación alternativo para conectar su cuenta Blob. El patrón de URI SAS Blob es: 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 obtener más información, consulte este Blob documento sobre URI de firma de acceso compartido.
connectionSpec.id La especificación de conexión devuelve las propiedades del conector de un origen, incluidas las especificaciones de autenticación relacionadas con la creación de las conexiones base y de origen. El ID de especificación de conexión para Blob es: d771e9c1-4f26-40dc-8617-ce58c4b53702.

Uso de las API de plataforma

Para obtener información sobre cómo realizar llamadas correctamente a las API de Platform, consulte la guía de introducción a las API de Platform.

Creación de una conexión base

Una conexión base retiene información entre la fuente y la plataforma, incluidas las credenciales de autenticación de la fuente, el estado actual de la conexión y el ID de conexión base único. El ID de conexión base le permite explorar y navegar archivos desde el origen e identificar los elementos específicos que desea introducir, incluida la información sobre sus tipos de datos y formatos.

Para crear un ID de conexión base, realice una solicitud de POST al extremo /connections y proporcione las credenciales de autenticación Blob como parte de los parámetros de solicitud.

Crear una conexión base Blob utilizando la autenticación basada en cadenas de conexión

Para crear una conexión base Blob utilizando la autenticación basada en cadenas de conexión, realice una solicitud de POST a la API Flow Service al proporcionar su Blob connectionString.

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para Blob mediante autenticación basada en cadenas de conexión:

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: {IMS_ORG}' \
    -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}"
            }
        },
        "connectionSpec": {
            "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
            "version": "1.0"
        }
    }'
Propiedad Descripción
auth.params.connectionString La cadena de conexión necesaria para acceder a los datos del almacenamiento del blob. El patrón de la cadena de conexión Blob es: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.
connectionSpec.id El ID de especificación de la conexión de almacenamiento Blob es: 4c10e202-c428-4796-9208-5f1f5732b1cf

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id). Este ID es necesario en el paso siguiente para crear una conexión de origen.

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

Crear una conexión base Blob utilizando el URI de firma de acceso compartido

Un URI de firma de acceso compartido (SAS) permite una autorización delegada segura en su cuenta Blob. Puede utilizar SAS para crear credenciales de autenticación con distintos grados de acceso, ya que la autenticación basada en SAS permite establecer permisos, fechas de inicio y caducidad, así como disposiciones para recursos específicos.

Para crear una conexión en blob Blob utilizando el URI de firma de acceso compartido, realice una solicitud de POST a la API Flow Service al proporcionar valores para su Blob sasUri.

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para Blob utilizando el URI de firma de acceso compartido:

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: {IMS_ORG}' \
    -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": "SasURIAuthentication",
            "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}>"
            }
        },
        "connectionSpec": {
            "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
            "version": "1.0"
        }
    }'
Propiedad Descripción
auth.params.connectionString El URI SAS necesario para acceder a los datos de su almacenamiento Blob. El patrón de URI SAS Blob es: 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 El ID de especificación de conexión de almacenamiento Blob es: 4c10e202-c428-4796-9208-5f1f5732b1cf

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id). Este ID es necesario en el paso siguiente para crear una conexión de origen.

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

Pasos siguientes

Al seguir este tutorial, ha creado una conexión Blob mediante API y se ha obtenido un ID único como parte del cuerpo de respuesta. Puede utilizar este ID de conexión para explorar las tiendas en la nube mediante la API de servicio de flujo o incorporar datos de parqué mediante la API de servicio de flujo.

En esta página