Azure Subscription client library voor JavaScript - versie 3.0.0

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

Sleutelkoppelingen:

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Prerequisites

Het @azure/arm-resources-subscriptions-pakket installeren

Installeer de Azure Subscription-clientbibliotheek voor JavaScript met npm:

npm install @azure/arm-resources-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.

Je kunt je authenticeren bij Azure Active Directory met een inloggegevens uit de bibliotheek @azure/identity of een bestaande AAD Token.

Om de hieronder getoonde DefaultAzureCredential provider te gebruiken, of andere inlogproviders die bij de Azure SDK zijn geleverd, installeer dan het pakket @azure/identity:

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).

Voor meer informatie over hoe je een Azure AD-applicatie maakt, kijk dan op deze gids.

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

import { SubscriptionClient } from "@azure/arm-resources-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-resources-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 bundeldocumentatie voor 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.

Troubleshooting

Logboekregistratie

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 voorbeelden map 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.