Condividi tramite

Importare un'app per la logica come API

SI APPLICA A: tutti i livelli di Gestione API

Questo articolo illustra come importare un'app per la logica come API e testare l'API importata.

Nota

Attualmente, questa funzionalità non è disponibile nelle aree di lavoro.

In questo articolo vengono illustrate le operazioni seguenti:

  • Importare un'app per la logica come API
  • Testare l'API nel portale di Azure

Nota

Gestione API di Azure supporta l'importazione automatica di una risorsa app per la logica (consumo), che viene eseguita nell'ambiente app per la logica multi-tenant. Per ulteriori informazioni, vedere Differenze tra app di logica standard a tenant singolo e app di logica multi-tenant a consumo.

Prerequisiti

Importare e pubblicare un'API back-end

  1. Accedere al servizio di API Management nel portale di Azure.

  2. Nel menu a sinistra, nella sezione API selezionare API e quindi + Aggiungi API.

  3. Selezionare Logic App nell'elenco Crea a partire da risorse di Azure :

    Screenshot che mostra il riquadro App Logica.

  4. Selezionare Sfoglia per visualizzare l'elenco delle app per la logica con trigger HTTP nella sottoscrizione. Le app per la logica che non dispongono di un trigger HTTP non verranno visualizzate nell'elenco.

    Screenshot che mostra il pulsante Sfoglia.

  5. Selezionare l'app per la logica:

    Screenshot che mostra la finestra Seleziona Logic App da importare.

    Gestione API trova il documento Swagger associato all'app selezionata, lo recupera e lo importa.

  6. Aggiungere un suffisso dell'URL dell'API. Il suffisso identifica in modo univoco l'API nell'istanza di Gestione API.

    Screenshot che mostra i valori immessi nella finestra Crea da Logic App.

  7. Se si vuole che l'API venga pubblicata e disponibile per gli sviluppatori, passare alla visualizzazione Completa e associare l'API a un prodotto. In questo esempio viene usato il prodotto Unlimited . È possibile aggiungere l'API a un prodotto quando viene creata o successivamente tramite la scheda Impostazioni .

    Nota

    I prodotti sono associazioni di una o più API offerte agli sviluppatori tramite il portale per sviluppatori. Per avere accesso all'API, gli sviluppatori devono prima sottoscrivere un prodotto. Dopo la sottoscrizione, ottengono una chiave di sottoscrizione per qualsiasi API nel prodotto. In qualità di creatore dell'istanza di API Management, sei un amministratore e sei iscritto a ogni prodotto per impostazione predefinita.

    In determinati livelli, ogni istanza di Gestione API include due prodotti di esempio predefiniti:

    • Antipasto
    • Illimitato

  8. Immettere altre impostazioni API. È possibile impostare questi valori quando si crea l'API o versioni successive passando alla scheda Impostazioni . Le impostazioni sono illustrate nell'esercitazione Importare e pubblicare la prima API .

  9. Seleziona Crea.

Testare l'API nel portale di Azure

È possibile chiamare le operazioni direttamente dal portale di Azure. Questo metodo offre un modo pratico per visualizzare e testare le operazioni di un'API.

Screenshot che mostra i passaggi per il test di un'API.

  1. Selezionare l'API creata nel passaggio precedente.

  2. Nella scheda Test selezionare l'operazione da testare.

    • La pagina visualizza campi per le intestazioni e per i parametri di query.
    • Una delle intestazioni è Ocp-Apim-Subscription-Key. Questa intestazione si riferisce alla chiave di abbonamento del prodotto associata all'API.
    • In qualità di creatore dell'istanza di Gestione API, si è un amministratore, quindi la chiave viene compilata automaticamente.

  3. Seleziona Invia. Quando il test ha esito positivo, il back-end risponde con 200 OK e dati.

Aggiungere altre API

È possibile comporre un'API fuori dalle API esposte da servizi diversi, tra cui:

  • Una specifica OpenAPI
  • Un'API SOAP
  • Un'API GraphQL
  • Un'app Web ospitata nel servizio app di Azure
  • Funzioni di Azure
  • App per la logica di azure
  • Azure Service Fabric

Nota

Quando si importa un'API, le operazioni vengono aggiunte all'API corrente.

Per aggiungere un'API a un'API esistente:

  1. Passare all'istanza di Gestione API di Azure nel portale di Azure:

    Screenshot che mostra la pagina Dei servizi gestione API.

  2. Selezionare API nella pagina Panoramica o selezionare API>nel menu a sinistra.

    Screenshot che mostra la selezione delle API nella pagina Panoramica.

  3. Selezionare i puntini di sospensione (...) accanto all'API a cui si vuole aggiungere un'altra API.

  4. Selezionare Importa dal menu a discesa:

    Screenshot che mostra il comando Import.

  5. Selezionare un servizio da cui importare un'API.

Nota

Ogni app per la logica ha un'operazione manual-invoke . Se si vogliono combinare più app per la logica in un'API, è necessario rinominare la funzione. Per rinominare la funzione o l'API, modificare il valore del titolo nell'editor di specifiche OpenAPI.

Contenuti correlati