Documentación de Oracle Cloud Infrastructure

Creación de una tarea de REST

Una tarea de REST en Data Integration permite llamar a un punto final de la API de REST mediante el protocolo HTTP.

Permite crear una tarea de REST en un proyecto o una carpeta. Data Integration incluye un proyecto por defecto para empezar. Para crear otros proyectos o carpetas, consulte Proyectos y carpetas.

En Data Integration, por defecto, puede tener ejecuciones de tareas simultáneas o paralelas de una tarea en un momento determinado. Para no permitir ejecuciones de tareas simultáneas iniciadas manualmente, seleccione la casilla de control Desactivar ejecución simultánea de la tarea al crear la tarea. Cuando no se permiten ejecuciones de tareas simultáneas, una solicitud de ejecución para la tarea falla si ya hay una ejecución de tarea en curso que está en un estado no terminal.

  • La interfaz de usuario de configuración contiene cuatro secciones en las que se proporciona la API de REST y los detalles de autenticación para la tarea, se proporcionan valores de parámetros opcionales en el ámbito de la tarea y se comprueban los errores y las advertencias.

    Los pasos de cada sección del siguiente procedimiento también se pueden utilizar al editar una tarea de REST.

    1. En la página Tareas del proyecto o carpeta en el que desea crear una tarea, seleccione Crear tarea y, a continuación, seleccione REST. Si necesita ayuda para buscar la página Tareas en un proyecto o carpeta, consulte Listado de tareas.
    2. En la página Crear tarea de REST, introduzca un nombre y una descripción opcional.

      El identificador es un valor generado por el sistema basado en el nombre. Puede cambiar el valor, pero después de crear y guardar la tarea, no puede actualizar el identificador.

    3. Seleccione la casilla de control Desactivar Ejecución Simultánea de la Tarea si desea no permitir ejecuciones simultáneas de esta tarea.
    4. (Opcional) En Proyecto o carpeta, haga clic en Seleccionar y seleccione un proyecto o una carpeta diferentes en los que guardar la tarea.
    5. Para guardar la tarea por primera vez, seleccione uno de los siguientes botones:

      • Crear: crea y guarda la tarea. Puede seguir creando y editando la tarea.

      • Crear y cerrar: crea y guarda la tarea, cierra la página y le devuelve a la lista de tareas de la página de detalles de proyecto o carpeta.

    6. Guarde periódicamente mientras trabaja seleccionando uno de los siguientes botones:

      • Guardar: confirma los cambios desde la última vez que se guardó. Puede continuar editando después de guardar.

      • Guardar y cerrar: confirma los cambios, cierra la página y le devuelve a la lista de tareas de la página de detalles del proyecto o carpeta.

      • Guardar como: confirma los cambios (desde la última vez que se guardó) y guarda una copia en lugar de sobrescribir la tarea actual. Puede proporcionar un nombre para la copia y seleccionar otro proyecto o carpeta para la copia o guardar la copia en el mismo proyecto o carpeta que la tarea existente.

    7. En la sección Detalles de API de REST, seleccione Configurar.

      En la página Configurar detalles de API de REST que aparece, proporcione los detalles de ejecución de la API de REST y los criterios de finalización (condición correcta) para una llamada de REST correcta.

      1. Siga estos pasos para definir los detalles de ejecución de la API de REST:
        1. especifique el método HTTP y la URL de REST.
        2. (Opcional) Configure any URL parameters.
        3. Agregue una cabecera de solicitud de REST.
        4. (Opcional) Agregue un parámetro de tarea para el valor de la cabecera de REST.
        5. En un método HTTP POST o PUT, agregue el cuerpo de la solicitud.
        6. (Opcional) Agregue un parámetro de tarea para todo el cuerpo de la solicitud.
        7. Para mostrar la URL REST que ha configurado, seleccione Mostrar URL De Vista Previa.
        8. Seleccione Next (Siguiente).
      2. Para especificar los criterios para que la ejecución de la API de REST se realice correctamente, edite la condición correcta por defecto que se proporciona en la sección Condiciones.
      3. Si la API de REST llama a una operación de larga ejecución, además de la condición correcta, active la casilla de control Configurar una condición de sondeo y de terminación para una llamada de REST sin espera y especifique los detalles necesarios para una configuración de sondeo (comportamiento asíncrono). Consulte Especificación de los criterios de finalización mediante sondeo.
      4. Seleccione Configurar.

        Volverá a la página Crear tarea de REST o Tarea de REST: <task name>.

    8. En la sección Autenticación, seleccione Configurar. En el panel Configurar autenticación que aparece, especifique el método de autenticación para ejecutar el punto final de la API de REST. Por defecto, no se necesita ningún método de autenticación.
    9. (Opcional) En la sección Parámetros, seleccione Configurar. En la página Parámetros de tareas de REST que aparece, vea y edite valores para los parámetros que están disponibles en el ámbito de esta tarea de la REST.
    10. (Opcional) En la sección Validar tarea, seleccione Validar.

      Si hay errores o advertencias, seleccione Ver mensajes. Resuelva cualquier error antes de publicar la tarea.

    11. Cuando termine de configurar la tarea de REST, seleccione Crear y cerrar o Guardar y cerrar.
    Permite publicar la tarea de REST en una aplicación en Data Integration antes de ejecutar la tarea o programar la tarea para su ejecución. Para obtener información sobre la publicación, consulte Publicación en una aplicación de Data Integration.

  • Utilice el comando oci data-integration task create-task-from-rest-task y los parámetros necesarios para crear una tarea de REST:

    oci data-integration task create-task-from-rest-task [OPTIONS]

    Para obtener una lista completa de indicadores y opciones de variables para los comandos de la CLI, consulte la Referencia de la línea de comandos.

  • Ejecute la operación CreateTask con el subtipo de recurso adecuado para crear una tarea de REST.