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 api per gli endpoint REST di Azure. È possibile creare client personalizzati in lingue diverse usando 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 usare 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. Allinea l'app a un profilo e l'SDK esegue il ripristino della versione dell'API corretta.

Questo argomento illustra come:

  • Informazioni sui profili API per l'hub di Azure Stack.
  • Informazioni su come usare i profili API per sviluppare le 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 API.
  • I profili API sono stati creati per creare modelli in più cloud di Azure. I profili forniscono un'interfaccia compatibile e stabile.
  • I profili vengono rilasciati quattro volte all'anno.
  • Vengono usate tre convenzioni di denominazione del profilo:
    • più recenti
      Contiene le versioni API più recenti rilasciate in Azure globale.
    • aa-mm-dd-hybrid
      Rilasciata bi-annualmente, questa versione si concentra sulla coerenza e sulla stabilità in più cloud. Questo profilo è destinato alla compatibilità ottimale dell'hub di Azure Stack.
    • y-mm-dd-profile
      Bilancia la stabilità ottimale e le funzionalità più recenti.

Profili API di Azure e compatibilità 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 hub di Azure Stack:

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

Aa-mm-dd-hybrid
Questo profilo viene rilasciato a marzo e settembre ogni anno. Offre stabilità e compatibilità ottimali con vari cloud ed è progettato per la destinazione globale di Azure e 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 le soluzioni cloud ibride.

y-mm-dd-profile
Questo profilo viene rilasciato per Azure globale in giugno e dicembre. Non funziona con l'hub di Azure Stack e in genere verranno apportate molte modifiche di rilievo. Anche se bilancia la stabilità ottimale e le funzionalità più recenti, la differenza tra l'ultima e questo profilo è sempre costituita dalle versioni più recenti dell'API, indipendentemente dal momento in cui l'API viene rilasciata. Ad esempio, se viene creata una nuova versione API per l'API di calcolo domani, tale versione dell'API è elencata nella versione più recente, ma non nel profilo aaaa-mm-dd-profile , perché questo profilo esiste già. Il profilo a-mm-dd-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 trovate in Azure globale. Quando si crea una soluzione, è necessario trovare la versione API per ogni provider di risorse di Azure compatibile con l'hub di Azure Stack.

Anziché 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 verrà ripristinato nella destinazione api-version specificata nel profilo. Con i profili API è possibile specificare una versione del profilo che si applica a un intero modello. In fase di esecuzione, l'Resource Manager di Azure seleziona la versione corretta della risorsa.

I profili API funzionano con strumenti che usano Azure Resource Manager, ad esempio PowerShell, l'interfaccia della riga di comando di Azure, il codice fornito nell'SDK e Microsoft Visual Studio. Gli strumenti e gli 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-versione 2016-03-30 e una macchina virtuale usando il provider di risorse Microsoft.Compute con api-versione 2015-12-01, è necessario cercare quale modulo 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 creare un'app basata su Python, è possibile specificare il profilo. L'SDK carica i moduli corretti per i provider di risorse specificati nello script.

Come sviluppatore, questo significa che è possibile concentrarsi sulla scrittura della soluzione. Invece di cercare le versioni dell'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:

  • .NET
    Usare il profilo API .NET per ottenere la versione più recente e stabile di ogni tipo di risorsa in un pacchetto del provider di risorse. Per altre informazioni, vedere Usare i profili di versione api con .NET nell'hub di Azure Stack.
  • PowerShell
    Usare il modulo Az.Bootstrapper disponibile tramite il PowerShell Gallery per ottenere i cmdlet di PowerShell necessari per usare i profili di versione dell'API. Per informazioni, vedere Usare i profili di versione api per PowerShell. Usare il modulo AzureRM.Bootstrapper disponibile tramite il PowerShell Gallery per ottenere i cmdlet di PowerShell necessari per usare i profili di versione api. Per informazioni, vedere Usare i profili di versione api per PowerShell.
  • Interfaccia della riga di comando di Azure
    Aggiornare la configurazione dell'ambiente per usare il profilo di versione dell'API specifico dell'hub di Azure Stack. Per informazioni, vedere Usare i profili di versione api per l'interfaccia della riga di comando di Azure.
  • Go
    In Go SDK un profilo è una combinazione di diversi tipi di risorse con versioni diverse da diversi servizi. I profili sono disponibili nel percorso/profili con la relativa versione nel formato YAAA-MM-DD . Per informazioni, vedere Usare i profili di versione api per Go.
  • Ruby
    Ruby SDK per l'hub di Azure Stack Resource Manager offre strumenti per creare e gestire l'infrastruttura. I provider di risorse nell'SDK includono calcolo, reti virtuali e archiviazione con il linguaggio Ruby. Per informazioni, vedere Usare i profili di versione dell'API con Ruby.
  • Python
    Python SDK supporta i profili di versione api per indirizzare diverse piattaforme cloud, ad esempio Hub di Azure Stack e Azure globale. Usare i profili API per creare soluzioni per un cloud ibrido. Per informazioni, vedere Usare i profili di versione api con Python.
  • Node.js
    L'SDK di Node.js per l'hub di Azure Stack Resource Manager offre strumenti per creare e gestire l'infrastruttura. Per altre informazioni, vedere Usare i profili di versione dell'API con Node.js.

Passaggi successivi