Esercitazione: Definire metadati personalizzati

In questa esercitazione definire metadati personalizzati per organizzare le API e altre informazioni nel centro API. Usare metadati personalizzati e predefiniti per la ricerca e il filtro e per applicare gli standard di governance nell'organizzazione.

Per informazioni di base sui metadati nel Centro API di Azure, vedere:

• Concetti chiave
• Metadati per la governance delle API

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

• Definire metadati personalizzati nel centro API
• Visualizzare lo schema dei metadati

Prerequisiti

• Un centro API nella sottoscrizione di Azure. Se non ne è già stato creato uno, vedere Avvio rapido: Creare il centro API.

Definire i metadati

Qui si definiscono due esempi di metadati personalizzati: line-of-business e pubblico. Se si preferisce, definire altri metadati personalizzati. Quando si aggiungono o aggiornano API e altre informazioni nell'inventario, si impostano i valori per i metadati predefiniti personalizzati ed eventuali metadati predefiniti comuni.

Importante

Non includere informazioni riservate, riservate o personali nei titoli (nomi) dei metadati definiti. Questi titoli sono visibili nei log di monitoraggio usati da Microsoft per migliorare la funzionalità del servizio. Tuttavia, altri dettagli e valori dei metadati sono i dati dei clienti protetti.

1. Nella portale di Azure passare al centro API.

2. Nel menu a sinistra, in Asset, selezionare Metadati > + Nuovi metadati.

3. Nella scheda Dettagli immettere informazioni sui metadati.

   1. In Titolo immettere Line of business.

   2. Facoltativamente, immettere una descrizione.

   3. Selezionare il tipo Scelte predefinite e immettere scelte come Marketing, Finance, IT, Sales e così via. Facoltativamente, abilitare Consenti selezione di più valori. Selezionare Avanti.

   

4. Nella scheda Assegnazioni selezionare Obbligatorio per le API. Selezionare Facoltativo per Distribuzioni e ambienti. Queste entità verranno aggiunte nelle esercitazioni successive. Selezionare Avanti.

   

5. Nella scheda Rivedi e crea esaminare le impostazioni e selezionare Crea.

   I metadati vengono aggiunti all'elenco nella pagina Metadati .

6. Selezionare + Nuovi metadati per aggiungere un altro esempio.

7. Nella scheda Dettagli immettere informazioni sui metadati.

   1. In Titolo immettere Pubblico.

   2. Selezionare tipo Boolean.

8. Nella scheda Assegnazioni selezionare Obbligatorio per le API. Selezionare Non applicabile per Distribuzioni e ambienti.

9. Nella scheda Rivedi e crea esaminare le impostazioni e selezionare Crea.

   I metadati vengono aggiunti all'elenco.

Visualizzare lo schema dei metadati

È possibile visualizzare e scaricare lo schema JSON per i metadati definiti nel centro API. Lo schema include metadati predefiniti e personalizzati.

1. Nel menu a sinistra, in Asset selezionare Schema metadati visualizzazione metadati>.

2. Selezionare Visualizza API dello schema > dei metadati per visualizzare lo schema dei metadati per le API, che include metadati predefiniti e personalizzati. È anche possibile visualizzare lo schema dei metadati definito per le distribuzioni e gli ambienti nel centro API.

   

Passaggi successivi

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

• Definire metadati personalizzati nel centro API
• Visualizzare lo schema dei metadati

Dopo aver preparato lo schema dei metadati, aggiungere API all'inventario nel centro API.

Registrare le API nell'inventario API