Usare i profili di versione api con .NET nell'hub di Azure Stack
Importante
.NET SDK è stato aggiornato dalla traccia 1 alla traccia 2. È consigliabile eseguire la migrazione al track 2 SDK il prima possibile. Per istruzioni, vedere questa guida alla migrazione .
.NET SDK per l'hub di Azure Stack Resource Manager fornisce strumenti per creare e gestire l'infrastruttura. I provider di risorse nell'SDK includono calcolo, rete, archiviazione, servizi app e Key Vault. .NET SDK include 14 pacchetti NuGet. Se si usa la traccia deprecata 1 .NET SDK (non consigliata), questi pacchetti vengono versioni con profili API, ad esempio 2020-09-01-ibrido e 2019-03-01-ibrido. I profili API in .NET SDK consentono lo sviluppo cloud ibrido consentendo di passare tra risorse globali di Azure e risorse dell'hub di Azure Stack. Per altre informazioni, vedere la sezione Profili di versione di .NET e API .
Installare Azure .NET SDK
- Installare Git. Per istruzioni, vedere Introduzione - Installazione di Git.
- Per installare i pacchetti NuGet corretti, vedere Versioni di distribuzione NuGet disponibili.
Profili di versione di .NET e API
Un profilo API è una combinazione di provider di risorse e versioni API. Usare un profilo API per ottenere la versione più recente e stabile di ogni tipo di risorsa in un pacchetto del provider di risorse.
Se si usa la traccia 2 .NET SDK (consigliata), è possibile usare i pacchetti standard
Azure.*e configurare le versioni api all'interno del codice. Vedere la sezione esempi per esempi di questa e questa query per i pacchetti standardAzure.*.Se si usa la traccia 1 .NET SDK (non consigliata), è necessario scaricare uno dei pacchetti seguenti per sfruttare i servizi dell'hub di Azure Stack. Assicurarsi di scaricare quello che corrisponde al profilo API:
Nota
La parte ResourceProvider della specifica del pacchetto NuGet deve essere modificata. Inoltre, i pacchetti per tenere traccia di 1 .NET SDK sono deprecati, in modo da poter affrontare errori. È consigliabile eseguire l'aggiornamento alla traccia 2 .NET SDK il prima possibile.
Profiles
Per i profili contenenti date, per usare un profilo o una versione SDK diversi, sostituire la data in Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager. Ad esempio, per la versione 2008, il profilo è 2019_03_01e la stringa diventa Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. Si noti che a volte il team SDK modifica il nome dei pacchetti, quindi è sufficiente sostituire la data di una stringa con una data diversa potrebbe non funzionare. Vedere la tabella seguente per l'associazione di profili e versioni di Azure Stack.
| Versione di Azure Stack | Profilo |
|---|---|
| 2311 | 2020_09_01 |
| 2301 | 2020_09_01 |
| 2206 | 2020_09_01 |
| 2108 | 2020_09_01 |
| 2102 | 2020_09_01 |
| 2008 | 2019_03_01 |
Per altre informazioni sui profili dell'hub e delle API di Azure Stack, vedere Riepilogo dei profili API.
Subscription
Se non si ha già una sottoscrizione, creare una sottoscrizione e salvare l'ID sottoscrizione da usare in un secondo momento. Per informazioni su come creare una sottoscrizione, vedere questo documento.
Entità servizio
È necessario creare e salvare un'entità servizio e le relative informazioni sull'ambiente associate. L'entità servizio con owner ruolo è consigliata, ma a seconda dell'esempio, un contributor ruolo può essere sufficiente. Per i valori necessari, vedere README nel repository di esempio . È possibile leggere questi valori in qualsiasi formato supportato dal linguaggio SDK, ad esempio da un file JSON (che vengono usati dagli esempi). A seconda dell'esecuzione dell'esempio, non tutti questi valori possono essere usati. Vedere il repository di esempio per il codice di esempio aggiornato o altre informazioni.
ID tenant
Per trovare la directory o l'ID tenant per l'hub di Azure Stack, seguire le istruzioni riportate in questo articolo.
Registrare i provider di risorse
Registrare i provider di risorse necessari seguendo questo documento. Questi provider di risorse saranno necessari a seconda degli esempi da eseguire. Ad esempio, se si vuole eseguire un esempio di macchina virtuale, è necessaria la registrazione del Microsoft.Compute provider di risorse.
Endpoint di Azure Stack resource manager
Azure Resource Manager (ARM) è un framework di gestione che consente agli amministratori di distribuire, gestire e monitorare le risorse di Azure. Azure Resource Manager può gestire queste attività come gruppo, anziché singolarmente, in una singola operazione. È possibile ottenere le informazioni sui metadati dall'endpoint di Resource Manager. L'endpoint restituisce un file JSON con le informazioni necessarie per eseguire il codice.
-
ResourceManagerEndpointUrl in Azure Stack Development Kit (ASDK) è:
https://management.local.azurestack.external/. -
ResourceManagerEndpointUrl nei sistemi integrati è:
https://management.region.<fqdn>/, dove<fqdn>è il nome di dominio completo. - Per recuperare i metadati necessari:
<ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Per le versioni api disponibili, vedere Specifiche dell'API rest di Azure. Ad esempio, nella versione del2020-09-01profilo è possibile modificare in per ilapi-version2019-10-01providermicrosoft.resourcesdi risorse .
JSON di esempio:
{
"galleryEndpoint": "https://portal.local.azurestack.external:30015/",
"graphEndpoint": "https://graph.windows.net/",
"portal Endpoint": "https://portal.local.azurestack.external/",
"authentication":
{
"loginEndpoint": "https://login.windows.net/",
"audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
}
}
Esempi
Vedere questo repository di esempio per il codice di esempio update-to-date (track 2). Vedere questo repository di esempio per il codice di esempio traccia 1. La radice README.md descrive i requisiti generali e ogni sottocartella contiene un esempio specifico con il proprio README.md che descrive come eseguire tale esempio.
Per l'esempio applicabile alla versione 2008 o al profilo 2019-03-01 di Azure Stack, vedere qui.
Passaggi successivi
Altre informazioni sui profili API: