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

Článek
10/30/2024

Důležité

Sada .NET SDK byla aktualizována ze skladby 1 na trasu 2. Důrazně doporučujeme migrovat na sadu Track 2 SDK co nejdříve. Pokyny najdete v tomto průvodci migrací .

Sada .NET SDK pro službu Azure Stack Hub Resource Manager poskytuje nástroje, které vám pomůžou sestavovat a spravovat infrastrukturu. Poskytovatelé prostředků v sadě SDK zahrnují výpočty, sítě, úložiště, služby App Services a Key Vault. Sada .NET SDK obsahuje 14 balíčků NuGet. Pokud používáte zastaralou sadu .NET SDK 1 (nedoporučuje se), tyto balíčky mají verze s profily rozhraní API, například 2020-09-01-hybrid a 2019-03-01-hybrid. Profily rozhraní API v sadě .NET SDK umožňují vývoj hybridního cloudu tím, že pomáhají přepínat mezi globálními prostředky Azure a prostředky služby Azure Stack Hub. Další informace najdete v části Profily verzí rozhraní .NET a rozhraní API .

Instalace sady Azure .NET SDK

Nainstalujte Git. Pokyny najdete v tématu Začínáme – Instalace Gitu.
Informace o instalaci správných balíčků NuGet najdete v tématu Dostupné distribuční verze NuGet.

Profily verzí rozhraní .NET a rozhraní API

Profil rozhraní API je kombinací poskytovatelů prostředků a verzí rozhraní API. Pomocí profilu rozhraní API získáte nejnovější a nejstabilnější verzi každého typu prostředku v balíčku poskytovatele prostředků.

Pokud používáte sadu .NET SDK track 2 (doporučeno), můžete v kódu použít standardní Azure.* balíčky a nakonfigurovat verze rozhraní API. Příklady tohoto dotazu pro standardní Azure.* balíčky najdete v části s ukázkami.
Pokud používáte sadu .NET SDK track 1 (nedoporučuje se), musíte si stáhnout jeden z následujících balíčků, abyste mohli využívat služby Azure Stack Hub. Nezapomeňte si stáhnout ten, který odpovídá vašemu profilu rozhraní API:
- Microsoft.Azure.Management.Profiles.hybrid_2020_09_01.<ResourceProvider>. 1.0.0.nupkg
- Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.<ResourceProvider>. 0.9.0-preview.nupkg

Poznámka

Část ResourceProvider specifikace balíčku NuGet musí být změněna. Kromě toho jsou balíčky pro sadu .NET SDK track 1 zastaralé, takže můžete narazit na chyby. Doporučujeme co nejdříve aktualizovat sadu .NET SDK track 2.

Profily

Pokud chcete použít jiný profil nebo verzi sady SDK pro profily obsahující kalendářní data, nahraďte datum v Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManagersouboru . Například pro verzi 2008 je profil a řetězec se 2019_03_01změní Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManagerna . Všimněte si, že tým SDK někdy změní název balíčků, takže jednoduché nahrazení data řetězce jiným datem nemusí fungovat. Přidružení profilů a verzí služby Azure Stack najdete v následující tabulce.

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.

Předplatné

Pokud ještě předplatné nemáte, vytvořte předplatné a uložte si 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 jeho přidružené informace o 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 může stačit role contributor . 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ý vzorový kód nebo další informace najdete v ukázkovém úložišti .

ID tenanta

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

Registrace poskytovatelů prostředků

Podle pokynů v tomto 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, vyžaduje se Microsoft.Compute 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 (track 2) najdete v tomto ukázkovém úložišti . Ukázkový kód track 1 najdete v tomto 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ím README.md , který popisuje, jak ukázku 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:

Sdílet prostřednictvím