Actualización del origen de datos (API rest de Azure AI Search)
Sobrescribe una definición de origen de datos existente con una versión revisada.
PUT https://[service name].search.windows.net/datasources/[data source name]?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 origen de datos | Necesario. El URI de solicitud especifica el nombre del origen de datos 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 Crear origen de datos.
Al actualizar un origen de datos 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 origen de datos con get, modificarla y, a continuación, actualizarla con PUT.
Response
Para una solicitud correcta: 201 Creado si se creó un nuevo origen de datos y 204 Sin contenido si se actualizó un origen de datos existente
Nota
Algunas propiedades no se pueden actualizar en un origen de datos existente. Por ejemplo, no puede cambiar el tipo de un origen de datos existente.