Compartir a través de

Restablecimiento de aptitudes (API REST de versión preliminar)

  • Artículo

se aplica a: 2023-07-01-Preview. Esta versión ya no se admite. Actualizar inmediatamente a una versión más reciente.

Importante

2023-07-01-Preview (sin cambios).

2021-04-30-Preview (sin cambios).

2020-06-30-Preview agrega la API. Admite enriquecimientos almacenados en caché y escenarios de restablecimiento de .

El Restablecer aptitudes solicitar de forma selectiva uno o varios conocimientos en la siguiente ejecución del indexador. En el caso de los indexadores que tienen habilitado el almacenamiento en caché, puede solicitar explícitamente el procesamiento de actualizaciones de aptitudes que el indexador no puede detectar. Por ejemplo, si realiza cambios externos, como revisiones a una aptitud personalizada, puede usar esta API para volver a ejecutar la aptitud. Las salidas, como un almacén de conocimiento o un índice de búsqueda, se actualizan mediante datos reutilizables de la caché y el nuevo contenido según la aptitud actualizada.

Puede restablecer un conjunto de aptitudes de existente mediante HTTP POST, especificando el nombre del conjunto de aptitudes que se va a actualizar en el URI de solicitud.

POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
    Content-Type: application/json
    api-key: [admin key]

Parámetros de URI

Parámetro Descripción
nombre del servicio Obligatorio. Establézcalo en el nombre único definido por el usuario del servicio de búsqueda.
nombre del conjunto de aptitudes Obligatorio. El URI de solicitud especifica el nombre del conjunto de aptitudes que se va a restablecer.
api-version Obligatorio. Consulte versiones de API para obtener más versiones.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales.

Campos Descripción
Tipo de contenido Obligatorio. Establézcalo en application/json
api-key Opcional si usa roles de Azure y se proporciona un token de portador en la solicitud; de lo contrario, se requiere una clave. Una clave de API es una cadena única generada por el sistema que autentica la solicitud en el servicio de búsqueda. Las solicitudes de restablecimiento deben incluir un encabezado de api-key establecido en la clave de administrador (en lugar de una clave de consulta). Consulte Conexión a Azure AI Search mediante la autenticación de claves para más información.

Cuerpo de la solicitud

El cuerpo de la solicitud es una matriz de nombres de aptitud.

{   
    "skillNames" : ["<SKILL-1>", "SKILL-n"]
}

Respuesta

Código de estado: 204 No hay contenido para obtener una respuesta correcta.

Consulte también