Documentazione dell'infrastruttura Oracle Cloud

Configurazione dei parametri di metodo, URL e URL HTTP

Specificare il metodo HTTP e l'URL della richiesta REST da eseguire e configurare i parametri URL per il task REST.

Le procedure riportate di seguito possono essere utilizzate anche durante l'immissione o la modifica dell'URL di polling e dell'URL di interruzione facoltativi.

Configurazione del metodo e dell'URL HTTP

Il metodo è un metodo HTTP standard, ad esempio GET o POST. L'URL è l'endpoint API REST della risorsa a cui accedere nella richiesta REST.

Ad esempio, il seguente endpoint REST elenca gli asset dati nell'ID area di lavoro finance123:

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

L'URL può includere parametri utilizzando la sintassi ${}. Ad esempio, l'endpoint REST seguente elenca gli asset dati in un'area di lavoro utilizzando la sintassi dei parametri per le sezioni variabili dell'URL che specificano l'host del server e l'ID dell'area di lavoro.

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

Quando si specificano parti dell'URL utilizzando la sintassi dei parametri, tali parti vengono convertite in parametri URL stringa per il task REST. A ogni parametro URL deve essere assegnato un valore predefinito.

Quando il task viene eseguito, è possibile modificare i valori di tali parametri URL. Ad esempio, in fase di esecuzione è possibile fornire valori diversi per il server e l'ID dell'area di lavoro.

La procedura riportata di seguito può essere utilizzata anche per immettere (o modificare) l'URL di polling e l'URL di interruzione facoltativi.

Per configurare il metodo e l'URL HTTP, effettuare le operazioni riportate di seguito.

  1. Nel passo Definisci dettagli esecuzione della pagina Configura dettagli API REST, in Metodo HTTP, selezionare il metodo HTTP da utilizzare per l'URL di questo task REST.

    Per configurare l'URL di polling e l'URL di interruzione facoltativi, andare al passo Specifica criteri di completamento, fare clic sulla scheda Polling o Cessazione e selezionare il metodo HTTP. Le schede Polling e Cessazione vengono visualizzate solo quando è selezionata la casella di controllo Configura una condizione di polling e interruzione per una chiamata REST senza attesa.

  2. Nel campo URL, immettere l'URL completo, quindi premere Invio.

    Se si utilizza la sintassi del parametro ${} per parti dell'URL, tali parti vengono convertite in parametri URL per il task REST.

    La tabella nella scheda Parametri URL sotto il campo URL viene aggiornata con le parti con parametri. Il tipo di dati predefinito per ogni parametro URL è String.

    Per assegnare un valore predefinito a ciascun parametro URL, vedere Configurazione dei parametri URL. È possibile modificare il tipo di dati e aggiungere una descrizione a ciascun parametro.

  3. Se si modifica l'URL in qualsiasi momento aggiungendo o rimuovendo la sintassi dei parametri, la tabella dei parametri URL viene aggiornata di conseguenza.
Configurazione dei parametri URL

Dopo aver immesso (o modificato) l'URL e aver premuto Invio, tutte le sezioni dell'URL che utilizzano la sintassi dei parametri ${} vengono convertite in parametri URL per il task REST.

Il tipo di dati predefinito di tutti i nuovi parametri URL aggiunti è String. Nella scheda Parametri URL è possibile aggiungere valori predefiniti per i parametri del task REST, nonché modificare il tipo di dati dei parametri, se necessario.

La procedura riportata di seguito può essere utilizzata anche per modificare i parametri URL per l'URL di polling e l'URL di interruzione facoltativi.

Per configurare i parametri URL, procedere come segue.

  1. Nel passo Definisci dettagli esecuzione della pagina Configura dettagli API REST, fare clic sulla scheda Parametri URL.

    Per configurare i parametri URL per l'URL di polling e di interruzione facoltativo, andare al passo Specifica criteri di completamento, fare clic sulla scheda Polling o Cessazione, quindi fare clic su Parametri URL. Le schede Polling e Cessazione vengono visualizzate solo quando è selezionata la casella di controllo Configura una condizione di polling e interruzione per una chiamata REST senza attesa.

  2. Nella riga della tabella relativa a un parametro URL appena aggiunto, selezionare Modifica dal menu Azioni (Menu Azioni).
  3. Nel pannello Modifica parametri, il campo di sola lettura Identificativo è il nome del parametro del task REST per la sezione della variabile URL parametrizzata.
    1. Immettere una Descrizione facoltativa per il parametro.
    2. Utilizzare il menu Tipo di dati per modificare il tipo di dati del parametro.
    3. Immettere nel campo Valore il valore predefinito per il parametro.
    4. Fare clic su Salva.
      Il parametro URL viene aggiornato nella tabella.
  4. Per mostrare o nascondere l'URL utilizzando i valori predefiniti dei parametri configurati, fare clic su Mostra URL di anteprima o Nascondi URL di anteprima.