Condividi tramite

Esercitazione: Aggiungere ambienti e distribuzioni per le API

Questa esercitazione illustra come aumentare l'inventario nel centro API aggiungendo informazioni su ambienti API e distribuzioni.

  • Un ambiente rappresenta una posizione in cui è possibile distribuire un runtime api, ad esempio una piattaforma di gestione API.
  • Una distribuzione è un percorso o un indirizzo, in cui gli utenti possono accedere a un'API.

Per altre informazioni su API, distribuzioni e altre entità che è possibile inventariare nel Centro API di Azure, vedere Concetti chiave.

In questa esercitazione si apprenderà come usare il portale per:

  • Aggiungere informazioni sugli ambienti API
  • Aggiungere informazioni sulle distribuzioni api

Prerequisiti

Aggiungere un ambiente

Usare il centro API per tenere traccia degli ambienti API reali. Ad esempio, è possibile usare Azure Gestione API o un'altra soluzione per distribuire, proteggere e monitorare alcune API. In alternativa, è possibile gestire direttamente alcune API usando un servizio di calcolo o un cluster Kubernetes.

Qui si aggiungono informazioni su un ambiente fittizio di Azure Gestione API al centro API. Se si preferisce, aggiungere informazioni su uno degli ambienti esistenti. Configurare sia i metadati predefiniti che tutti i metadati personalizzati definiti in un'esercitazione precedente.

  1. Accedere al portale di Azure e quindi passare al centro API.

  2. Nel menu della barra laterale, in Asset, selezionare Ambienti>+ Nuovo ambiente.

  3. Nella pagina Nuovo ambiente aggiungere le informazioni seguenti. Se in precedenza sono stati definiti i metadati line-of-business personalizzati o altri metadati assegnati agli ambienti, vengono visualizzati nella parte inferiore della pagina.

    Impostazione Value Description
    Titolo ambiente Immettere My Testing (Test personali). Nome scelto per l'ambiente
    Identificazione Dopo aver immesso il titolo precedente, il Centro API di Azure genera questo identificatore, che è possibile eseguire l'override. Nome della risorsa di Azure per l'ambiente
    Tipo di ambiente Selezionare Test nell'elenco a discesa. Tipo di ambiente per le API
    Descrizione Facoltativamente, immetti una descrizione. Descrizione dell'ambiente
    Server
    Tipo Facoltativamente, selezionare Gestione API di Azure nell'elenco a discesa. Tipo di soluzione di gestione API usata
    URL del portale di gestione Facoltativamente, immettere un URL per un'interfaccia di gestione, ad esempio https://admin.contoso.com URL dell'interfaccia di gestione per l'ambiente
    Inserimento
    URL del portale di sviluppo Facoltativamente, immettere un URL per un portale per sviluppatori, ad esempio https://developer.contoso.com URL dell'interfaccia per l'onboarding degli sviluppatori nell'ambiente
    Istruzioni Facoltativamente, selezionare Modifica e immettere le istruzioni di onboarding in Markdown standard. Istruzioni per eseguire l'onboarding nelle API dall'ambiente
    Line-of-business Se sono stati aggiunti questi metadati personalizzati, facoltativamente effettuare una selezione dall'elenco a discesa, ad esempio IT. Metadati personalizzati che identificano la business unit che gestisce l'ambiente

    Screenshot dell'aggiunta di un ambiente API nel portale.

  4. Fare clic su Crea. L'ambiente viene visualizzato nell'elenco degli ambienti.

Aggiungere una distribuzione

Il centro API consente anche di catalogare le distribuzioni api, gli ambienti di runtime in cui vengono distribuite le API monitorate.

Qui si aggiunge una distribuzione associando una delle API all'ambiente creato nella sezione precedente. È possibile configurare sia i metadati predefiniti che i metadati personalizzati definiti.

  1. Nel portale di Azure passare al centro API.

  2. Nel menu della barra laterale, in Asset selezionare API.

  3. Selezionare un'API, ad esempio l'API Conference.

  4. Nella pagina API Conferenza, in Dettagli, selezionare Distribuzioni>+ Aggiungi distribuzione.

  5. Nella pagina Aggiungi distribuzione aggiungere le informazioni seguenti. Se in precedenza sono stati definiti i metadati line-of-business personalizzati o altri metadati assegnati agli ambienti, è possibile visualizzarli nella parte inferiore della pagina.

    Impostazione Value Description
    Titolo Immettere Distribuzione V1. Nome che scegli per la distribuzione
    Identificazione Dopo aver immesso il titolo precedente, il Centro API di Azure genera questo identificatore, che è possibile eseguire l'override. Nome della risorsa di Azure per la distribuzione
    Descrizione Facoltativamente, immetti una descrizione. Descrizione della distribuzione
    Ambiente Effettuare una selezione dall'elenco a discesa, ad esempio Test personali o, facoltativamente, selezionare Crea nuovo. Ambiente nuovo o esistente in cui viene distribuita la versione dell'API
    Definizione Selezionare o aggiungere un file di definizione per una versione dell'API Conference. File di definizione DELL'API
    Runtime URL Immettere un URL di base, https://api.contoso.comad esempio . URL di runtime di base per l'API nell'ambiente
    Line-of-business Se sono stati aggiunti questi metadati personalizzati, facoltativamente effettuare una selezione dall'elenco a discesa, ad esempio IT. Metadati personalizzati che identificano la business unit che gestisce le API nell'ambiente

    Screenshot dell'aggiunta di una distribuzione api nel portale.

  6. Fare clic su Crea. La distribuzione viene visualizzata nell'elenco delle distribuzioni.

In questa esercitazione si è appreso come usare il portale per:

  • Aggiungere informazioni sugli ambienti API
  • Aggiungere informazioni sulle distribuzioni api

Contenuti correlati

  • Last updated on