Chiamare gli endpoint dell'API REST dai flussi di lavoro in Logic Apps di Azure utilizzando Swagger per HTTP

Si applica a: App per la logica di Azure (A consumo e Standard)

Per chiamare un'API REST dal flusso di lavoro in App per la logica di Azure senza compilare manualmente una richiesta, aggiungere il trigger o l'azione HTTP + Swagger nativi predefiniti al flusso di lavoro. Queste operazioni chiamano qualsiasi endpoint API REST usando un file Swagger per individuare le operazioni chiamabili e ottenere input e output strutturati.

Il trigger e l'azione HTTP + Swagger funzionano come il trigger e l'azione HTTP, ma offrono un'esperienza migliore nella finestra di progettazione del flusso di lavoro esponendo la struttura e gli output api descritti dal file Swagger.

Questo articolo illustra come aggiungere e usare il trigger HTTP + Swagger e l'azione nel flusso di lavoro.

Limiti

Le operazioni predefinite HTTP + Swagger supportano solo OpenAPI 2.0, non OpenAPI 3.0.

Prerequisiti

• Account e sottoscrizione di Azure. Ottenere un account Azure gratuito.

• URL del file Swagger che descrive l'endpoint dell'API REST di destinazione da chiamare.

  In genere, l'endpoint REST deve soddisfare i criteri seguenti per il funzionamento del trigger o dell'azione:

  • Il file Swagger è ospitato in un URL HTTPS accessibile pubblicamente.

  • Il file Swagger contiene una operationID proprietà per ogni operazione nella definizione dell'API. In caso contrario, la finestra di progettazione del flusso di lavoro mostra solo l'ultima operazione nel file Swagger.

  • Il file Swagger deve attivare la Condivisione di Risorse tra le Origini (CORS).

    Nota

    Per fare riferimento a un file Swagger che non è ospitato o che non soddisfa i requisiti di sicurezza e di origini incrociate, caricare il file Swagger in un contenitore blob in un account di archiviazione di Azure e abilitare CORS in tale account di archiviazione.

• Flusso di lavoro dell'app di logica a consumo o Standard in cui si vuole chiamare l'endpoint dell'API REST.

  Per avviare il flusso di lavoro con il trigger HTTP + Swagger, creare una risorsa di un'app per la logica che abbia un workflow vuoto. Per usare l'azione HTTP + Swagger, avviare il flusso di lavoro con qualsiasi trigger che funziona meglio per lo scenario aziendale.

Aggiungere un trigger HTTP + Swagger

Questo trigger invia una richiesta HTTP all'URL di un file Swagger che descrive un'API REST. Il trigger restituisce una risposta che contiene il contenuto del file Swagger nel flusso di lavoro.

Per implementare un trigger di polling, seguire il modello di trigger di polling.

1. Nel portale di Azure, apri la risorsa dell'app logica.

2. Nella finestra di progettazione aprire il flusso di lavoro vuoto.

3. In base al fatto che il flusso di lavoro sia Consumption o Standard, seguire la procedura generale per aggiungere il trigger HTTP denominato HTTP + Swagger.

4. Nella casella Endpoint Swagger immettere l'URL per il file Swagger e selezionare Aggiungi azione.

   L'esempio seguente mostra un esempio di formato URL Swagger. L'URL potrebbe usare un formato diverso.

   

   Il riquadro informazioni sul trigger mostra le operazioni nel file Swagger.

5. Selezionare l'operazione desiderata.

6. Per l'operazione selezionata, immettere i valori dei parametri da usare nella chiamata API REST.

   I parametri variano in base all'operazione selezionata.

7. Se il trigger viene eseguito in base a una pianificazione, configurare la ricorrenza per specificare quando il trigger chiama l'API REST.

8. Se esistono altri parametri, aprire l'elenco Parametri avanzati e selezionare i parametri desiderati.

   Per altre informazioni sull'autenticazione, vedere Aggiungere l'autenticazione alle chiamate in uscita.

9. Continuare a compilare il flusso di lavoro con azioni da eseguire quando il trigger viene attivato.

10. Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.

Aggiungi un'azione HTTP + Swagger

Questa azione invia una richiesta HTTP all'URL di un file Swagger che descrive un'API REST. L'azione restituisce una risposta che contiene il contenuto del file Swagger nel flusso di lavoro.

1. Nel portale di Azure, apri la risorsa dell'app logica.

2. Nella finestra di progettazione aprire il flusso di lavoro vuoto.

3. In base al fatto che il flusso di lavoro sia Consumption o Standard, seguire la procedura generale per aggiungere l'azione HTTP denominata HTTP + Swagger.

4. Nella casella Endpoint Swagger immettere l'URL per il file Swagger e selezionare Aggiungi azione.

   L'esempio seguente mostra un esempio di formato URL Swagger. L'URL potrebbe usare un formato diverso.

   

   Il riquadro delle informazioni sull'azione mostra le operazioni nel file Swagger.

5. Selezionare l'operazione desiderata.

6. Per l'operazione selezionata, immettere i valori dei parametri da usare nella chiamata API REST.

   I parametri variano in base all'operazione selezionata.

7. Se esistono altri parametri, aprire l'elenco Parametri avanzati e selezionare i parametri desiderati.

   Per altre informazioni sull'autenticazione, vedere Aggiungere l'autenticazione alle chiamate in uscita.

8. Continuare a compilare il flusso di lavoro con azioni da eseguire quando il trigger viene attivato.

9. Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.

Output dalle operazioni HTTP + Swagger

Questa sezione fornisce ulteriori informazioni sugli output del trigger e dell'azione HTTP + Swagger. L'operazione HTTP + Swagger restituisce le informazioni seguenti:

Ospitare Swagger in Archiviazione di Azure

È comunque possibile fare riferimento a un file Swagger che non è ospitato o che non soddisfa i requisiti di sicurezza e di cross-origin. Caricare il file Swagger in un contenitore BLOB in un account di archiviazione di Azure e attivare CORS nell'account di archiviazione.

Per creare, configurare e archiviare file Swagger in Archiviazione di Azure, attenersi alla procedura seguente:

1. Nel portale di Azure creare un account di archiviazione di Azure.

2. Attivare CORS per il BLOB seguendo questa procedura:

   1. Nella barra laterale dell'account di archiviazione, in Impostazioni selezionare CORS.

   2. Nella scheda Servizio BLOB immettere i valori seguenti e selezionare Salva.

      Parametro	valore
      Origini consentite	*
      Metodi consentiti	GET, HEAD, PUT
      Intestazioni consentite	*
      Intestazioni esposte	*
      Età massima in secondi	200

   Questo esempio usa il portale di Azure, ma è possibile usare uno strumento come Azure Storage Explorer per configurare questa impostazione. Per automatizzare la configurazione, vedere lo script di PowerShell di esempio.

3. Creare un contenitore BLOB e seguire questa procedura:

   1. Nella barra laterale del contenitore selezionare Panoramica.

   2. Nella pagina Panoramica selezionare Cambia livello di accesso.

   3. Nell'elenco Livello di accesso pubblico selezionare BLOB (accesso in lettura anonimo solo per i BLOB) e quindi selezionare OK.

4. Nel portale di Azure o in Azure Storage Explorer caricare il file Swagger nel contenitore BLOB.

5. Per fare riferimento al file nel contenitore BLOB, da Azure Storage Explorer, ottenere l'URL HTTPS che usa il formato con distinzione tra maiuscole e minuscole seguente:

   https://<storage-account-name>.blob.core.windows.net/<blob-container-name>/<complete-swagger-file-name>?<query-parameters>

Contenuto correlato

• Connettori gestiti per Azure Logic Apps
• Connettori integrati per Azure Logic Apps