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

.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

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.

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.

Nästa steg

Läs mer om API-profiler:

• Hantera API-versionsprofiler i Azure Stack
• Api-versioner för resursprovider som stöds av profiler