Partager via


Bibliothèque cliente Azure SearchManagement pour JavaScript - version 3.3.0

Ce package contient un SDK isomorphe (s’exécute à la fois dans Node.js et dans les navigateurs) pour le client Azure SearchManagement.

Client qui peut être utilisé pour gérer les services azure AI Search et les clés API.

Code source | Forfait (NPM) | Documentation de référence sur l’API | Échantillons

Getting started

Environnements actuellement pris en charge

Consultez notre politique d’assistance pour plus de détails.

Prerequisites

Installer le package @azure/arm-search

Installez la bibliothèque cliente Azure SearchManagement pour JavaScript avec npm:

npm install @azure/arm-search

Créer et authentifier un SearchManagementClient

Pour créer un objet client pour accéder à l’API Azure SearchManagement, vous aurez besoin endpoint de votre ressource Azure SearchManagement et d’un credential. Le client Azure SearchManagement peut utiliser les informations d’identification Azure Active Directory pour s’authentifier. Vous trouverez le point de terminaison de votre ressource Azure SearchManagement dans le portail Azure.

Vous pouvez vous authentifier auprès d’Azure Active Directory à l’aide d’informations d’identification de la bibliothèque @azure/identity ou d’un jeton AAD existant.

Pour utiliser le fournisseur DefaultAzureCredential illustré ci-dessous, ou d’autres fournisseurs d’informations d’identification fournis avec le Kit de développement logiciel (SDK) Azure, installez le @azure/identity package :

npm install @azure/identity

Vous devrez également inscrire une nouvelle application AAD et accorder l’accès à Azure SearchManagement en affectant le rôle approprié à votre principal de service (remarque : les rôles tels que "Owner" n’accorderont pas les autorisations nécessaires).

Pour plus d’informations sur la création d’une application Azure AD, consultez ce guide.

À l’aide de Node.js et d’environnements de type Nœud, vous pouvez utiliser la classe DefaultAzureCredential pour authentifier le client.

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

Pour les environnements de navigateur, utilisez le InteractiveBrowserCredential à partir du package @azure/identity pour l’authentification.

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

Pour utiliser cette bibliothèque cliente dans le navigateur, vous devez d’abord utiliser un bundler. Pour plus de détails sur la procédure à suivre, veuillez consulter notre documentation sur les offres groupées.

Key concepts

SearchManagementClient

SearchManagementClient est l’interface principale pour les développeurs utilisant la bibliothèque cliente Azure SearchManagement. Explorez les méthodes de cet objet client pour comprendre les différentes fonctionnalités du service Azure SearchManagement auquel vous pouvez accéder.

Troubleshooting

Logging

L’activation de la journalisation peut vous aider à découvrir des informations utiles sur les échecs. Pour afficher un journal des requêtes et réponses HTTP, définissez la variable d’environnement AZURE_LOG_LEVEL sur info. Vous pouvez également activer la journalisation au moment de l’exécution en appelant setLogLevel dans @azure/logger :

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

setLogLevel("info");

Pour obtenir des instructions plus détaillées sur l’activation des journaux, consultez les documents relatifs au package @azure/logger.

Next steps

Veuillez consulter le répertoire des exemples pour des exemples détaillés sur la façon d’utiliser cette bibliothèque.

Contributing

Si vous souhaitez contribuer à cette bibliothèque, veuillez lire le guide de contribution pour en savoir plus sur la façon de construire et de tester le code.