Delen via

Azure CognitiveServicesManagement-clientbibliotheek voor JavaScript - versie 8.0.0

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

Cognitive Services-beheerclient

| Package (NPM) | API-referentiedocumentatie | Voorbeelden

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Prerequisites

Het @azure/arm-cognitiveservices-pakket installeren

Installeer de Azure CognitiveServicesManagement-clientbibliotheek voor JavaScript met npm:

npm install @azure/arm-cognitiveservices

Een CognitiveServicesManagementClient maken en verifiëren

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

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

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

npm install @azure/identity

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

Raadpleeg deze handleidingvoor 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 { CognitiveServicesManagementClient } from "@azure/arm-cognitiveservices";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new CognitiveServicesManagementClient(new DefaultAzureCredential(), subscriptionId);

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { CognitiveServicesManagementClient } from "@azure/arm-cognitiveservices";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new CognitiveServicesManagementClient(credential, subscriptionId);

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

CognitiveServicesManagementClient

CognitiveServicesManagementClient is de primaire interface voor ontwikkelaars die de Azure CognitiveServicesManagement-clientbibliotheek gebruiken. Verken de methoden voor dit clientobject om inzicht te krijgen in de verschillende functies van de Azure CognitiveServicesManagement-service waartoe u toegang hebt.

Troubleshooting

Logging

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.