Použití profilů verzí rozhraní API s Go ve službě Azure Stack Hub
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
- Nainstalujte Git. Viz Začínáme – Instalace Gitu.
- 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-01
profil a řetězec se změní github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage
na . 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 ve2020-09-01
verzi profilu můžete změnitapi-version
na2019-10-01
pro poskytovatelemicrosoft.resources
prostř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:
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro