Gestire i profili delle versioni API nell'hub di Azure Stack

  • Articolo

I profili API specificano il provider di risorse di Azure e la versione dell'API per gli endpoint REST di Azure. È possibile creare client personalizzati in lingue diverse usando i profili API. Ogni client usa un profilo API per contattare il provider di risorse e la versione api corretti per l'hub di Azure Stack.

È possibile creare un'app per lavorare con i provider di risorse di Azure senza dover sapere esattamente quale versione di ogni API del provider di risorse è compatibile con l'hub di Azure Stack. È sufficiente allineare l'app a un profilo e l'SDK ripristina la versione corretta dell'API.

Questo argomento consente di:

  • Informazioni sui profili API per l'hub di Azure Stack.
  • Informazioni su come usare i profili API per sviluppare soluzioni.
  • Vedere dove trovare indicazioni specifiche del codice.

Riepilogo dei profili API

  • I profili API vengono usati per rappresentare un set di provider di risorse di Azure e le relative versioni dell'API.
  • I profili API sono stati creati per creare modelli in più cloud di Azure. I profili offrono un'interfaccia compatibile e stabile.
  • I profili vengono rilasciati quattro volte all'anno.
  • Vengono usate tre convenzioni di denominazione dei profili:
    • ultimissimo
      Contiene le versioni api più recenti rilasciate in Azure globale.
    • aaaa-mm-gg-hybrid
      Rilasciata bi-annualmente, questa versione è incentrata sulla coerenza e sulla stabilità tra più cloud. Questo profilo è destinato alla compatibilità ottimale dell'hub di Azure Stack.
    • Aaaa-mm-gg-profile
      Bilancia la stabilità ottimale e le funzionalità più recenti.

Compatibilità dei profili API di Azure e dell'hub di Azure Stack

I profili API di Azure più recenti non sono compatibili con l'hub di Azure Stack. Usare le convenzioni di denominazione seguenti per identificare i profili da usare per le soluzioni dell'hub di Azure Stack:

ultimissimo
Questo profilo include le versioni API più aggiornate disponibili in Azure globale, che non funzionano nell'hub di Azure Stack. latest ha il maggior numero di modifiche di rilievo. Il profilo mette da parte stabilità e compatibilità con altri cloud. Se si sta provando a usare le versioni api più aggiornate, la versione più recente è il profilo da usare.

Aaaa-mm-gg-hybrid
Questo profilo viene rilasciato a marzo e settembre ogni anno. Ha una stabilità e una compatibilità ottimali con vari cloud ed è progettato per la destinazione globale di Azure e dell'hub di Azure Stack. Le versioni dell'API di Azure elencate in questo profilo saranno uguali a quelle elencate nell'hub di Azure Stack. Usare questo profilo per sviluppare codice per soluzioni cloud ibride.

Aaaa-mm-gg-profile
Questo profilo viene rilasciato per Azure globale in giugno e dicembre. Non funziona con l'hub di Azure Stack e in genere ci saranno molte modifiche di rilievo. Anche se bilancia la stabilità ottimale e le funzionalità più recenti, la differenza tra la versione più recente e questo profilo è che l'ultima è sempre costituita dalle versioni più recenti dell'API, indipendentemente dal momento in cui viene rilasciata l'API. Ad esempio, se viene creata una nuova versione dell'API per l'API di calcolo domani, tale versione dell'API è elencata nella versione più recente, ma non nel profilo aa-mm-dd-profile , perché questo profilo esiste già. Aaaa-mm-gg-profile copre le versioni più aggiornate rilasciate prima di giugno o prima di dicembre.

Profili API di Azure Resource Manager

L'hub di Azure Stack non usa la versione più recente delle versioni dell'API disponibili in Azure globale. Quando si crea una soluzione, è necessario trovare la versione dell'API per ogni provider di risorse di Azure compatibile con l'hub di Azure Stack.

Invece di cercare ogni provider di risorse e la versione specifica supportata dall'hub di Azure Stack, è possibile usare un profilo API. Il profilo specifica un set di provider di risorse e versioni api. L'SDK o uno strumento compilato con l'SDK ripristina la destinazione api-version specificata nel profilo. Con i profili API è possibile specificare una versione del profilo applicabile a un intero modello. In fase di esecuzione, Azure Resource Manager seleziona la versione corretta della risorsa.

I profili API funzionano con strumenti che usano Azure Resource Manager, ad esempio PowerShell, interfaccia della riga di comando di Azure, codice fornito nell'SDK e Microsoft Visual Studio. Strumenti e SDK possono usare i profili per leggere la versione dei moduli e delle librerie da includere durante la compilazione di un'app.

Ad esempio, se si usa PowerShell per creare un account di archiviazione usando il provider di risorse Microsoft.Storage, che supporta api-version 2016-03-30 e una macchina virtuale usando il provider di risorse Microsoft.Compute con api-version 2015-12-01, è necessario cercare quale modulo di PowerShell supporta 2016-03-30 per Archiviazione e quale modulo supporta 2015-02-01 per Calcolo e quindi installarli. È invece possibile usare un profilo. Usare il cmdlet Install-Profile <profilename>e PowerShell carica la versione corretta dei moduli.

Analogamente, quando si usa Python SDK per compilare un'app basata su Python, è possibile specificare il profilo. L'SDK carica i moduli corretti per i provider di risorse specificati nello script.

In qualità di sviluppatore, questo significa che è possibile concentrarsi sulla scrittura della soluzione. Invece di cercare le versioni api, il provider di risorse e il cloud interagiscono, è possibile usare un profilo e sapere che il codice funziona in tutti i cloud che supportano tale profilo.

Esempi di codice del profilo API

È possibile trovare esempi di codice per integrare la soluzione con il linguaggio preferito con l'hub di Azure Stack usando i profili. Attualmente, è possibile trovare indicazioni ed esempi per le lingue seguenti:

Passaggi successivi