Compartir a través de

Biblioteca cliente de Azure SearchManagement para JavaScript: versión 3.3.0

Este paquete contiene un SDK isomórfico (se ejecuta tanto en Node.js como en exploradores) para el cliente de Azure SearchManagement.

Cliente que se puede usar para administrar los servicios y las claves de API de Azure AI Search.

Código fuente | Paquete (NPM) | Documentación | de referencia de APIMuestras

Getting started

Entornos admitidos actualmente

Consulte nuestra política de soporte para obtener más detalles.

Prerequisites

Instalación del paquete @azure/arm-search

Instale la biblioteca cliente de Azure SearchManagement para JavaScript con npm:

npm install @azure/arm-search

Creación y autenticación de un SearchManagementClient

Para crear un objeto de cliente para acceder a Azure SearchManagement API, necesitará el endpoint de su recurso de Azure SearchManagement y .credential El cliente de Azure SearchManagement puede usar credenciales de Azure Active Directory para autenticarse. Puede encontrar el punto de conexión del recurso azure SearchManagement en Azure Portal.

Puede autenticarse con Azure Active Directory mediante una credencial de la biblioteca de identidades o @azure o un token de AAD existente.

Para usar el proveedor DefaultAzureCredential que se muestra a continuación u otros proveedores de credenciales proporcionados con el SDK de Azure, instale el @azure/identity paquete:

npm install @azure/identity

También deberá registrar una nueva aplicación de AAD y conceder acceso a Azure SearchManagement mediante la asignación del rol adecuado a la entidad de servicio (nota: los roles como "Owner" no concederán los permisos necesarios).

Para obtener más información sobre cómo crear una aplicación de Azure AD, consulte esta guía.

Con Node.js y entornos similares a nodos, puede usar la clase DefaultAzureCredential para autenticar al cliente.

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

En el caso de los entornos del explorador, use el InteractiveBrowserCredential del paquete de @azure/identity para autenticarse.

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

Para usar esta biblioteca cliente en el explorador, primero debe usar un agrupador. Para obtener más información sobre cómo hacerlo, consulte nuestra documentación de agrupación.

Key concepts

SearchManagementClient

SearchManagementClient es la interfaz principal para los desarrolladores que usan la biblioteca cliente de Azure SearchManagement. Explore los métodos de este objeto de cliente para comprender las distintas características del servicio Azure SearchManagement al que puede acceder.

Troubleshooting

Logging

Habilitar el registro puede ayudar a descubrir información útil sobre errores. Para ver un registro de solicitudes y respuestas HTTP, establezca la variable de entorno AZURE_LOG_LEVEL en info. Como alternativa, el registro se puede habilitar en tiempo de ejecución llamando a setLogLevel en el @azure/logger:

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

setLogLevel("info");

Para obtener instrucciones más detalladas sobre cómo habilitar los registros, puede consultar los documentos del paquete de @azure/registrador.

Next steps

Eche un vistazo al directorio de muestras para obtener ejemplos detallados sobre cómo usar esta biblioteca.

Contributing

Si desea contribuir a esta biblioteca, lea la guía de contribución para obtener más información sobre cómo compilar y probar el código.

  • Last updated on