Come creare e pubblicare un prodotto in Gestione API di Azure

In Gestione API di Azure un prodotto contiene una o più API, oltre a una quota di utilizzo e alle condizioni per l'utilizzo. Dopo la pubblicazione di un prodotto, gli sviluppatori possono eseguire la sottoscrizione al prodotto e iniziare a usare le API del prodotto. L'argomento include una guida per la creazione di un prodotto, l'aggiunta di un'API e la pubblicazione per gli sviluppatori.

Creare un prodotto

Le operazioni vengono aggiunte e configurate in un'API nel portale di pubblicazione. Per accedere al portale di pubblicazione, fare clic su Portale di pubblicazione nel portale di Azure per il servizio Gestione API.

Portale di pubblicazione

Se non è stata creata un'istanza del servizio Gestione API, vedere Creare un'istanza di Gestione API nell'esercitazione Introduzione a Gestione API di Azure.

Fare clic su Prodotti nel menu a sinistra per visualizzare la pagina Prodotti e fare clic su Aggiungi prodotto.

Prodotti

Nuovo prodotto

Immettere un nome descrittivo per il prodotto nel campo Nome e una descrizione del prodotto nel campo Descrizione.

Lo stato dei prodotti in Gestione API può essere Aperto o Protetto. Per usare i prodotti protetti, è prima di tutto necessaria una sottoscrizione, mentre i prodotti aperti possono essere usati senza sottoscrizione. Per creare un prodotto protetto che richiede una sottoscrizione, selezionare Richiedi approvazione della sottoscrizione . Questa è l'impostazione predefinita.

Selezionare Richiedi approvazione della sottoscrizione se si preferisce che i tentativi di sottoscrizione al prodotto vengano esaminati e quindi accettati o rifiutati da un amministratore. Se la casella è deselezionata, i tentativi di sottoscrizione verranno approvati automaticamente. Per altre informazioni sulle sottoscrizioni, vedere Visualizzare i sottoscrittori di un prodotto.

Per consentire agli account per sviluppatore di sottoscrivere più volte il prodotto, selezionare la casella di controllo Consenti più sottoscrizioni . Se questa casella non è selezionata, ogni account per sviluppatore può sottoscrivere il prodotto una sola volta.

Più sottoscrizioni senza limitazioni

Per limitare il numero di più sottoscrizioni simultanee, selezionare la casella di controllo Limita numero di sottoscrizioni simultanee a e immettere il limite per le sottoscrizioni. Nell'esempio seguente le sottoscrizioni simultanee sono limitate a quattro per ogni account per sviluppatore.

Quattro sottoscrizioni

Dopo aver configurato tutte le opzioni del nuovo prodotto, fare clic su Salva per creare il nuovo prodotto.

Prodotti

Per impostazione predefinita, i nuovi prodotti non sono pubblicati e sono visibili solo agli utenti nel gruppo Amministratori.

Per configurare un prodotto, fare clic sul nome del prodotto nella scheda Prodotti .

Aggiungere API a un prodotto

La pagina Prodotti contiene quattro collegamenti per la configurazione: Riepilogo, Impostazioni, Visibilità e Sottoscrittori. La scheda Riepilogo consente di aggiungere le API e di pubblicare o annullare la pubblicazione di un prodotto.

Riepilogo

Prima di pubblicare il prodotto, è necessario aggiungere una o più API. A tale scopo, fare clic su Aggiungi API al prodotto.

Aggiunta di API

Selezionare le API desiderate e fare clic su Salva.

Aggiungere informazioni descrittive a un prodotto

La scheda Impostazioni consente di specificare informazioni dettagliate sul prodotto, ad esempio lo scopo, le API a cui fornisce l'accesso e altre informazioni utili. Il contenuto è indirizzato agli sviluppatori che chiameranno l'API e può essere scritto come testo normale o commenti HTML.

Impostazioni prodotto

Selezionare Richiedi sottoscrizione per creare un prodotto protetto che richiede l'uso di una sottoscrizione oppure deselezionarla per creare un prodotto aperto che può essere chiamato senza sottoscrizione.

Selezionare Richiedi approvazione della sottoscrizione se si preferisce approvare manualmente tutte le richieste di sottoscrizione al prodotto. Per impostazione predefinita, tutte le sottoscrizioni al prodotto vengono concesse automaticamente.

Per consentire agli account per sviluppatore di sottoscrivere più volte il prodotto, selezionare la casella di controllo Consenti più sottoscrizioni e, se necessario, specificare un limite. Se questa casella non è selezionata, ogni account per sviluppatore può sottoscrivere il prodotto una sola volta.

Immettere eventualmente nel campo Condizioni per l'utilizzo la descrizione delle condizioni per l'utilizzo del prodotto che i sottoscrittori devono accettare per usare il prodotto.

Pubblicare un prodotto

Per poter chiamare le API in un prodotto, il prodotto deve essere pubblicato. Nella scheda Riepilogo del prodotto fare clic su Pubblica, quindi su Sì, pubblica per confermare. Per impostare come privato un prodotto pubblicato in precedenza, fare clic Annulla pubblicazione.

Pubblicazione prodotto

Rendere un prodotto visibile per gli sviluppatori

La scheda Visibilità consente di scegliere i ruoli che possono visualizzare il prodotto nel portale per sviluppatori e sottoscrivere il prodotto.

Visibilità prodotto

Per abilitare o disabilitare la visibilità di un prodotto per gli sviluppatori di un gruppo, selezionare o deselezionare la casella di controllo accanto al gruppo e quindi fare clic su Salva.

Per altre informazioni, vedere Come creare e usare gruppi per gestire account di sviluppatori in Gestione API di Azure.

Visualizzare i sottoscrittori di un prodotto

Nella scheda Sottoscrittori sono elencati gli sviluppatori che hanno sottoscritto il prodotto. Per visualizzare i dettagli e le impostazioni per ogni sviluppatore, fare clic sul nome dello sviluppatore. In questo esempio nessuno sviluppatore ha ancora sottoscritto il prodotto.

Sviluppatori:

Passaggi successivi

Una volta che le API desiderate sono state aggiunte e il prodotto pubblicato, gli sviluppatori possono sottoscrivere il prodotto e iniziare a chiamare le API. Per una dimostrazione di questi elementi e della configurazione avanzata del prodotto, vedere l'esercitazione Come creare e configurare le impostazioni avanzate del prodotto in Gestione API di Azure.

Per altre informazioni sull'uso dei prodotti, vedere il video seguente.