Delen via

Azure SearchManagement-clientbibliotheek voor JavaScript - versie 3.3.0

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

Client die kan worden gebruikt voor het beheren van Azure AI Search-services en API-sleutels.

Broncode | Pakket (NPM) | Documentatie voor | API-referentieMonsters

Getting started

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Prerequisites

Het @azure/arm-search-pakket installeren

Installeer de Azure SearchManagement-clientbibliotheek voor JavaScript met npm:

npm install @azure/arm-search

Een SearchManagementClient maken en verifiëren

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

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

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

npm install @azure/identity

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

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 { SearchManagementClient } from "@azure/arm-search";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { SearchManagementClient } from "@azure/arm-search";

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

JavaScript Bundle

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Voor meer informatie over hoe u dit kunt doen, verwijzen wij u naar onze bundeldocumentatie.

Key concepts

SearchManagementClient

SearchManagementClient is de primaire interface voor ontwikkelaars die de Azure SearchManagement-clientbibliotheek gebruiken. Verken de methoden voor dit clientobject om inzicht te krijgen in de verschillende functies van de Azure SearchManagement-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 gedetailleerdere instructies over het inschakelen van logboeken, kunt u de documentatie over het @azure/logger-pakket bekijken.

Next steps

Neem een kijkje in de map met voorbeelden voor gedetailleerde voorbeelden van het gebruik van deze bibliotheek.

Contributing

Als je wilt bijdragen aan deze bibliotheek, lees dan de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.