Condividi tramite

Importare un'app contenitore di Azure come API

  • Articolo

SI APPLICA A: Tutti i livelli di Gestione API

Questo articolo illustra come importare un'app contenitore di Azure in Gestione API di Azure e testare l'API importata usando il portale di Azure. In questo articolo vengono illustrate le operazioni seguenti:

  • Importare un'app contenitore che espone un'API Web
  • Testare l'API nel portale di Azure

Esporre un'app contenitore con Gestione API

App contenitore di Azure consente di distribuire app in contenitori senza gestire un'infrastruttura complessa. Gli sviluppatori di API possono scrivere codice usando il linguaggio di programmazione o il framework preferito, creare microservizi con supporto completo per Distributed Application Runtime (Dapr) e ridimensionare in base al traffico HTTP o ad altri eventi.

Gestione API è l'ambiente consigliato per esporre un'API Web ospitata in un'app contenitore, per diversi motivi:

  • Separare la gestione e la protezione del front-end esposto ai consumer di API dalla gestione e dal monitoraggio dell'API Web back-end
  • Gestire le API Web ospitate come app contenitore nello stesso ambiente delle altre API
  • Applicare criteri per modificare il comportamento dell'API, ad esempio la limitazione della frequenza delle chiamate
  • Indirizzare i consumer di API al portale per sviluppatori personalizzabile di Gestione API per individuare e ottenere informazioni sulle API, richiedere l'accesso e provarle

Per altre informazioni, vedere Informazioni su Gestione API.

Specifica OpenAPI e operazioni con caratteri jolly

Gestione API supporta l'importazione di app contenitore che forniscono una specifica OpenAPI (definizione Swagger). Tuttavia, non è necessaria una specifica OpenAPI. È consigliabile fornire una specifica OpenAPI. Gestione API può importare singole operazioni, consentendo di convalidare, gestire, proteggere e aggiornare le configurazioni per ogni operazione separatamente.

Se l'app contenitore espone una specifica OpenAPI, Gestione API crea operazioni API che eseguono il mapping direttamente alla definizione. Gestione API cercherà diverse posizioni per una specifica OpenAPI

  • Configurazione dell'app contenitore.
  • /openapi.json
  • /openapi.yml
  • /swagger/v1/swagger.json

Se non viene indicata una specifica OpenAPI, Gestione API genera operazioni con caratteri jolly per i verbi HTTP comuni (GET, PUT e così via). È comunque possibile sfruttare le stesse funzionalità di Gestione API, ma le operazioni non sono definite allo stesso livello di dettaglio.

In entrambi i casi, è possibile modificare o aggiungere operazioni all'API dopo l'importazione.

Esempio

L'app contenitore back-end potrebbe supportare due operazioni GET:

  • https://myappservice.azurewebsites.net/customer/{id}
  • https://myappservice.azurewebsites.net/customers

L'app contenitore viene importata nel servizio Gestione API in un percorso, ad esempio https://contosoapi.azure-api.net/store. La tabella seguente illustra le operazioni importate in Gestione API, con o senza una specifica OpenAPI:

Type Operazioni importate Richieste di esempio
Specifica OpenAPI GET /customer/{id}

GET /customers		 GET https://contosoapi.azure-api.net/store/customer/1

GET https://contosoapi.azure-api.net/store/customers
Wildcard (Carattere jolly) GET /* GET https://contosoapi.azure-api.net/store/customer/1

GET https://contosoapi.azure-api.net/store/customers

L'operazione con caratteri jolly consente le stesse richieste al servizio back-end delle operazioni nella specifica OpenAPI. Tuttavia, le operazioni specificate con OpenAPI possono essere gestite separatamente in Gestione API.

Prerequisiti

Passare all'istanza di Gestione API

  1. Nel portale di Azure cercare e selezionare Servizi Gestione API.

    Selezionare Servizi Gestione API

  2. Nella pagina Servizi Gestione API selezionare l'istanza di Gestione API.

    Selezionare l'istanza di Gestione API

Importare e pubblicare un'API back-end

  1. Passare al servizio Gestione API nel portale di Azure e selezionare API dal menu.

  2. Selezionare App contenitore dall'elenco.

    Creare da un'app contenitore

  3. Selezionare Sfoglia per visualizzare l'elenco delle app per le funzioni nella sottoscrizione.

  4. Selezionare un’app contenitore. Se una definizione OpenAPI è associata all'app contenitore selezionata, Gestione API lo recupera e lo importa. Se non viene trovata una definizione OpenAPI, Gestione API espone l'API generando operazioni con caratteri jolly per verbi HTTP comuni.

  5. Aggiungere un suffisso dell'URL dell'API. Il suffisso è un nome che identifica questa specifica API in questa istanza di Gestione API. Deve essere univoco nell'istanza di Gestione API.

  6. Pubblicare l'API associandola a un prodotto. In questo caso viene usato il prodotto "Unlimited". Per fare in modo che l'API venga pubblicata e sia disponibile per gli sviluppatori, aggiungerla a un prodotto.

    Nota

    I prodotti sono associazioni di una o più API. È possibile includere diverse API e proporle agli sviluppatori tramite il portale per sviluppatori. Gli sviluppatori devono prima effettuare la sottoscrizione di un prodotto per ottenere l'accesso all'API. Quando effettuano la sottoscrizione, ottengono una chiave di sottoscrizione che è utile per qualsiasi API nel prodotto. Se si è creata l'istanza di Gestione API, si è un amministratore e la sottoscrizione a ogni prodotto è stata effettuata per impostazione predefinita.

    Con ogni istanza di Gestione API vengono forniti due prodotti di esempio quando vengono creati:

    • Starter
    • Illimitato

  7. Immettere altre impostazioni API. È possibile impostare i valori durante la creazione o configurarli successivamente passando alla scheda Impostazioni. Le impostazioni sono illustrate nell'esercitazione Importare e pubblicare la prima API.

  8. Seleziona Crea.

    Creare un'API dall'app contenitore

Testare la nuova API nel portale di Azure

È possibile chiamare le operazioni direttamente dal portale di Azure, che consente di visualizzare e testare le operazioni di un'API in tutta comodità. È anche possibile testare l'API nel portale per sviluppatori o usare i propri strumenti client REST.

  1. Selezionare l'API creata nel passaggio precedente.

  2. Selezionare la scheda Test.

  3. Selezionare un'operazione.

    La pagina visualizza campi per le intestazioni e campi per i parametri di query. Una delle intestazioni è Ocp-Apim-Subscription-Key, per la chiave di sottoscrizione del prodotto associato all'API. Se si è creata l'istanza di Gestione API, si è già un amministratore, quindi la chiave viene inserita automaticamente.

  4. Fare clic su Invia.

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

Testare l'operazione con caratteri jolly nel portale

Quando vengono generate operazioni con caratteri jolly, le operazioni potrebbero non essere mappate direttamente all'API back-end. Ad esempio, un'operazione GET con caratteri jolly importata in Gestione API usa il percorso / per impostazione predefinita. Tuttavia, l'API back-end potrebbe supportare un'operazione GET nel percorso seguente:

/api/TodoItems

È possibile testare il percorso /api/TodoItems come indicato di seguito.

  1. Selezionare l'API creata e selezionare l'operazione.

  2. Selezionare la scheda Test.

  3. In Parametri modello, aggiornare il valore accanto al nome del carattere jolly (*). Ad esempio, immettere api/TodoItems. Questo valore viene aggiunto al percorso / per l'operazione con caratteri jolly.

    Testare l'operazione con caratteri jolly

  4. Selezionare Invia.

Aggiungere altre API

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

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

Per aggiungere un'API diversa all'API esistente, seguire questa procedura.

Nota

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

  1. Vai alla tua istanza di Gestione API di Azure nel portale di Azure.

    Passare all'istanza di Gestione API di Azure

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

    Seleziona API

  3. Fare clic su ... accanto all'API a cui si vuole aggiungere un'altra API.

  4. Nel menu a discesa selezionare Importa.

    Selezionare Importa

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

    Selezionare un servizio

Passaggi successivi

Trasformare e proteggere un'API pubblicata