Gestire i profili delle versioni dell'API nell'hub Azure StackManage API version profiles in Azure Stack Hub

I profili API specificano il provider di risorse di Azure e la versione dell'API per gli endpoint REST di Azure.API profiles specify the Azure resource provider and the API version for Azure REST endpoints. È possibile creare client personalizzati in linguaggi diversi usando i profili API.You can create custom clients in different languages using API profiles. Ogni client usa un profilo API per contattare il provider di risorse e la versione dell'API corretti per Azure Stack Hub.Each client uses an API profile to contact the correct resource provider and API version for Azure Stack Hub.

È possibile creare un'app per l'uso con i provider di risorse di Azure senza dover capire esattamente quale versione di ogni API del provider di risorse è compatibile con Azure Stack Hub.You can create an app to work with Azure resource providers without having to know exactly which version of each resource provider API is compatible with Azure Stack Hub. È sufficiente allineare l'app a un profilo e l'SDK ripristina la versione corretta dell'API.Just align your app to a profile and the SDK reverts to the correct API version.

Questo argomento illustra come:This topic helps you:

  • Informazioni sui profili API per l'hub Azure Stack.Understand API profiles for Azure Stack Hub.
  • Informazioni su come usare i profili API per sviluppare le soluzioni.Learn how you can use API profiles to develop your solutions.
  • Vedere dove trovare le linee guida specifiche del codice.See where to find code-specific guidance.

Riepilogo dei profili APISummary of API profiles

  • I profili API vengono usati per rappresentare un set di provider di risorse di Azure e le relative versioni API.API profiles are used to represent a set of Azure resource providers and their API versions.
  • Sono stati creati profili API per la creazione di modelli in più cloud di Azure.API profiles were created for you to create templates across multiple Azure clouds. I profili forniscono un'interfaccia compatibile e stabile.Profiles provide a compatible and stable interface.
  • I profili vengono rilasciati quattro volte all'anno.Profiles are released four times a year.
  • Vengono usate tre convenzioni di denominazione del profilo:Three profile naming conventions are used:
    • più recentilatest
      Contiene le versioni API più recenti rilasciate in Azure globale.Contains the most recent API versions released in global Azure.
    • aaaa-mm-gg-ibridoyyyy-mm-dd-hybrid
      Rilasciato bi-annualmente, questa versione è incentrata sulla coerenza e la stabilità in più cloud.Released bi-annually, this release focuses on consistency and stability across multiple clouds. Questo profilo è destinato alla compatibilità ottimale dell'hub Azure Stack.This profile targets optimal Azure Stack Hub compatibility.
    • aaaa-mm-gg-profiloyyyy-mm-dd-profile
      Bilancia la stabilità ottimale e le funzionalità più recenti.Balances optimal stability and the latest features.

Profili API di Azure e compatibilità dell'hub Azure StackAzure API profiles and Azure Stack Hub compatibility

I profili API di Azure più recenti non sono compatibili con l'hub Azure Stack.The newest Azure API profiles are not compatible with Azure Stack Hub. Usare le convenzioni di denominazione seguenti per identificare i profili da usare per le soluzioni dell'hub Azure Stack:Use the following naming conventions to identify which profiles to use for your Azure Stack Hub solutions:

Ultima versioneLatest
Questo profilo include le versioni dell'API più aggiornate presenti in Azure globale, che non funzionano nell'hub Azure Stack.This profile has the most up-to-date API versions found in global Azure, which do not work in Azure Stack Hub. Il più recente presenta il maggior numero di modifiche di rilievo.Latest has the largest number of breaking changes. Il profilo accantona la stabilità e la compatibilità con altri cloud.The profile puts aside stability and compatibility with other clouds. Se si sta provando a usare le versioni dell'API più aggiornate, più recente è il profilo da usare.If you're trying to use the most up-to-date API versions, Latest is the profile you should use.

Aaaa-mm-gg-ibridoYyyy-mm-dd-hybrid
Questo profilo viene rilasciato a marzo e settembre ogni anno.This profile is released in March and September every year. Offre stabilità e compatibilità ottimali con diversi cloud ed è progettato per l'hub globale di Azure e Azure Stack.It has optimal stability and compatibility with various clouds, and is designed to target global Azure and Azure Stack Hub. Le versioni dell'API di Azure elencate in questo profilo saranno identiche a quelle elencate nell'hub Azure Stack.The Azure API versions listed in this profile will be the same as the ones that are listed in Azure Stack Hub. Usare questo profilo per sviluppare codice per le soluzioni cloud ibride.Use this profile to develop code for hybrid cloud solutions.

aaaa-mm-gg-profiloyyyy-mm-dd-profile
Questo profilo è stato rilasciato per Azure globale in giugno e dicembre.This profile is released for global Azure in June and December. Non funziona con Azure Stack Hub e in genere sono presenti molte modifiche di rilievo.It does not work with Azure Stack Hub, and there will typically be many breaking changes. 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 l'API viene rilasciata.Although it balances optimal stability and the latest features, the difference between Latest and this profile is that Latest always consists of the newest API versions, regardless of when the API is released. Se, ad esempio, viene creata una nuova versione dell'API per l'API di calcolo domani, la versione dell'API è elencata nel profilo più recente, ma non nel profilo aaaa-mm-gg , perché questo profilo esiste già.For example, if a new API version is created for the Compute API tomorrow, that API version is listed in the Latest, but not in the yyyy-mm-dd-profile profile, because this profile already exists. aaaa-mm-gg-profile copre le versioni più aggiornate rilasciate prima di giugno o prima di dicembre.yyyy-mm-dd-profile covers the most up-to-date versions released before June or before December.

Profili API Azure Resource ManagerAzure Resource Manager API profiles

Azure Stack Hub non usa la versione più recente delle versioni dell'API disponibili in Azure globale.Azure Stack Hub does not use the latest version of the API versions found in global Azure. Quando si crea una soluzione, è necessario trovare la versione dell'API per ogni provider di risorse di Azure compatibile con Azure Stack Hub.When you create a solution, you must find the API version for each Azure resource provider that is compatible with Azure Stack Hub.

Anziché cercare ogni provider di risorse e la versione specifica supportata dall'hub Azure Stack, è possibile usare un profilo API.Rather than research every resource provider and the specific version supported by Azure Stack Hub, you can use an API profile. Il profilo specifica un set di provider di risorse e di versioni dell'API.The profile specifies a set of resource providers and API versions. L'SDK, o uno strumento compilato con l'SDK, verrà ripristinato nella destinazione api-version specificata nel profilo.The SDK, or a tool built with the SDK, will revert to the target api-version specified in the profile. Con i profili API è possibile specificare una versione del profilo applicabile a un intero modello.With API profiles, you can specify a profile version that applies to an entire template. In fase di esecuzione, il Azure Resource Manager seleziona la versione corretta della risorsa.At runtime, the Azure Resource Manager selects the right version of the resource.

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.API profiles work with tools that use Azure Resource Manager, such as PowerShell, Azure CLI, code provided in the SDK, and 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.Tools and SDKs can use profiles to read which version of the modules and libraries to include when building an app.

Se ad esempio 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 che usa il provider di risorse Microsoft. compute con API-Version 2015-12-01, è necessario cercare il modulo di PowerShell che supporta 2016-03-30 per l'archiviazione e il modulo che supporta 2015-02-01 per il calcolo e quindi installarli.For example, if you use PowerShell to create a storage account using the Microsoft.Storage resource provider, which supports api-version 2016-03-30 and a VM using the Microsoft.Compute resource provider with api-version 2015-12-01, you must look up which PowerShell module supports 2016-03-30 for Storage, and which module supports 2015-02-01 for Compute, and then install them. In alternativa, è possibile usare un profilo.Instead, you can use a profile. Usare il cmdlet Install-Profile <profilename> e PowerShell carica la versione corretta dei moduli.Use the cmdlet Install-Profile <profilename>, and PowerShell loads the correct version of the modules.

Analogamente, quando si usa Python SDK per creare un'app basata su Python, è possibile specificare il profilo.Similarly, when using the Python SDK to build a Python-based app, you can specify the profile. L'SDK carica i moduli corretti per i provider di risorse specificati nello script.The SDK loads the right modules for the resource providers that you've specified in your script.

Gli sviluppatori possono concentrarsi sulla scrittura della soluzione.As a developer, you can focus on writing your solution. Anziché eseguire una ricerca in base alle versioni API, al provider di risorse e al cloud, è possibile usare un profilo e tenere presente che il codice funziona in tutti i cloud che supportano tale profilo.Instead of researching which API versions, resource provider, and cloud work together, you can use a profile and know that your code works across all clouds that support that profile.

Esempi di codice del profilo APIAPI profile code samples

È possibile trovare esempi di codice che consentono di integrare la soluzione con il linguaggio preferito con Azure Stack hub usando i profili.You can find code samples to help you integrate your solution with your preferred language with Azure Stack Hub by using profiles. Attualmente, è possibile trovare linee guida ed esempi per le lingue seguenti:Currently, you can find guidance and samples for the following languages:

  • .NET.NET
    Usare il profilo dell'API .NET per ottenere la versione più recente e stabile di ogni tipo di risorsa in un pacchetto del provider di risorse.Use the .NET API profile to get the latest, most stable version of each resource type in a resource provider package. Per altre informazioni, vedere usare i profili delle versioni dell'API con .NET nell'Hub Azure stack.For more information, see Use API version profiles with .NET in Azure Stack Hub.
  • PowerShellPowerShell
    Usare il modulo AZ. bootstraper disponibile tramite il PowerShell Gallery per ottenere i cmdlet di PowerShell necessari per usare i profili di versione dell'API.Use the Az.Bootstrapper module available through the PowerShell Gallery to get the PowerShell cmdlets required to work with API version profiles. Per informazioni, vedere usare i profili delle versioni dell'API per PowerShell.For information, see Use API version profiles for PowerShell. Usare il modulo AzureRM. Bootstrapper disponibile tramite il PowerShell Gallery per ottenere i cmdlet di PowerShell necessari per lavorare con i profili delle versioni dell'API.Use the AzureRM.Bootstrapper module available through the PowerShell Gallery to get the PowerShell cmdlets required to work with API version profiles. Per informazioni, vedere usare i profili delle versioni dell'API per PowerShell.For information, see Use API version profiles for PowerShell.
  • Interfaccia della riga di comando di AzureAzure CLI
    Aggiornare la configurazione dell'ambiente per usare il profilo della versione API specifica dell'hub Azure Stack.Update your environment configuration to use the Azure Stack Hub specific API version profile. Per informazioni, vedere usare i profili delle versioni API per l'interfaccia della riga di comando di AzureFor information, see Use API version profiles for Azure CLI.
  • GoGo
    In go SDK un profilo è una combinazione di diversi tipi di risorse con versioni diverse di servizi diversi.In the Go SDK, a profile is a combination of different resource types with different versions from different services. I profili sono disponibili sotto i profili/percorso con la relativa versione nel formato aaaa-mm-gg .Profiles are available under the profiles/path with their version in the YYYY-MM-DD format. Per informazioni, vedere usare i profili di versione dell'API per go.For information, see Use API version profiles for Go.
  • RubyRuby
    Ruby SDK per l'hub Azure Stack Gestione risorse fornisce strumenti che semplificano la creazione e la gestione dell'infrastruttura.The Ruby SDK for the Azure Stack Hub Resource Manager provides tools to help you build and manage your infrastructure. I provider di risorse nell'SDK includono il calcolo, le reti virtuali e l'archiviazione con il linguaggio Ruby.Resource providers in the SDK include compute, virtual networks, and storage with the Ruby language. Per informazioni, vedere usare i profili delle versioni dell'API con Ruby.For information, see Use API version profiles with Ruby.
  • PythonPython
    Python SDK supporta i profili di versione dell'API per piattaforme cloud diverse, ad esempio Azure Stack Hub e Azure globale.The Python SDK supports API version profiles to target different cloud platforms such as Azure Stack Hub and global Azure. Usare i profili API per creare soluzioni per un cloud ibrido.Use API profiles to create solutions for a hybrid cloud. Per informazioni, vedere usare i profili delle versioni dell'API con Python.For information, see Use API version profiles with Python.
  • Node.jsNode.js
    Il Node.js SDK per l'hub Azure Stack Gestione risorse fornisce strumenti che semplificano la creazione e la gestione dell'infrastruttura.The Node.js SDK for the Azure Stack Hub Resource Manager provides tools to help you build and manage your infrastructure. Per altre informazioni, vedere usare i profili delle versioni dell'API con Node.js.For more information, see Use API version Profiles with Node.js.

Passaggi successiviNext steps