Condividi tramite


Libreria client Azure SearchManagement per JavaScript - versione 3.3.0

Questo pacchetto contiene un SDK isomorfico (eseguito sia in Node.js che nei browser) per il client SearchManagement di Azure.

Client che può essere usato per gestire i servizi di Ricerca di intelligenza artificiale di Azure e le chiavi API.

Codice sorgente | Pacchetto (NPM) | Documentazione | di riferimento APICampioni

Getting started

Ambienti attualmente supportati

Per ulteriori dettagli, consulta la nostra politica di supporto .

Prerequisites

Installare il pacchetto @azure/arm-search

Installare la libreria client di Ricerca di AzureManagement per JavaScript con npm:

npm install @azure/arm-search

Creare ed autenticare un SearchManagementClient

Per creare un oggetto client per accedere all'API SearchManagement di Azure, è necessario disporre endpoint della risorsa Ricerca di Azure e di un oggetto credential. Il client Di Azure SearchManagement può usare le credenziali di Azure Active Directory per l'autenticazione. È possibile trovare l'endpoint per la risorsa Di Azure SearchManagement nel portale di Azure.

È possibile eseguire l'autenticazione con Azure Active Directory usando una credenziale della libreria @azure/identity o un token AAD esistente.

Per usare il provider DefaultAzureCredential illustrato di seguito o altri provider di credenziali forniti con Azure SDK, installare il @azure/identity pacchetto:

npm install @azure/identity

Sarà anche necessario registrare una nuova applicazione AAD e concedere l'accesso ad Azure SearchManagement assegnando il ruolo appropriato all'entità servizio (si noti che i ruoli, "Owner" ad esempio, non concedono le autorizzazioni necessarie).

Per altre informazioni su come creare un'applicazione Azure AD, vedere questa guida.

Usando Node.js e ambienti simili a Node, è possibile usare la classe DefaultAzureCredential per autenticare il 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);

Per gli ambienti del browser, usare il InteractiveBrowserCredential dal pacchetto di @azure/identity per l'autenticazione.

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

Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per i dettagli su come eseguire questa operazione, consulta la nostra documentazione sui raggruppamenti.

Key concepts

SearchManagementClient

SearchManagementClient è l'interfaccia principale per gli sviluppatori che usano la libreria client Di Azure SearchManagement. Esplorare i metodi in questo oggetto client per comprendere le diverse funzionalità del servizio Ricerca di AzureManagement a cui è possibile accedere.

Troubleshooting

Logging

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel nel @azure/logger:

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

setLogLevel("info");

Per istruzioni più dettagliate su come abilitare i log, vedere la documentazione del pacchetto @azure/logger.

Next steps

Dai un'occhiata alla directory degli esempi per esempi dettagliati su come utilizzare questa libreria.

Contributing

Se vuoi contribuire a questa libreria, leggi la guida per contribuire per saperne di più su come creare e testare il codice.