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 Google Cloud Storage usando la variable Flow Service API.
Esta guía requiere conocer los siguientes componentes de Adobe Experience Platform:
Las secciones siguientes proporcionan información adicional que deberá conocer para conectarse correctamente a una cuenta de Google Cloud Storage mediante la Flow Service API.
Para Flow Service para conectarse con su Google Cloud Storage debe proporcionar valores para las siguientes propiedades de conexión:
Credencial | Descripción |
---|---|
accessKeyId |
Una cadena alfanumérica de 61 caracteres que se usa para autenticar su Google Cloud Storage a Platform. |
secretAccessKey |
Una cadena de 40 caracteres codificada en base a 64 que se usa para autenticar su Google Cloud Storage a Platform. |
Para obtener más información sobre estos valores, consulte la Claves HMAC de Google Cloud Storage guía. Para ver los pasos sobre cómo generar su propio ID de clave de acceso y clave de acceso secreta, consulte la Google Cloud Storage información general.
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.
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 /connections
al proporcionar su Google Cloud Storage credenciales de autenticación como parte de los parámetros de solicitud.
Formato de API
POST /connections
Solicitud
La siguiente solicitud crea una conexión base para Google Cloud Storage:
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": "Google Cloud Storage connection",
"description": "Connector for Google Cloud Storage",
"auth": {
"specName": "Basic Authentication for google-cloud",
"params": {
"accessKeyId": "accessKeyId",
"secretAccessKey": "secretAccessKey"
}
},
"connectionSpec": {
"id": "32e8f412-cdf7-464c-9885-78184cb113fd",
"version": "1.0"
}
}'
Propiedad | Descripción |
---|---|
auth.params.accessKeyId |
El ID de clave de acceso asociado con su Google Cloud Storage cuenta. |
auth.params.secretAccessKey |
La clave de acceso secreta asociada a su Google Cloud Storage cuenta. |
connectionSpec.id |
La variable Google Cloud Storage id. de especificación de conexión: 32e8f412-cdf7-464c-9885-78184cb113fd |
Respuesta
Una respuesta correcta devuelve detalles de la conexión recién creada, incluido su identificador único (id
). Este ID es necesario para explorar los datos del almacenamiento en la nube en el siguiente tutorial.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}
Al seguir este tutorial, ha creado un Google Cloud Storage se obtuvo una conexión mediante API y 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.