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

  • Articolo

Profili di versione e go

Un profilo è una combinazione di diversi tipi di risorse con versioni diverse da diversi servizi. L'uso di un profilo consente di combinare e trovare una corrispondenza tra tipi di risorse diversi. I profili possono offrire i vantaggi seguenti:

  • Stabilità per l'app bloccando le versioni API specifiche.
  • Compatibilità per l'app con Hub di Azure Stack e data center di Azure a livello di area.

In Go SDK i profili sono disponibili nel percorso dei profili. I numeri di versione del profilo vengono etichettati nel formato AAAAA-MM-DD . Ad esempio, il profilo API dell'hub di Azure Stack versione 2020-09-01 è disponibile per l'hub di Azure Stack versione 2102 o successiva. Per importare un determinato servizio da un profilo, importare il modulo corrispondente dal profilo. Ad esempio, per importare il servizio di calcolo dal profilo 2020-09-01 , usare il codice seguente:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Installare Azure SDK per Go

  1. Installare Git. Vedere Introduzione - Installazione di Git.
  2. Installare Go. I profili API per Azure richiedono Go versione 1.9 o successiva. Vedere Linguaggio di programmazione Go.

Profiles

Per usare un profilo o una versione SDK diversi, sostituire la data in un'istruzione di importazione, github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storagead esempio . Ad esempio, per la versione 2008, il profilo è 2019-03-01e la stringa diventa github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. 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.

Vedere Profili Go SDK.

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 il repository di esempio per il codice di esempio aggiornato. La radice README.md descrive i requisiti generali e ogni sottocartella contiene un esempio specifico con il proprio README.md su 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: