Documentación de Oracle Cloud Infrastructure

Configuración del método HTTP, la URL y los parámetros de URL

Especifique el método HTTP y la URL para que se ejecute la solicitud de REST y configure los parámetros de URL para la tarea de REST.

Los siguientes procedimientos también se pueden utilizar al introducir (o editar) la URL de sondeo opcional y la URL de terminación.

Configuración del método HTTP y la URL

El método es un método HTTP estándar, como GET o POST. La URL es el punto final de API de REST del recurso al que acceder en la solicitud REST.

Por ejemplo, el siguiente punto final de REST muestra los activos de datos en el identificador de espacio de trabajo finance123:

http://myserver.com:8081/workspaces/finance123/dataAssets

La URL puede incluir parámetros mediante la sintaxis ${}. Por ejemplo, el siguiente punto final de REST muestra los activos de datos en un espacio de trabajo mediante la sintaxis de parámetros para las secciones de variables de la URL que especifican el host del servidor y el ID del espacio de trabajo.

http://${myserver}:8081/workspaces/${workspaceId}/dataAssets

Al especificar partes de la URL mediante la sintaxis de parámetros, esas partes se convierten en parámetros de URL de String para la tarea de REST. Se debe asignar un valor por defecto a cada parámetro de URL.

Cuando se ejecuta la tarea, puede cambiar los valores de esos parámetros de URL. Por ejemplo, en tiempo de ejecución puede proporcionar diferentes valores para el servidor y el ID del espacio de trabajo.

El siguiente procedimiento también se puede utilizar para introducir (o editar) la URL de sondeo opcional y la URL de terminación.

Para configurar el método HTTP y la URL:

  1. En el paso Define Execution details de la página Configure REST API Details, en HTTP method, seleccione el método HTTP que desea utilizar para la URL de esta tarea de REST.

    Para configurar la URL de sondeo opcional y la URL de terminación, vaya al paso Especificar criterios de finalización, seleccione el separador Sondeo o Finalización y seleccione el método HTTP. Tenga en cuenta que los separadores Sondeo y Finalización solo aparecen cuando la casilla de control Configurar una condición de sondeo y terminación para una llamada de REST sin espera está seleccionada.

  2. En el campo URL, introduzca la URL completa y haga clic en Intro.

    Si se utiliza la sintaxis del parámetro ${} para partes de la URL, esas partes se convierten en parámetros de URL para la tarea de REST.

    La tabla del separador Parámetros de URL debajo del campo URL se actualiza con las partes parametrizadas. El tipo de datos por defecto para cada parámetro de URL es String.

    Para asignar un valor por defecto a cada parámetro de URL, consulte Configuración de parámetros de URL. Puede cambiar el tipo de datos y agregar una descripción a cada parámetro.

  3. Si edita la URL en cualquier momento agregando o eliminando sintaxis de parámetros, la tabla de parámetros de URL se actualiza en consecuencia.
Configuración de parámetros de URL

Después de introducir (o editar) la URL y pulsar Intro, cualquier sección de la URL que utilice la sintaxis del parámetro ${} se convierte en parámetros de URL para la tarea de REST.

El tipo de datos por defecto de todos los parámetros de URL recién agregados es String. En el separador Parámetros de URL, puede agregar valores por defecto para los parámetros de tarea de REST y también cambiar el tipo de datos de parámetro, si es necesario.

El siguiente procedimiento también se puede utilizar para editar parámetros de URL para la URL de sondeo opcional y la URL de terminación.

Para configurar parámetros de URL:

  1. En el paso Definir Detalles de Ejecución de la página Configurar Detalles de API deREST, seleccione el separador Parámetros de Dirección URL.

    Para configurar los parámetros de URL para la URL de sondeo y terminación opcional, vaya al paso Especificar criterios de finalización, seleccione el separador Sondeo o Finalización y, a continuación, seleccione Parámetros de URL. Tenga en cuenta que los separadores Sondeo y Finalización solo aparecen cuando la casilla de control Configurar una condición de sondeo y terminación para una llamada de REST sin espera está seleccionada.

  2. En la fila de la tabla para un parámetro de URL recién agregado, seleccione Editar en el menú Acciones (Acciones, menú).
  3. En el panel Editar parámetro, el campo de solo lectura Identificador es el nombre del parámetro de tarea de REST para la sección de variable de URL con parámetros.
    1. Introduzca una descripción opcional para el parámetro.
    2. Utilice el menú Tipo de datos para cambiar el tipo de datos del parámetro.
    3. En el campo Valor, introduzca el valor por defecto del parámetro.
    4. Seleccione Guardar.
      El parámetro URL se actualiza en la tabla.
  4. Para mostrar u ocultar la URL con los valores por defecto del parámetro que ha configurado, seleccione Mostrar URL a vista previa u Ocultar URL a vista previa.