Cómo utilizar App Connect con IBM Cloud Object Storage S3

IBM Cloud Object Storage S3 Es una plataforma altamente disponible, duradera y segura para almacenar datos no estructurados.

La siguiente información describe cómo utilizar App Connect para conectar IBM Cloud Object Storage S3 a sus otras aplicaciones.

Versiones de productos y API compatibles

Para saber qué versiones de productos y API admite este conector, consulte los requisitos detallados del sistema en la página de asistencia de IBM.

Conexión con IBM Cloud Object Storage

Seleccione el método de autorización adecuado para el tipo de autenticación que utiliza su instancia del servicio IBM Cloud Object Storage S3. Para obtener más información, consulte Qué hay que tener en cuenta primero.

Si su instancia de servicio utiliza la autenticación de Identity and Access Management (IAM) de IBM Cloud®, seleccione Proporcionar credenciales para que las utilic App Connect (BASIC IAM) y proporcione los siguientes detalles de conexión.
- El punto final URL es el punto final del servicio Cloud Object Storage URL (solo público) para su ubicación o región.
- La clave API es la clave API para el ID del servicio Cloud Object Storage.
- El ID de instancia de recurso es el identificador único de la instancia de Cloud Object Storage.
Si su instancia de servicio utiliza credenciales HMAC para la autenticación, seleccione Proporcionar credenciales para que las utilic App Connect (BASIC) y proporcione los siguientes datos de conexión.
- El punto final URL es el punto final del servicio Cloud Object Storage URL (solo público) para su ubicación o región.
- La clave de acceso secreta es la clave de acceso secreta de la instancia.
- La ID de clave de acceso es la ID de clave de acceso de la instancia.
- La región es la región de la instancia.
- La clave API es la clave API de la instancia si la instancia del servicio utiliza la autenticación de Identity and Access Management (IAM).
- ID de instancia de recurso: es el ID de instancia de recurso de la instancia si la instancia de servicio utiliza la autenticación de Identity and Access Management (IAM).

Consejo: Para una conexión a IBM Cloud Object Storage S3, puede acceder a los depósitos específicos de la ubicación (o región) del punto final URL que haya especificado. Por ejemplo, si se conecta a la ubicación us-geo (como el punto final URL s3.us.cloud-object-storage.appdomain.cloud), puede acceder a los buckets que aparecen con la ubicación us-geo en la página Buckets de su instancia de IBM Cloud Object Storage. Si desea que App Connect acceda a buckets desde más de una ubicación, cree una conexión independiente para cada ubicación.

El siguiente ejemplo muestra los campos completados para conectarse desde App Connect utilizando la autenticación IAM.
Figura 1. Ejemplo de detalles de conexión IBM Cloud Object Storage

Puede encontrar los valores de conexión en las páginas Endpoint y Credenciales del servicio para la instancia del servicio en IBM Cloud.

Inicie la sesión en IBM Cloud.
En el panel IBM Cloud, haga clic en la instancia de servicio Cloud Object Storage con la que desee trabajar.
Para ver las URL de los puntos finales, haga clic en Punto final y seleccione su ubicación o región preferida.
- Si su instancia de servicio utiliza autenticación IAM, copie y pegue su punto final público preferido (por ejemplo, s3.us.cloud-object-storage.appdomain.cloud ) en el campo URL del punto final App Connect.
- Si su instancia de servicio admite la autenticación HMAC, copie y pegue su punto final público preferido (por ejemplo, s3.us.cloud-object-storage.appdomain.cloud) en el campo Punto final de App Connect URL. A continuación, copie y pegue su localidad o región preferida (por ejemplo, us-geo) en el campo App Connect Región.
  Figura 2. IBM Cloud Object Storage página de puntos finales de servicio
Para ver las credenciales del servicio, haga clic en Credenciales del servicio y expanda la lista de credenciales. (Para definir nuevas credenciales que se van a utilizar, haga clic en Nueva credencial )
- Si su instancia de servicio utiliza la autenticación IAM, copie el valor apikey y péguelo en el campo App Connect API key. A continuación, copie el valor resource_instance_id y péguelo en el campo ID de instancia de recurso App Connect.
  Figura 3. IBM Cloud Object Storage página de credenciales
- Si su instancia de servicio admite la autenticación HMAC, copie el cos_hmac_keys/secret_access_key valor y péguelo en el campo Clave de acceso secreta de App Connect. A continuación, copie el valor cos_hmac_keys/access_key_id y péguelo en el campo ID de la clave de acceso App Connect.
  Nota: Para obtener los valores de la clave de acceso secreta y la ID de la clave de acceso, primero debe crear una credencial con la opción de generar credenciales HMAC. (Cuando añadas una credencial, especifícala {"HMAC":true} en el campo Añadir parámetros de configuración en línea (opcional).
  
  Para obtener más información sobre cómo crear y administrar credenciales de servicio, consulte «Credenciales de servicio» en la documentación de IBM Cloud / Cloud Object Storage.
  
  Figura 4. IBM Cloud Object Storage ficha credenciales de servicio

Para conectarse por primera vez a un punto final IBM Cloud Object Storage S3 desde la página Conectar > Aplicaciones y API (antes llamada página Catálogo ) de App Connect Designer, expanda IBM Cloud Object Storage S3 y, a continuación, haga clic en Conectar. Para más información, consulte Gestión de cuentas.

Consejo:

Si no tienes una cuenta IBM Cloud Object Storage S3, puedes crear una para probar IBM Cloud Object Storage de forma gratuita.

Antes de utilizar la cuenta creada en App Connect en un flujo, cambie el nombre de la cuenta por algo significativo que le ayude a identificarla. Para cambiar el nombre de la cuenta en la página Aplicaciones y API, seleccione la cuenta, abra su menú de opciones (⋮) y, a continuación, haga clic en Cambiar nombre de cuenta.

Qué hay que tener en cuenta primero

Antes de utilizar App Connect Designer con IBM Cloud Object Storage, tenga en cuenta las siguientes consideraciones:

IBM Cloud Object Storage S3 Las cuentas creadas en un entorno en la nube admiten una comprobación de reclamación. Consulte la tabla siguiente para conocer los límites de comprobación de reclamaciones para cada método de autorización.
Tabla 1. Límites de comprobación de siniestros IAM y BASIC

Métodos de autorización Descarga de archivos (MB) Carga de archivos (MB)

IAM 50 50

BÁSICA 50 10

Restricción: La comprobación de reclamaciones no es compatible con IBM Cloud Object Storage S3 cuentas en un entorno de contenedor.
Para las siguientes acciones ACL, la política de acceso a recursos IAM de su instancia de IBM Cloud Object Storage debe tener la función de administrador.
Grupo
- Crear ACL personalizadas para el cubo
- Crear ACL estándar para el cubo
Objecto
- Crear ACL personalizadas para el objeto
- Crear ACL estándar para el objeto
- Recuperar ACL para objetos
La política de acceso a recursos de IAM se define para las credenciales de servicio que se utilizan para conectarse a la instancia de servicio. Puede comprobar y configurar la política de acceso en los ID de servicio.
1. En la lista Service IDs, haga clic en el nombre de la clave API de IAM de sus credenciales de servicio. Puede comprobar la fila comparando la descripción con el iam_api_key_description valor de sus credenciales de servicio.
  Este paso muestra la página ID del servicio para las credenciales del servicio.
2. En la página ID del servicio, seleccione la pestaña Políticas de acceso. La columna «Función» incluye «Gerente ».
  Para añadir la función de administrador, haga clic en la función existente para editar la política de acceso de las credenciales del servicio, seleccione la casilla Administrador y, a continuación, haga clic en Guardar. La página ID del servicio se muestra con la función de administrador en la columna Función.
(Consideración general) Puede ver listas de los eventos y acciones desencadenantes que están disponibles en la página Aplicaciones y API del Diseñador de App Connect.
Para algunas aplicaciones, los eventos y acciones dependen del entorno y de si el conector admite eventos configurables y descubrimiento dinámico de acciones. Si la aplicación admite eventos configurables, verá un enlace Mostrar más eventos configurables bajo la lista de eventos. Si la aplicación admite la detección dinámica de acciones, verá un enlace Mostrar más debajo de la lista de acciones.
(Consideración general) Si utiliza varias cuentas para una aplicación, el conjunto de campos que se muestra al seleccionar una acción para esa aplicación puede variar para las distintas cuentas. En el editor de flujo, algunas aplicaciones siempre proporcionan un conjunto curado de campos estáticos para una acción. Otras aplicaciones utilizan la detección dinámica para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta podría utilizar configuraciones listas para su uso inmediato. Sin embargo, la segunda cuenta puede estar configurada con campos personalizados adicionales.

Tabla 1. Límites de comprobación de siniestros IAM y BASIC
Métodos de autorización	Descarga de archivos (MB)	Carga de archivos (MB)
IAM	50	50
BÁSICA	50	10

Eventos y acciones

IBM Cloud Object Storage S3 eventos

Estos eventos son para cambios en esta aplicación que desencadenan un flujo para empezar a completar las acciones en el flujo.

Nota: Los eventos no están disponibles para cambios en esta aplicación. Puede activar un flujo de otras formas, como a un intervalo programado o en fechas y horas concretas.

IBM Cloud Object Storage S3 acciones

Su flujo completa estas acciones en esta aplicación.

Objecto	Acción	Descripción
Grupo	Crear grupo	Crear un bucket que pertenezca a una cuenta de IBM Cloud Object Storage S3
	Crear ACL personalizada para el depósito	Establecer el permiso de acceso para un depósito que se aplicará a usuarios específicos
	Crear ACL estándar para el depósito	Establecer el permiso de acceso para un depósito que se aplicará a todos los usuarios
	Recuperar todos los cubos	Recuperar detalles de una colección de buckets perteneciente a una cuenta de IBM Cloud Object Storage S3 junto con su lista de control de acceso
	Recuperar cubos	Recuperar detalles de los buckets que pertenecen a una cuenta de IBM Cloud Object Storage S3
CORS	Crear una configuración de « CORS » para el bucket.	Crear o actualizar una configuración de intercambio de recursos entre orígenes ( CORS ) para un depósito
	Eliminar la configuración de CORS para el depósito	Eliminar una configuración de intercambio de recursos entre orígenes ( CORS ) para un depósito
	Recuperar la configuración de CORS para los buckets.	Recuperar la configuración de intercambio de recursos entre orígenes ( CORS ) para los depósitos
Objecto	Crear ACL personalizada para objeto	Establecer el permiso de acceso para un objeto que se aplicará a usuarios específicos
	Crear objeto	Crear un objeto en un bucket de IBM Cloud Object Storage S3
	Crear ACL estándar para objeto	Establecer el permiso de acceso para un objeto que se aplique a todos los usuarios
	Suprimir objeto	Eliminar un objeto de un bucket de IBM Cloud Object Storage S3
	Descargar objeto	Descargar objeto de un bucket de IBM Cloud Object Storage S3
	Recuperar ACL para objetos	Recuperar las listas de control de acceso para los objetos IBM Cloud Object Storage S3
	Recuperar todos los objetos	Recuperar todos los objetos de todos los buckets junto con sus listas de control de acceso
	Recuperar objetos	Recuperar objetos pertenecientes a una cuenta de IBM Cloud Object Storage S3
	Recuperar objetos por marcador	Recuperar objetos por marcador de un bucket de IBM Cloud Object Storage S3
	Actualizar objeto	Actualizar un objeto en un bucket de IBM Cloud Object Storage S3
Buscar objetos	Recuperar objeto por prefijo y delimitador	Recuperar un objeto por prefijo y delimitador de un bucket de IBM Cloud Object Storage S3

Ejemplos

Mosaico del salpicadero para una plantilla que utiliza IBM Cloud Object Storage S3

Utilice plantillas para crear rápidamente flujos para IBM Cloud Object Storage S3

Aprenda a utilizar App Connect plantillas para crear rápidamente flujos que completen acciones en IBM Cloud Object Storage S3. Por ejemplo, ve a la página Descubrir y busca IBM Cloud Object Storage S3.

Más información