Använda API-versionsprofiler med Go i Azure Stack Hub

  • Artikel

Go- och versionsprofiler

En profil är en kombination av olika resurstyper med olika versioner från olika tjänster. Med hjälp av en profil kan du blanda och matcha mellan olika resurstyper. Profiler kan ge följande fördelar:

  • Stabilitet för din app genom att låsa till specifika API-versioner.
  • Kompatibilitet för din app med Azure Stack Hub och regionala Azure-datacenter.

I Go SDK är profiler tillgängliga under profilsökvägen. Profilversionsnummer är märkta i formatet ÅÅÅÅ-MM-DD . Till exempel är Azure Stack Hub API-profilversion 2020-09-01för Azure Stack Hub-versionerna 2102 eller senare. Om du vill importera en viss tjänst från en profil importerar du motsvarande modul från profilen. Om du till exempel vill importera Compute-tjänsten från profilen 2020-09-01 använder du följande kod:

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

Installera Azure SDK för Go

  1. Installera Git. Se Komma igång – Installera Git.
  2. Installera Go. API-profiler för Azure kräver Go version 1.9 eller senare. Se Programmeringsspråket Go.

Profiler

Om du vill använda en annan SDK-profil eller version ersätter du datumet i en import-instruktion, till exempel github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. För 2008-versionen är 2019-03-01till exempel profilen och strängen blir github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. Observera att SDK-teamet ibland ändrar namnet på paketen, så att helt enkelt ersätta datumet för en sträng med ett annat datum kanske inte fungerar. Se följande tabell för association av profiler och Azure Stack-versioner.

Azure Stack-version Profil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

Mer information om Azure Stack Hub- och API-profiler finns i Sammanfattning av API-profiler.

Se Go SDK-profiler.

Prenumeration

Om du inte redan har en prenumeration skapar du en prenumeration och sparar prenumerations-ID:t som ska användas senare. Information om hur du skapar en prenumeration finns i det här dokumentet.

Tjänstens huvudnamn

Ett huvudnamn för tjänsten och dess associerade miljöinformation bör skapas och sparas någonstans. Tjänstens huvudnamn med owner roll rekommenderas, men beroende på exemplet kan en contributor roll räcka. Referera till README i exempellagringsplatsen för de värden som krävs. Du kan läsa dessa värden i valfritt format som stöds av SDK-språket, till exempel från en JSON-fil (som våra exempel använder). Beroende på vilket exempel som körs kan inte alla dessa värden användas. Se exempellagringsplatsen för uppdaterad exempelkod eller ytterligare information.

Klientorganisations-ID

Följ anvisningarna i den här artikeln om du vill hitta katalogen eller klientorganisations-ID:t för din Azure Stack Hub.

Registrera resursprovidrar

Registrera nödvändiga resursprovidrar genom att följa det här dokumentet. Dessa resursprovidrar krävs beroende på vilka exempel du vill köra. Om du till exempel vill köra ett virtuellt datorexempel krävs registreringen av resursprovidern Microsoft.Compute .

Azure Stack Resource Manager-slutpunkt

Azure Resource Manager (ARM) är ett hanteringsramverk som gör det möjligt för administratörer att distribuera, hantera och övervaka Azure-resurser. Azure Resource Manager kan hantera dessa uppgifter som en grupp, snarare än individuellt, i en enda åtgärd. Du kan hämta metadatainformationen från Resource Manager slutpunkten. Slutpunkten returnerar en JSON-fil med den information som krävs för att köra koden.

  • ResourceManagerEndpointUrl i Azure Stack Development Kit (ASDK) är: https://management.local.azurestack.external/.
  • ResourceManagerEndpointUrl i integrerade system är: https://management.region.<fqdn>/, där <fqdn> är ditt fullständigt kvalificerade domännamn.
  • Så här hämtar du de metadata som krävs: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Tillgängliga API-versioner finns i Specifikationer för Azure REST API. I profilversionen kan du t.ex 2020-09-01 . ändra api-version till 2019-10-01 för resursprovidern microsoft.resources.

Exempel på 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"]
      }
}

Exempel

Se exempellagringsplatsen för uppdaterings- och datumexempelkod. Roten README.md beskriver allmänna krav, och varje underkatalog innehåller ett specifikt exempel med egen README.md information om hur du kör exemplet.

Här finns det exempel som gäller för Azure Stack-version 2008 eller -profil 2019-03-01 och nedan.

Nästa steg

Läs mer om API-profiler: