Gestisce le tassonomie

Questa pagina si applica ad Apigee e Apigee hybrid.

Anteprima - Apigee API hub

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Autorizzazioni obbligatorie: devi disporre delle autorizzazioni di amministratore per visualizzare la pagina Impostazioni e gestire le tassonomie.

Le tassonomie forniscono un modo di organizzare le API e opzioni flessibili per definire i metadati delle API. Una tassonomia, come definita nel sistema, non è altro che un elenco denominato di valori che fornisce opzioni di categorizzazione per informazioni specifiche. La pagina delle impostazioni Tassonomie ti consente di visualizzare e gestire le diverse tassonomie disponibili nel sistema.

Le tassonomie di sistema definiscono i valori che hanno un significato speciale nell'hub API e possono essere presentati in modo speciale nell'interfaccia utente o dettare un comportamento. Le tassonomie di sistema sono predefinite dal sistema e sono più limitate nel modo in cui possono essere modificate o estese; tuttavia, il loro elenco di valori può essere modificato in una certa misura.

Le tassonomie personalizzate definiscono le informazioni personalizzate che vuoi collegare alle API. Se disponi delle autorizzazioni di amministratore, puoi creare e modificare questo elenco come preferisci.

La maggior parte delle tassonomie è esclusiva; le etichette raggruppano gli elementi in raccolte non sovrapposte (a selezione singola). Se necessario, tuttavia, le tassonomie possono essere configurate per consentire l'assegnazione di più etichette a un singolo oggetto. Queste tassonomie a selezione multipla sono contrassegnate come tali nella relativa configurazione.

Tassonomie di sistema predefinite

Le seguenti tassonomie di sistema predefinite non possono essere eliminate e hanno parti specifiche della configurazione che non sono modificabili. Alcune di queste tassonomie di sistema predefinite specificano anche elementi predefiniti:

• Utenti di destinazione:gli utenti previsti (consumatori) di un'API (sono consentite più selezioni).
• Stile (principale): lo stile architetturale principale dell'API (solo selezione singola)
• Team: il team di produzione responsabile di un'API (solo selezione singola)
• Business unit: la business unit responsabile di un'API (solo per selezione singola)
• Gateway: il proxy utilizzato per gestire e proteggere l'API (solo selezione singola)

Tassonomie personalizzate

Le tassonomie personalizzate forniscono un metodo per collegare informazioni personalizzate a un'API. Ad esempio:

• Approvazioni:lo stato della revisione, ad esempio Conforme o Regolato
• Argomenti: una categorizzazione di un'API per oggetto, ad esempio Finanza o Risorse umane
• Attributi:una funzionalità di un'API come Contiene PII.
• Prodotto: il prodotto di consumo che un'API è stata progettata per supportare

Aggiungi tassonomia

Per aggiungere una tassonomia:

1. Nella console Google Cloud, vai alla pagina Hub API, Impostazioni, Tassonomie.

   Vai alle tassonomie dell'hub API

2. Fai clic su Aggiungi tassonomia personalizzata.
3. Specifica quanto segue:
   • ID:un identificatore di una risorsa API. L'ID può contenere solo lettere minuscole, numeri e trattini. L'ID deve essere univoco nel progetto. Gli ID devono avere una lunghezza compresa tra 4 e 63 caratteri. Gli ID non possono essere modificati dopo la creazione di una tassonomia. Ad esempio, per il nome della risorsa API: projects/my-project/locations/global/apis/my-api, l'ID risorsa è my-api.
   • Nome:il nome visualizzato della tassonomia.
   • Descrizione: una breve descrizione della tassonomia
   • Opzioni:
     • Limita a una selezione: se questa opzione è selezionata, puoi applicare a un'API un solo valore della tassonomia alla volta. Se più valori sono già applicati alle API e questa opzione è abilitata, i multipli rimangono.
     • Escludi dai filtri di ricerca: se questa opzione è selezionata, la tassonomia non è visibile nel riquadro Filtro.
   • Elementi della tassonomia: un elenco di coppie Nome e Descrizione o URL che definiscono i valori disponibili per la tassonomia.
     • Nome: il nome viene generato automaticamente in base al nome visualizzato della tassonomia. Questo nome viene visualizzato quando posizioni il mouse sopra l'icona delle informazioni su nella pagina Panoramica.
     • URL:se viene inserito un URL, l'elemento della tassonomia viene visualizzato come URL.
     • Fai clic su Aggiungi elemento per aggiungere un altro elemento.
4. Fai clic su Salva (o Annulla).

Nota: ogni volta che una tassonomia di sistema non è impostata su una risorsa, nella UI viene visualizzato il valore Non specificato. Per i componenti di selezione della tassonomia viene visualizzata anche l'opzione Non specificato, se applicabile. Ad esempio, una tassonomia può non essere impostata se viene eliminata una tassonomia personalizzata.

Modifica tassonomia

Per modificare una tassonomia:

1. Nella console Cloud, vai alla pagina Hub API, Impostazioni, Tassonomie.

   Vai alle tassonomie dell'hub API

2. Fai clic su Modifica accanto a una tassonomia di sistema o su Altro > Modifica accanto a una tassonomia personalizzata.

3. Apporta le modifiche necessarie. Non tutti i campi per le Tassonomie di sistema possono essere modificati. Per ulteriori informazioni, consulta Tassonomie di sistema predefinite.

   Nota: se elimini un elemento della tassonomia da qualsiasi tassonomia, viene visualizzata una finestra di dialogo di conferma che indica che i valori per quella tassonomia verranno rimossi da tutte le API a cui è attualmente assegnato quell'elemento.
4. Fai clic su Salva (o Annulla).

Elimina tassonomia

Attenzione: l'eliminazione di una tassonomia ne comporta la rimozione da qualsiasi API che la utilizzava.

Per eliminare una tassonomia:

1. Nella console Cloud, vai alla pagina Hub API, Impostazioni, Tassonomie.

   Vai alle tassonomie dell'hub API

2. Fai clic su Altro > Elimina accanto alla tassonomia che ti interessa.

   Nota: puoi eliminare solo tassonomie personalizzate.
3. Fai clic su Elimina (o Annulla) nella richiesta di conferma.

Riordina elenco tassonomia

Le tassonomie possono essere riordinate per determinare l'ordine in cui vengono visualizzate nel riquadro Filtro delle API e nella pagina Panoramica dell'API.

Per riordinare l'elenco della tassonomia:

1. Nella console Cloud, vai alla pagina Hub API, Impostazioni, Tassonomie.

   Vai alle tassonomie dell'hub API

2. Fai clic su una Freccia su o giù fino a quando il ciclo di vita non si trova nella posizione che preferisci.