Použití profilů verzí rozhraní API s Go ve službě Azure Stack Hub

  • Článek

Go a profily verzí

Profil je kombinace různých typů prostředků s různými verzemi z různých služeb. Použití profilu pomáhá kombinovat a shodovat různé typy prostředků. Profily můžou poskytovat následující výhody:

  • Stabilita vaší aplikace díky uzamčení na konkrétní verze rozhraní API.
  • Kompatibilita vaší aplikace se službou Azure Stack Hub a regionálními datovými centry Azure

V go sdk jsou profily k dispozici v cestě k profilům. Čísla verzí profilu jsou označená ve formátu RRRR-MM-DD . Například profil rozhraní API služby Azure Stack Hub verze 2020-09-01 je určený pro službu Azure Stack Hub verze 2102 nebo novější. Pokud chcete importovat danou službu z profilu, naimportujte její odpovídající modul z profilu. Pokud například chcete importovat službu Compute z profilu 2020-09-01 , použijte následující kód:

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

Instalace Azure SDK for Go

  1. Nainstalujte Git. Viz Začínáme – Instalace Gitu.
  2. Nainstalujte go. Profily rozhraní API pro Azure vyžadují go verze 1.9 nebo novější. Viz Programovací jazyk Go.

Profily

Pokud chcete použít jiný profil nebo verzi sady SDK, nahraďte datum v příkazu importu, například github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Například pro verzi 2008 je 2019-03-01profil a řetězec se změní github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storagena . Všimněte si, že někdy tým SADY SDK změní název balíčků, takže pouhé nahrazení data řetězce jiným datem nemusí fungovat. V následující tabulce najdete informace o přidružení profilů a verzí služby Azure Stack.

Verze služby Azure Stack 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

Další informace o službě Azure Stack Hub a profilech rozhraní API najdete v tématu Souhrn profilů rozhraní API.

Viz Profily sady Go SDK.

Předplatné

Pokud ještě předplatné nemáte, vytvořte předplatné a uložte ID předplatného, abyste ho mohli použít později. Informace o tom, jak vytvořit předplatné, najdete v tomto dokumentu.

Instanční objekt

Instanční objekt a informace o jeho přidruženém prostředí by se měly někde vytvořit a uložit. Doporučuje se instanční objekt s owner rolí, ale v závislosti na ukázce contributor může stačit role. Požadované hodnoty najdete v souboru README v ukázkovém úložišti . Tyto hodnoty můžete číst v libovolném formátu podporovaném jazykem sady SDK, například ze souboru JSON (který používají naše ukázky). V závislosti na spuštěné ukázce se nedají použít všechny tyto hodnoty. Aktualizovaný ukázkový kód nebo další informace najdete v ukázkovém úložišti .

ID tenanta

Pokud chcete najít ID adresáře nebo tenanta pro službu Azure Stack Hub, postupujte podle pokynů v tomto článku.

Registrace poskytovatelů prostředků

Podle tohoto dokumentu zaregistrujte požadované poskytovatele prostředků. Tito poskytovatelé prostředků budou vyžadováni v závislosti na ukázkách, které chcete spustit. Pokud například chcete spustit ukázku virtuálního počítače, Microsoft.Compute vyžaduje se registrace poskytovatele prostředků.

Koncový bod Azure Stack Resource Manageru

Azure Resource Manager (ARM) je architektura pro správu, která správcům umožňuje nasazovat, spravovat a monitorovat prostředky Azure. Azure Resource Manager může tyto úlohy zpracovávat jako skupinu, nikoli jednotlivě, v rámci jedné operace. Informace o metadatech můžete získat z koncového bodu Resource Manager. Koncový bod vrátí soubor JSON s informacemi potřebnými ke spuštění kódu.

  • ResourceManagerEndpointUrl v sadě Azure Stack Development Kit (ASDK) je: https://management.local.azurestack.external/.
  • ResourceManagerEndpointUrl v integrovaných systémech je: https://management.region.<fqdn>/, kde <fqdn> je plně kvalifikovaný název domény.
  • Načtení požadovaných metadat: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Dostupné verze rozhraní API najdete v tématu Specifikace rozhraní Azure Rest API. Například ve 2020-09-01 verzi profilu můžete změnit api-version na 2019-10-01 pro poskytovatele microsoft.resourcesprostředků .

Ukázkový kód 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"]
      }
}

Ukázky

Ukázkový kód aktualizace k datu najdete v ukázkovém úložišti . Kořen README.md popisuje obecné požadavky a každý podadresář obsahuje konkrétní ukázku s vlastní README.md ukázkou, jak ji spustit.

Ukázku použitelnou pro verzi 2008 nebo profil 2019-03-01 služby Azure Stack najdete tady a níže.

Další kroky

Další informace o profilech rozhraní API: