API-versieprofielen gebruiken met Go in Azure Stack Hub

  • Artikel

Go- en versieprofielen

Een profiel is een combinatie van verschillende resourcetypen met verschillende versies van verschillende services. Als u een profiel gebruikt, kunt u verschillende resourcetypen combineren. Profielen kunnen de volgende voordelen bieden:

  • Stabiliteit voor uw app door specifieke API-versies te vergrendelen.
  • Compatibiliteit voor uw app met Azure Stack Hub en regionale Azure-datacenters.

In de Go SDK zijn profielen beschikbaar onder het pad naar profielen. Profielversienummers worden gelabeld in de indeling JJJJ-MM-DD . Azure Stack Hub API-profielversie 2020-09-01 is bijvoorbeeld voor Azure Stack Hub-versies 2102 of hoger. Als u een bepaalde service uit een profiel wilt importeren, importeert u de bijbehorende module uit het profiel. Als u bijvoorbeeld de Compute-service wilt importeren uit het profiel 2020-09-01 , gebruikt u de volgende code:

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

De Azure SDK voor Go installeren

  1. Installeer Git. Zie Aan de slag - Git installeren.
  2. Installeer Go. VOOR API-profielen voor Azure is Go-versie 1.9 of hoger vereist. Zie Programmeertaal Go.

Profielen

Als u een ander SDK-profiel of een andere versie wilt gebruiken, vervangt u de datum in een importinstructie, zoals github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Voor versie 2008 is 2019-03-01het profiel bijvoorbeeld , en wordt de tekenreeks github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. Houd er rekening mee dat het SDK-team soms de naam van de pakketten wijzigt, dus het vervangen van de datum van een tekenreeks door een andere datum werkt mogelijk niet. Zie de volgende tabel voor het koppelen van profielen en Azure Stack-versies.

Azure Stack-versie Profiel
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

Zie Samenvatting van API-profielen voor meer informatie over Azure Stack Hub- en API-profielen.

Zie Go SDK-profielen.

Abonnement

Als u nog geen abonnement hebt, maakt u een abonnement en slaat u de abonnements-id op voor later gebruik. Zie dit document voor meer informatie over het maken van een abonnement.

Service-principal

Een service-principal en de bijbehorende omgevingsgegevens moeten worden gemaakt en ergens worden opgeslagen. Service-principal met owner rol wordt aanbevolen, maar afhankelijk van het voorbeeld kan een contributor rol voldoende zijn. Raadpleeg leesmij in de voorbeeldopslagplaats voor de vereiste waarden. U kunt deze waarden lezen in elke indeling die wordt ondersteund door de SDK-taal, zoals in een JSON-bestand (dat in onze voorbeelden wordt gebruikt). Afhankelijk van het voorbeeld dat wordt uitgevoerd, kunnen niet al deze waarden worden gebruikt. Zie de voorbeeldopslagplaats voor bijgewerkte voorbeeldcode of meer informatie.

Tenant-id

Volg de instructies in dit artikel om de map of tenant-id voor uw Azure Stack Hub te vinden.

Resourceprovider registreren

Registreer vereiste resourceproviders door dit document te volgen. Deze resourceproviders zijn vereist, afhankelijk van de voorbeelden die u wilt uitvoeren. Als u bijvoorbeeld een VM-voorbeeld wilt uitvoeren, is registratie van de Microsoft.Compute resourceprovider vereist.

Azure Stack Resource Manager-eindpunt

Azure Resource Manager (ARM) is een beheerframework waarmee beheerders Azure-resources kunnen implementeren, beheren en bewaken. Azure Resource Manager kunt deze taken als een groep afhandelen, in plaats van afzonderlijk, in één bewerking. U kunt de metagegevensgegevens ophalen van het Resource Manager-eindpunt. Het eindpunt retourneert een JSON-bestand met de informatie die nodig is om uw code uit te voeren.

  • De ResourceManagerEndpointUrl in de Azure Stack Development Kit (ASDK) is: https://management.local.azurestack.external/.
  • De ResourceManagerEndpointUrl in geïntegreerde systemen is: https://management.region.<fqdn>/, waarbij <fqdn> uw fully qualified domain name is.
  • Om de vereiste metagegevens op te halen: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Zie Azure REST API-specificaties voor beschikbare API-versies. In de profielversie kunt u bijvoorbeeld 2020-09-01 de wijzigen in 2019-10-01 voor resourceprovider microsoft.resourcesapi-version .

Voorbeeld van JSON:

{
   "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"]
      }
}

Voorbeelden

Zie de voorbeeldopslagplaats voor voorbeeldcode voor update-to-date. De hoofdmap README.md beschrijft de algemene vereisten en elke submap bevat een specifiek voorbeeld met een eigen README.md voorbeeld over het uitvoeren van dat voorbeeld.

Kijk hier voor het voorbeeld dat van toepassing is op azure Stack-versie 2008 of -profiel 2019-03-01 en hieronder.

Volgende stappen

Meer informatie over API-profielen: