Condividi tramite

Esercitazione: Aggiungere ambienti e distribuzioni per le API

  • Articolo

Aumentare l'inventario nel centro API aggiungendo informazioni sugli ambienti e le distribuzioni api.

  • Un ambiente rappresenta una posizione in cui è possibile distribuire un runtime api, ad esempio una piattaforma di gestione API.

  • Una distribuzione è un percorso (un indirizzo) in cui gli utenti possono accedere a un'API.

Per informazioni di base sulle API, le 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. Verranno configurati sia i metadati predefiniti che i metadati personalizzati definiti in un'esercitazione precedente.

  1. Nel portale, passare al centro API.

  2. Nel menu a sinistra, 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, verranno visualizzati nella parte inferiore della pagina.

    Impostazione valore Descrizione
    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 Immettere facoltativamente una descrizione. Descrizione dell'ambiente.
    Server
    Type Facoltativamente, selezionare Azure Gestione API dall'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.
    Onboarding
    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. Seleziona 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. Verranno configurati sia i metadati predefiniti che tutti i metadati personalizzati definiti.

  1. Nel portale, passare al proprio centro API.

  2. Nel menu a sinistra, in Assetselezionare 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, verranno visualizzati nella parte inferiore della pagina.

    Impostazione valore Descrizione
    Title Immettere Distribuzione V1. Nome scelto 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 Immettere facoltativamente 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. Seleziona 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

Contenuto correlato