Actualización del indexador (API REST de Azure AI Search)
Puede actualizar una definición de indexador existente mediante una solicitud HTTP PUT. Especifique el nombre del indexador que se va a actualizar en el URI de solicitud:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
La actualización de una definición del indexador no la ejecuta automáticamente, pero en función de las modificaciones y del origen de datos asociado, es posible que sea necesario restablecer y volver a ejecutar.
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 indexador | Necesario. El URI de solicitud especifica el nombre del indexador que se va a actualizar. |
| api-version | Necesario. La versión estable actual es api-version=2020-06-30. 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 actualización deben incluir un api-key encabezado establecido en la clave de administración (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
La sintaxis del cuerpo de la solicitud es la misma que para Create Indexer.
Al actualizar un indexador existente, toda la definición se reemplaza por el contenido del cuerpo de la solicitud. En general, el mejor patrón que se debe usar para las actualizaciones es recuperar la definición del indexador con get, modificarla y, a continuación, actualizarla con PUT.
Response
Para efectuar una solicitud correcta: 201 Creado si se ha creado un indexador nuevo, y 204 Sin contenido si se ha actualizado un indexador existente.