Usare i profili di versione api con .NET nell'hub di Azure Stack

  • Articolo

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

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.

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 del 2020-09-01 profilo è possibile modificare in per il api-version2019-10-01 provider microsoft.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: