Creazione di un task REST

• Console
• CLIENTE
• API

• L'interfaccia utente di configurazione contiene quattro sezioni in cui è possibile fornire l'interfaccia API REST e i dettagli di autenticazione per il task, fornire i valori dei parametri facoltativi nell'ambito del task e controllare la presenza di errori e avvertenze.

  I passi per ogni sezione della procedura riportata di seguito possono essere utilizzati anche quando si modifica un task REST.

  1. Aprire il progetto o la cartella in cui si desidera creare il task.

     Per la procedura di apertura della pagina dei dettagli di un progetto o di una cartella, vedere Visualizzazione dei dettagli di un progetto o Visualizzazione dei dettagli di una cartella.

  2. Nella pagina dei dettagli del progetto o della cartella, fare clic su Task.
  3. Nella sezione Task, fare clic su Crea task e selezionare REST.
  4. Nella pagina Crea task REST immettere un nome e una descrizione facoltativa.

     L'identificativo è un valore generato dal sistema in base al nome È possibile modificare il valore, ma dopo aver creato e salvato il task, non è possibile aggiornare l'identificativo.

  5. Selezionare la casella di controllo Disabilita esecuzione simultanea del task se si desidera non consentire esecuzioni concorrenti di questo task.
  6. (Facoltativo) Per Progetto o cartella, fare clic su Seleziona e selezionare un progetto o una cartella diversi in cui salvare il task.
  7. Per salvare l'attività per la prima volta, fare clic su uno dei seguenti pulsanti:

     • Crea: crea e salva il task. È possibile continuare a creare e modificare il task.

     • Crea e chiudi: crea e salva il task, chiude la pagina e torna all'elenco dei task nella pagina dei dettagli del progetto o della cartella.

  8. Salvare periodicamente mentre si lavora facendo clic su uno dei seguenti pulsanti:

     • Salva: esegue il commit delle modifiche dall'ultimo salvataggio. È possibile continuare a modificare dopo il salvataggio.

     • Salva e chiudi: esegue il commit delle modifiche, chiude la pagina e torna all'elenco dei task nella pagina dei dettagli del progetto o della cartella.

     • Salva con nome: esegue il commit delle modifiche (dall'ultimo salvataggio) e le salva in una copia invece di sovrascrivere il task corrente. È possibile fornire un nome per la copia e selezionare un progetto o una cartella diversi per la copia oppure salvare la copia nello stesso progetto o cartella del task esistente.

  9. Nella sezione Dettagli API REST fare clic su Configura.

     Nella pagina Configura dettagli API REST visualizzata, fornire i dettagli di esecuzione dell'API REST e i criteri di completamento (condizione di operazione riuscita) per una chiamata REST riuscita.

     1. Attenersi alla procedura riportata di seguito per definire i dettagli di esecuzione dell'API REST.
        1. Specificare il metodo HTTP e l'URL REST.
        2. (Facoltativo) Configurare i parametri URL.
        3. Aggiungere un'intestazione di richiesta REST.
        4. (Facoltativo) Aggiungere un parametro di task per il valore dell'intestazione REST.
        5. Per un metodo HTTP POST o PUT, aggiungere il corpo della richiesta.
        6. (Facoltativo) Aggiungere un parametro di task per l'intero corpo della richiesta.
        7. Per visualizzare l'URL REST configurato, fare clic su Mostra URL di anteprima.
        8. Fare clic su Successivo.
     2. Per specificare i criteri per il completamento corretto dell'esecuzione dell'API REST, modificare la condizione di operazione riuscita predefinita fornita nella sezione Condizioni.
     3. Se l'API REST richiama un'operazione con tempi di esecuzione lunghi, oltre alla condizione di operazione riuscita, selezionare la casella di controllo Configura una condizione di polling e interruzione per una chiamata REST senza attesa e specificare i dettagli richiesti per una configurazione di polling (comportamento asincrono). Fare riferimento alla sezione Fornitura dei criteri di completamento mediante il polling.
     4. Fare clic su Configura.

        Viene nuovamente visualizzata la pagina Crea task REST o Task REST: <task name>.

  10. Nella sezione Autenticazione fare clic su Configura. Nel pannello Configura autenticazione visualizzato, specificare il metodo di autenticazione per l'esecuzione dell'endpoint API REST. Per impostazione predefinita, non è necessario alcun metodo di autenticazione.
  11. (Facoltativo) Nella sezione Parametri fare clic su Configura. Nella pagina Parametri task REST visualizzata, visualizzare e modificare i valori per i parametri disponibili nell'ambito di questo task REST.
  12. (Facoltativo) Nella sezione Convalida task, fare clic su Convalida.

      Se vengono visualizzati errori o avvertenze, fare clic su View messages. Risolvere eventuali errori prima di pubblicare il task.

  13. Al termine della configurazione del task REST, fare clic su Crea e chiudi o su Salva e chiudi.

  Pubblicare il task REST in un'applicazione in Data Integration prima di eseguire il task o pianificarne l'esecuzione. Per informazioni sulla pubblicazione, vedere Pubblicazione in un'applicazione Data Integration.

• Utilizzare il comando oci data-integration task create-task-from-rest-task e i parametri richiesti per creare un task REST:

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

  Per un elenco completo dei flag e delle opzioni variabili per i comandi CLI, vedere Command Line Reference.

• Eseguire l'operazione CreateTask con il sottotipo di risorsa appropriato per creare un task REST.