Crear una conexión base Azure Blob mediante la API Flow Service
Creado para:
- Desarrollador
Una conexión base representa la conexión autenticada entre un origen y Adobe Experience Platform.
Este tutorial proporciona los pasos para crear una conexión base para Azure Blob (en adelante denominada "Blob") mediante la Flow Service API.
Introducción
Esta guía requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
- Fuentes: Experience Platform permite la ingesta de datos de varias fuentes al tiempo que le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Experience Platform.
- Zonas protegidas: Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Experience Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Las secciones siguientes proporcionan información adicional que necesitará conocer para crear correctamente una conexión de origen de Blob mediante la API Flow Service.
Recopilar credenciales necesarias
Para que Flow Service se conecte con su almacenamiento de Blob, debe proporcionar valores para la siguiente propiedad de conexión:
| Credencial | Descripción |
|---|---|
connectionString | Cadena que contiene la información de autorización necesaria para autenticar Blob en 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 las cadenas de conexión, consulte este documento de Blob en configuración de cadenas de conexión. |
connectionSpec.id | La especificación de conexión devuelve las propiedades del conector de origen, incluidas las especificaciones de autenticación relacionadas con la creación de las conexiones base y origen. El id. de especificación de conexión para Blob es: d771e9c1-4f26-40dc-8617-ce58c4b53702. |
| Credencial | Descripción |
|---|---|
sasUri | URI de firma de acceso compartido que puede usar como tipo de autenticación alternativo para conectar su cuenta de Blob. El patrón de URI de 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 documento de Blob sobre URI de firma de acceso compartido. |
container | El nombre del contenedor al que desea designar el acceso. Al crear una nueva cuenta con el origen Blob, puede proporcionar un nombre de contenedor para especificar el acceso del usuario a la subcarpeta que elija. |
folderPath | La ruta a la carpeta a la que desea proporcionar acceso. |
connectionSpec.id | La especificación de conexión devuelve las propiedades del conector de origen, incluidas las especificaciones de autenticación relacionadas con la creación de las conexiones base y origen. El id. de especificación de conexión para Blob es: d771e9c1-4f26-40dc-8617-ce58c4b53702. |
Uso de API de Experience Platform
Para obtener información sobre cómo realizar llamadas correctamente a las API de Experience Platform, consulte la guía sobre introducción a las API de Experience Platform.
Crear una conexión base
TIPUna conexión base retiene información entre el origen y Experience Platform, incluidas las credenciales de autenticación del origen, el estado actual de la conexión y el identificador único de la conexión base. El ID de conexión base le permite explorar y navegar por archivos desde el origen e identificar los elementos específicos que desea introducir, incluida la información sobre sus tipos de datos y formatos.
El origen Blob admite la autenticación de cadena de conexión y firma de acceso compartido (SAS). Un URI de firma de acceso compartido (SAS) permite la autorización delegada segura en su cuenta de Blob. Puede utilizar SAS para crear credenciales de autenticación con distintos grados de acceso, ya que la autenticación basada en SAS le permite establecer permisos, fechas de inicio y caducidad, así como disposiciones para recursos específicos.
Durante este paso, también puede designar las subcarpetas a las que tendrá acceso su cuenta definiendo el nombre del contenedor y la ruta de acceso a la subcarpeta.
Para crear un identificador de conexión base, realice una petición POST al extremo /connections y proporcione sus credenciales de autenticación Blob como parte de los parámetros de solicitud.
Formato de API
POST /connections
Solicitud
La siguiente solicitud crea una conexión base para Blob mediante la autenticación basada en cadena 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: {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-5f1f5732b1cfUna respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id). Este ID es necesario en el siguiente paso para crear una conexión de origen.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}
Para crear una conexión de Blob con el URI de firma de acceso compartido, realice una petición POST a la API Flow Service y proporcione los valores para 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-5f1f5732b1cfUna respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id). Este ID es necesario en el siguiente paso para crear una conexión de origen.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}
Pasos siguientes
Siguiendo este tutorial, ha creado una conexión de Blob mediante API y se ha obtenido un ID único como parte del cuerpo de respuesta. Puede usar este identificador de conexión para explorar los almacenes en la nube mediante la API de Flow Service.