Delen via

Azure-abonnementsclientbibliotheek voor JavaScript - versie 6.0.0

Dit pakket bevat een isomorfe SDK (die zowel in Node.js als in browsers wordt uitgevoerd) voor de Azure-abonnementsclient.

De abonnementsclient

Broncode | Pakket (NPM) | API-referentiedocumentatie | Monsters

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Vereiste voorwaarden

Het @azure/arm-subscriptions-pakket installeren

Installeer de Azure Subscription-clientbibliotheek voor JavaScript met npm:

npm install @azure/arm-subscriptions

Een SubscriptionClient maken en verifiëren

Als u een clientobject wilt maken voor toegang tot de Azure Subscription-API, hebt u de endpoint van uw Azure Subscription-resource en een credential. De Azure-abonnementsclient kan Azure Active Directory-referenties gebruiken om te verifiëren. U vindt het eindpunt voor uw Azure Subscription-resource in de Azure Portal.

U kunt verifiëren met Azure Active Directory met behulp van een referentie uit de @azure/identiteitsbibliotheek of een bestaand AAD-token.

Als u de DefaultAzureCredential-provider wilt gebruiken die hieronder wordt weergegeven, of andere referentieproviders die bij de Azure SDK zijn geleverd, installeert u het @azure/identity pakket:

npm install @azure/identity

U moet ook een nieuwe AAD-toepassing registreren en toegang verlenen tot Azure-abonnement door de juiste rol toe te wijzen aan uw service-principal (opmerking: rollen zoals "Owner" verlenen niet de benodigde machtigingen).

Raadpleeg deze handleiding voor meer informatie over het maken van een Azure AD-toepassing.

Met Node.js- en Node-achtige omgevingen kunt u de DefaultAzureCredential-klasse gebruiken om de client te verifiëren.

import { SubscriptionClient } from "@azure/arm-subscriptions";
import { DefaultAzureCredential } from "@azure/identity";

const client = new SubscriptionClient(new DefaultAzureCredential());

Gebruik voor browseromgevingen de InteractiveBrowserCredential uit het @azure/identity-pakket om te verifiëren.

import { InteractiveBrowserCredential } from "@azure/identity";
import { SubscriptionClient } from "@azure/arm-subscriptions";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new SubscriptionClient(credential);

JavaScript Bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze bundeldocumentatievoor meer informatie over hoe u dit doet.

Belangrijke concepten

AbonnementClient

SubscriptionClient is de primaire interface voor ontwikkelaars die gebruikmaken van de Azure-abonnementsclientbibliotheek. Verken de methoden in dit clientobject om inzicht te krijgen in de verschillende functies van de Azure-abonnementsservice waartoe u toegang hebt.

Probleemoplossingsproces

Loggen

Het inschakelen van logboekregistratie kan helpen nuttige informatie over fouten te ontdekken. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de omgevingsvariabele AZURE_LOG_LEVEL in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door setLogLevel aan te roepen in de @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Voor meer gedetailleerde instructies over het inschakelen van logboeken, kunt u de @azure/logger pakketdocumentenbekijken.

Volgende stappen

Bekijk de map met voorbeelden voor gedetailleerde voorbeelden over het gebruik van deze bibliotheek.

Contributing

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de gids voor bijdragen voor meer informatie over het bouwen en testen van de code.