Consulta los conectores compatibles con Application Integration.

Llamar a una tarea de punto final REST

La tarea Llamar a un punto final REST te permite llamar a cualquier API REST de terceros desde tu integración. La respuesta de la llamada a la API REST estará disponible en una variable de integración y se podrá usar en otras tareas posteriores.

Nota:

• La configuración de red de la tarea Llamar a un endpoint REST le permite llamar a endpoints que solo están disponibles a través de Internet público. Por lo tanto, la tarea no puede conectarse a hosts ni IPs que residan solo en una red privada, como una VPC, aunque esa VPC esté emparejada con otros servicios de Google Cloud, como Apigee X.
• Esta tarea puede procesar un máximo de 50 MB de respuesta REST.

Antes de empezar

• Para conectarte a un endpoint de autenticación para la llamada a la API REST, asegúrate de haber creado un perfil de OAuth 2.0 o de haber asociado una cuenta de servicio gestionada por el usuario a tu integración. Si tu API no requiere autenticación, puedes dejar vacío el campo Perfil de autenticación del panel de configuración de la tarea. Para ver una lista de configuraciones, consulta Propiedades de configuración.

  Si tu integración tiene configurados tanto un perfil de OAuth 2.0 como una cuenta de servicio gestionada por el usuario, se usará el perfil de OAuth 2.0 de forma predeterminada para la autenticación. Si no se configura ningún perfil de OAuth 2.0 ni ninguna cuenta de servicio gestionada por el usuario, la ejecución fallará.

• Si tu integración tiene una cuenta de servicio asociada, otorga el rol de gestión de identidades y accesos necesario a esa cuenta de servicio en función de la URL del endpoint REST. Por ejemplo, si la URL de tu endpoint REST llama a un servicio de Cloud Storage, asigna el rol de IAM necesario para el servicio de Cloud Storage.

  Para obtener información sobre cómo conceder roles a una cuenta de servicio, consulta el artículo sobre cómo gestionar el acceso a cuentas de servicio.

• Asegúrate de que Controles de Servicio de VPC NO esté configurado para la integración de aplicaciones en tu proyecto de Google Cloud .
  Advertencia: Cloud Functions no funciona o deja de funcionar si Controles de Servicio de VPC está configurado para la integración de aplicaciones en tu proyecto de Google Cloud .

Configurar la tarea Llamar a un punto final REST

Para configurar la tarea Llamar a un punto final REST, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración o haga clic en Crear integración para crear una.

   Si vas a crear una integración:

   1. Escribe un nombre y una descripción en el panel Crear integración.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones solo se muestran las regiones aprovisionadas en tu proyecto de Google Cloud. Para aprovisionar una región, haga clic en Habilitar región. Para obtener más información, consulta Habilitar una región nueva.
   3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si ha habilitado la gestión de la integración en la región seleccionada.
   4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.

4. En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
5. Haga clic en el elemento Llamar a un punto final REST y colóquelo en el editor de integraciones.
6. Haz clic en el elemento Llamar a un punto final REST del diseñador para ver el panel de configuración de la tarea Llamar a un punto final REST.
7. Configure los campos que se muestran mediante las propiedades de configuración de la tarea, tal como se detalla en la tabla de abajo.

   Los cambios en las propiedades se guardan automáticamente.

   Nota: Si actualizas el perfil de autenticación de una tarea Llamar a endpoint REST y pruebas la integración sin publicar los cambios, la integración usará el perfil de autenticación anterior. Para asegurarte de que la integración usa el perfil de autenticación actualizado, debes publicar la integración antes de probarla.

Propiedades de configuración

En la siguiente tabla se describen las propiedades de configuración de la tarea Llamar a un endpoint REST.

Propiedad	Data type (Dato)	Descripción
Etiqueta	Cadena	Opcional: añade una etiqueta a la tarea.
Autenticación	Cadena	Opcional: configura y almacena los detalles de autenticación de las conexiones a sistemas externos. Para obtener más información, consulta Crear perfiles de autenticación en Application Integration.
URL base del endpoint	Cadena	URL del endpoint REST sin los parámetros de consulta.
Método HTTP	N/A	Método HTTP que se va a usar. Puede seleccionar cualquiera de los siguientes métodos HTTP: ELIMINAR GET HEAD PARCHE POST PUT
Parámetros de cadena de consulta de URL	Clave de cadena de consulta : cadena Valor: String	Parámetros de consulta necesarios para la llamada a la API REST. Los parámetros de consulta tienen la forma de pares clave-valor, donde la clave es el nombre de la clave y el valor es el valor de la clave correspondiente. Puede introducir más de un par clave-valor haciendo clic en el icono del signo más.
Encabezados HTTP	Clave de encabezado HTTP: cadena Valor: String	Encabezados HTTP necesarios para la llamada a la API REST. Los encabezados HTTP tienen la forma de pares clave-valor, donde la clave es el nombre de la clave y el valor es el valor de la clave correspondiente. Puedes introducir más de un par clave-valor haciendo clic en el icono del signo más.
Seguir redirecciones	Booleano	Sigue las redirecciones de URL. Puedes seleccionar cualquiera de los valores: True: llama a la URL redirigida si la URL base del endpoint se reenvía a otra URL. False: no llama a la URL redirigida si la URL base del endpoint se reenvía a otra URL.
La tarea debería fallar debido a un error HTTP	Booleano	Estrategia de gestión de excepciones cuando falla la llamada a la API REST. La tarea Llamar a un endpoint REST falla si el código de respuesta HTTP es 4xx o 5xx. Para ver una lista de códigos de error, consulta Códigos de error. En el caso de otros códigos de respuesta HTTP, devuelve el código y el mensaje de error en la respuesta. Nota: Si los errores no están relacionados con la llamada a la API REST (por ejemplo, si la URL es incorrecta), la tarea siempre fallará, independientemente del valor de esta opción. Puedes seleccionar cualquiera de los valores: True: genera una excepción. False: no genera una excepción. Sin embargo, devuelve el código de error y el mensaje de error en la respuesta.
Encabezado de respuesta (<Nombre de la tarea>)	Cadena	Encabezado de respuesta sin comprimir de la respuesta de las APIs REST.
Cuerpo de la respuesta (<Nombre de la tarea>)	Cadena	Cuerpo de respuesta sin comprimir de la respuesta de las APIs REST.
Estado de la respuesta (<Nombre de la tarea>)	Cadena	Código de respuesta HTTP y el texto del código correspondiente de la respuesta de las APIs REST.

Prácticas recomendadas

Para obtener información sobre los límites de uso que se aplican a la tarea Llamar a un punto final REST, consulta Límites de uso.

Estrategia de gestión de errores

Una estrategia de gestión de errores de una tarea especifica la acción que se debe llevar a cabo si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de gestión de errores y conocer los diferentes tipos de estrategias de gestión de errores, consulta Estrategias de gestión de errores.

Para saber cómo gestionar las estrategias de reintento de errores 4xx o 5xx, consulta la entrada de blog Cómo reintentar la tarea Rest Caller en función del estado de la respuesta.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

Siguientes pasos

• Consulta información sobre todas las tareas y los activadores.
• Consulta cómo probar y publicar una integración.
• Consulta información sobre la gestión de errores.
• Consulta información sobre los registros de ejecución de integraciones.