Restablecimiento de aptitudes (API REST de versión preliminar)
Se aplica a: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
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.
La solicitud Restablecer aptitudes procesa selectivamente una o varias aptitudes 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 las actualizaciones de aptitudes que el indexador no puede detectar. Por ejemplo, si hace cambios externos, como revisiones de una aptitud personalizada, puede usar esta API para volver a ejecutar la aptitud. Las salidas, como un almacén de información o un índice de búsqueda, se actualizan con datos reutilizables de la memoria caché y el nuevo contenido de acuerdo con las aptitudes actualizadas.
Puede restablecer un conjunto de aptitudes 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 identificador URI
| Parámetro | Descripción |
|---|---|
| nombre del servicio | Necesario. Establézcalo en el nombre único definido por el usuario del servicio de búsqueda. |
| nombre del conjunto de aptitudes | Necesario. El URI de solicitud especifica el nombre del conjunto de aptitudes que se va a restablecer. |
| api-version | Necesario. La versión preliminar actual es 2023-07-01-Preview. Consulte Versiones de API para obtener más versiones. |
Encabezados de solicitud
En la siguiente tabla se describen los encabezados de solicitud obligatorios y opcionales.
| Campos | Descripción |
|---|---|
| Content-Type | Necesario. 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 api-key encabezado 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 aptitudes.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Response
Código de estado: 204 Sin contenido para obtener una respuesta correcta.