API-versieprofielen gebruiken met Node.js Software Development Kit (SDK) in Azure Stack Hub

Node.js- en API-versieprofielen

U kunt Node.js SDK gebruiken om de infrastructuur voor uw apps te bouwen en te beheren. API-profielen in de Node.js SDK helpen bij uw hybride cloudoplossingen door te schakelen tussen wereldwijde Azure-resources en Azure Stack Hub-resources. U kunt één keer code schrijven en vervolgens gericht zijn op zowel globale Azure als Azure Stack Hub.

In dit artikel kunt u Visual Studio Code gebruiken als uw ontwikkelhulpprogramma. Visual Studio Code kan fouten opsporen in de Node.js SDK en u kunt de app uitvoeren en de app naar uw Azure Stack Hub-exemplaar pushen. U kunt fouten opsporen vanuit Visual Studio Code of via een terminalvenster met de opdracht node <nodefile.js>.

De Node.js SDK

De Node.js SDK biedt Azure Stack Hub Resource Manager-hulpprogramma's. Resourceproviders in de SDK omvatten rekenkracht, netwerken, opslag, app-services en KeyVault. Er zijn 10 resourceproviderclientbibliotheken die u kunt installeren in uw node.js toepassing. U kunt ook specificeren welke resourceprovider u voor het profiel 2020-09-01 wilt gebruiken om het geheugen van uw toepassing te optimaliseren. Elke module bestaat uit een resourceprovider, de respectieve API-versie en het API-profiel.

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

Als u gebruik wilt maken van de nieuwste versies van alle services, gebruikt u het nieuwste profiel van de pakketten.
Als u de services wilt gebruiken die compatibel zijn met Azure Stack Hub, gebruikt u de @azure/arm-resources-profile-hybrid-2020-09-01 of @azure/arm-storage-profile-2020-09-01-hybrid

NPM-pakketten

Elke resourceprovider heeft een eigen pakket. U kunt het pakket ophalen uit het npm-register.

U vindt de volgende pakketten:

Bronleverancier	Pakket
App Service	@azure/arm-resources-profile-2020-09-01-hybrid
Azure Resource Manager-abonnementen	@azure/arm-subscriptions-profile-hybrid-2020-09-01
Azure Resource Manager-beleid	@azure/arm-policy-profile-hybrid-2020-09-01
Azure Resource Manager DNS	@azure/arm-dns-profile-2020-09-01-hybrid
Autorisatie	@azure/arm-authorization-profile-2020-09-01-hybrid
Berekenen	@azure/arm-compute-profile-2020-09-01-hybrid
Opslag	@azure/arm-storage-profile-2020-09-01-hybrid
Netwerk	@azure/arm-network-profile-2020-09-01-hybrid
Middelen	@azure/arm-resources-profile-hybrid-2020-09-01
Sleutelkluis	@azure/arm-keyvault-profile-2020-09-01-hybrid

Als u de nieuwste API-versie van een service wilt gebruiken, gebruikt u het meest recente profiel van de specifieke clientbibliotheek. Als u bijvoorbeeld de nieuwste API-versie van de resourceservice alleen wilt gebruiken, gebruikt u het azure-arm-resource profiel van de Resource Management Client Library. package.

Gebruik de specifieke API-versies die in het pakket zijn gedefinieerd voor de specifieke API-versies van een resourceprovider.

@azure/arm-resourceprovider-profile-2020-09-01-hybrid

Het meest recente profiel dat is gebouwd voor Azure Stack Hub. Gebruik dit profiel voor services voor de beste compatibiliteit met Azure Stack Hub, zolang u zich op versie 1808 of een latere versie bevindt.
@azure-arm-resource

Het profiel bestaat uit de nieuwste versies van alle services. Gebruik de nieuwste versies van alle services in Azure.

Profielen

Als u voor profielen met datums een ander SDK-profiel of een andere versie wilt gebruiken, kunt u de datum in @azure/arm-keyvault-profile-<date>-hybridvervangen. Bijvoorbeeld, voor de versie 2008, is het profiel 2019-03-01, en wordt de tekenreeks @azure/arm-keyvault-profile-2019-03-01-hybrid. 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
2311	01-09-2020
2301	01-09-2020
2206	01-09-2020
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.

De Node.js SDK installeren

Installeer Git. Zie Aan de slag - Git installeren voor instructies.
Installeer of voer een upgrade uit naar de huidige versie van Node.js. Node.js bevat ook npm JavaScript-pakketbeheer.
Installeer of upgrade Visual Studio Code en installeer de Node.js-extensie voor Visual Studio Code.
Installeer de clientpakketten voor azure Stack Hub Resource Manger. Zie voor meer informatie hoe u clientbibliotheken installeert.
De pakketten die moeten worden geïnstalleerd, zijn afhankelijk van de profielversie die u wilt gebruiken. U vindt een lijst met resourceproviders in de sectie Pakketten in npm .

Abonnement

Als u nog geen abonnement hebt, maakt u een abonnement en slaat u de abonnements-id op die later moet worden gebruikt. 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.

Huurder-ID

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

De leveranciers van bronnen 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.

Houd rekening met het volgende:

De ResourceManagerEndpointUrl in de Azure Stack Development Kit (ASDK) is als volgt: 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

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 voorbeeldrepository voor actuele voorbeeldcode. In de hoofdmap README.md worden algemene vereisten beschreven en elke submap bevat een specifiek voorbeeld met README.md eigen instructies voor het uitvoeren van dat voorbeeld.

Zie 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:

Feedback

Is deze pagina nuttig?

Last updated on 2025-10-30