Använda API-versionsprofiler med .NET i Azure Stack Hub

Artikel
10/30/2024

Viktigt

.NET SDK har uppdaterats från spår 1 till spår 2. Vi rekommenderar starkt att du migrerar till spår 2 SDK så snart som möjligt. Anvisningar finns i den här migreringsguiden .

.NET SDK för Azure Stack Hub-Resource Manager innehåller verktyg som hjälper dig att skapa och hantera din infrastruktur. Resursprovidrar i SDK:n inkluderar Compute, Networking, Storage, App Services och Key Vault. .NET SDK innehåller 14 NuGet-paket. Om du använder det inaktuella spåret 1 .NET SDK (rekommenderas inte) är dessa paket versionerade med API-profiler, till exempel 2020-09-01-hybrid och 2019-03-01-hybrid. API-profiler i .NET SDK möjliggör hybridmolnutveckling genom att hjälpa dig att växla mellan globala Azure-resurser och Azure Stack Hub-resurser. Mer information finns i avsnittet versionsprofiler för .NET och API .

Installera Azure .NET SDK

Installera Git. Anvisningar finns i Komma igång – Installera Git.
Information om hur du installerar rätt NuGet-paket finns i Tillgängliga NuGet-distributionsversioner.

Versionsprofiler för .NET och API

En API-profil är en kombination av resursprovidrar och API-versioner. Använd en API-profil för att få den senaste, mest stabila versionen av varje resurstyp i ett resursproviderpaket.

Om du använder spår 2 .NET SDK (rekommenderas) kan du använda standardpaketen Azure.* och konfigurera API-versioner i koden. Se exempelavsnittet för exempel på detta och den här frågan för standardpaket Azure.* .
Om du använder spåra 1 .NET SDK (rekommenderas inte) måste du ladda ned något av följande paket för att utnyttja dina Azure Stack Hub-tjänster. Se till att ladda ned den som motsvarar din API-profil:
- 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

Anteckning

ResourceProvider-delen av NuGet-paketspecifikationen måste ändras. Dessutom är paketen för track 1 .NET SDK inaktuella, så du kan stöta på fel. Vi rekommenderar att du uppdaterar till spår 2 .NET SDK så snart som möjligt.

Profiler

För profiler som innehåller datum ersätter du datumet i Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManagerom du vill använda en annan SDK-profil eller -version. För 2008-versionen är 2019_03_01till exempel profilen och strängen blir Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. 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.

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 det räcka med en contributor roll. Se 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 för att 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 registrering av Microsoft.Compute resursprovidern.

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 Rest API i Azure. I profilversion 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 den här exempellagringsplatsen för uppdatering till datum (spår 2) exempelkod. Se den här exempellagringsplatsen för att spåra 1 exempelkod. Roten README.md beskriver allmänna krav och varje underkatalog innehåller ett specifikt exempel med egna README.md som beskriver hur du kör exemplet.

Se här för exemplet 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:

Dela via