API-versieprofielen gebruiken met .NET in Azure Stack Hub

De .NET SDK voor de Azure Stack Hub-Resource Manager biedt hulpprogramma's waarmee u uw infrastructuur kunt bouwen en beheren. Resourceproviders in de SDK omvatten Compute, Networking, Storage, App Services en Key Vault. De .NET SDK bevat 14 NuGet-pakketten. U moet deze pakketten telkens wanneer u uw project compileert, downloaden naar uw oplossing. U kunt echter specifiek downloaden welke resourceprovider u gaat gebruiken voor de hybride versie 2020-09-01 of2019-03-01-hybride versies om het geheugen voor uw app te optimaliseren. Elk pakket bestaat uit een resourceprovider, de respectieve API-versie en het API-profiel waartoe het behoort. API-profielen in de .NET SDK maken hybride cloudontwikkeling mogelijk door te schakelen tussen wereldwijde Azure-resources en -resources in Azure Stack Hub.

De Azure .NET SDK installeren

• Installeer Git. Zie Aan de slag - Git installeren voor instructies.
• Zie Beschikbare NuGet-distributieversies om de juiste NuGet-pakketten te installeren.

.NET- en API-versieprofielen

Een API-profiel is een combinatie van resourceproviders en API-versies. Gebruik een API-profiel om de nieuwste, meest stabiele versie van elk resourcetype in een resourceproviderpakket op te halen.

• Als u de services wilt gebruiken die compatibel zijn met Azure Stack Hub, gebruikt u een van de volgende pakketten:

  • 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

  Zorg ervoor dat het ResourceProvider-gedeelte van het bovenstaande NuGet-pakket wordt gewijzigd in de juiste provider.

Profielen

Als u profielen met datums wilt gebruiken, vervangt u de datum in Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManagereen ander SDK-profiel of een andere versie. Voor de versie 2008 is 2019_03_01het profiel bijvoorbeeld en wordt Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManagerde tekenreeks. Houd er rekening mee dat het SDK-team soms de naam van de pakketten wijzigt, dus het vervangen van de datum van een tekenreeks met een andere datum werkt mogelijk niet. Zie de volgende tabel voor het koppelen van profielen en Azure Stack-versies.

Azure Stack-versie	Profiel
2108	2020_09_01
2102	2020_09_01
2008	2019_03_01

Zie de samenvatting van API-profielen voor meer informatie over Azure Stack Hub- en API-profielen.

Abonnement

Als u nog geen abonnement hebt, maakt u een abonnement en slaat u de abonnements-id op die u later wilt gebruiken. Zie dit document voor meer informatie over het maken van een abonnement.

Service-principal

Een service-principal en de bijbehorende omgevingsgegevens moeten ergens worden gemaakt en opgeslagen. Service-principal met owner rol wordt aanbevolen, maar afhankelijk van het voorbeeld kan een contributor rol voldoende zijn. Raadpleeg de LEESMIJ in de voorbeeldopslagplaats voor de vereiste waarden. U kunt deze waarden lezen in elke indeling die wordt ondersteund door de SDK-taal, zoals uit een JSON-bestand (die in onze voorbeelden wordt gebruikt). Afhankelijk van het voorbeeld dat wordt uitgevoerd, kunnen niet al deze waarden worden gebruikt. Zie de voorbeeldopslagplaats voor bijgewerkte voorbeeldcode of meer informatie.

Tenant-id

Volg de instructies in dit artikel om de map- of tenant-id voor uw Azure Stack Hub te vinden.

Resourceprovider registreren

Registreer de vereiste resourceproviders door dit document te volgen. Deze resourceproviders zijn vereist, afhankelijk van de voorbeelden die u wilt uitvoeren. Als u bijvoorbeeld een VM-voorbeeld wilt uitvoeren, is de registratie van de Microsoft.Compute resourceprovider vereist.

Azure Stack Resource Manager-eindpunt

Azure Resource Manager (ARM) is een beheerframework waarmee beheerders Azure-resources kunnen implementeren, beheren en bewaken. Azure Resource Manager kan deze taken verwerken als een groep in plaats van afzonderlijk, in één bewerking. U kunt de metagegevensgegevens ophalen uit het Resource Manager-eindpunt. Het eindpunt retourneert een JSON-bestand met de informatie die nodig is om uw code uit te voeren.

• ResourceManagerEndpointUrl in de Azure Stack Development Kit (ASDK) is: https://management.local.azurestack.external/.
• De ResourceManagerEndpointUrl in geïntegreerde systemen is: https://management.region.<fqdn>/, waar <fqdn> is uw volledig gekwalificeerde domeinnaam.
• De vereiste metagegevens ophalen: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Zie Azure REST API-specificaties voor beschikbare API-versies. In profielversie kunt u bijvoorbeeld 2020-09-01 de api-version naam 2019-10-01 wijzigen van de resourceprovider microsoft.resources.

Voorbeeld-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"]
      }
}

Voorbeelden

Zie de voorbeeldopslagplaats voor voorbeeldcode voor update-to-date. De hoofdmap README.md beschrijft algemene vereisten en elke submap bevat een specifiek voorbeeld met een eigen README.md voorbeeld voor het uitvoeren van dat voorbeeld.

Zie hier voor het voorbeeld dat van toepassing is op de versie 2008 of het profiel 2019-03-01 van Azure Stack en hieronder.

Volgende stappen

Meer informatie over API-profielen:

• API-versieprofielen beheren in Azure Stack Hub
• API-versies van resourceproviders die worden ondersteund door profielen