Delen via


API-versieprofielen gebruiken met .NET in Azure Stack Hub

Belangrijk

De .NET SDK is bijgewerkt van track 1 naar track 2. U wordt ten zeerste aangeraden zo snel mogelijk te migreren naar de track 2 SDK. Raadpleeg deze migratiehandleiding voor instructies.

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 zijn onder andere Compute, Networking, Storage, App Services en Key Vault. De .NET SDK bevat 14 NuGet-pakketten. Als u de afgeschafte track 1 .NET SDK gebruikt (niet aanbevolen), zijn deze pakketten voorzien van API-profielen, zoals 2020-09-01-hybrid en 2019-03-01-hybrid. API-profielen in de .NET SDK maken hybride cloudontwikkeling mogelijk door u te helpen schakelen tussen globale Azure-resources en Azure Stack Hub-resources. Zie de sectie .NET- en API-versieprofielen voor meer informatie.

De Azure .NET SDK installeren

.NET- en API-versieprofielen

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

Notitie

Het ResourceProvider-gedeelte van de NuGet-pakketspecificatie moet worden gewijzigd. Bovendien zijn de pakketten voor track 1 .NET SDK afgeschaft, zodat u mogelijk te maken krijgt met fouten. U wordt aangeraden zo snel mogelijk bij te werken naar de .NET SDK van track 2.

Profielen

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

Azure Stack-versie Profiel
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
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 leesmij in de voorbeeldopslagplaats voor de vereiste waarden. U kunt deze waarden lezen in elke indeling die wordt ondersteund door de SDK-taal, zoals in een JSON-bestand (dat 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 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 kunnen deze taken als een groep in plaats van afzonderlijk in één bewerking verwerken. 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.

  • De 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>/, waarbij <fqdn> uw fully qualified domain name is.
  • Ga als volgende te werk om de vereiste metagegevens op te halen: <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 wijzigen in 2019-10-01 voor resourceprovider microsoft.resources.

Voorbeeld van 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 deze voorbeeldopslagplaats voor voorbeeldcode voor update-to-date (track 2). Zie deze voorbeeldopslagplaats voor het bijhouden van 1 voorbeeldcode. In de hoofdmap README.md worden algemene vereisten beschreven en elke submap bevat een specifiek voorbeeld met een eigen README.md voorbeeld waarin wordt beschreven hoe u dat voorbeeld uitvoert.

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

Volgende stappen

Meer informatie over API-profielen: