Update Indexer (API REST de Azure Cognitive 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 se requiera un restablecimiento y una nueva ejecución.

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 Necesario. api-key se usa para autenticar la solicitud en su servicio de búsqueda. Es un valor de cadena único para el servicio. Las solicitudes de actualización deben incluir un api-key encabezado establecido en la clave de administrador (en lugar de una clave de consulta). Puede encontrar la clave de API en el panel del servicio de búsqueda en el Azure Portal.

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.

Consulte también