Encabezados de solicitud y respuesta HTTP comunes (Azure AI Search)

Las API REST de Azure AI Search admiten un conjunto de encabezados comunes de solicitud/respuesta HTTP, que se resumen aquí como referencia:

Encabezado de la solicitud Tipo Descripción
Accept Tipo de contenido El tipo de contenido solicitado para la respuesta. El valor predeterminado es application/json;odata.metadata=minimal. Otros valores permitidos son application/json, application/json; odata.metadata=full, application/json; odata.metadata=none y text/plain (solo para $count).
api-key String Establézcalo en la consulta o la clave de administración, en función de la API.
authorization String Token de acceso de OAuth 2.0 para la solicitud. Requiere la configuración del servicio de búsqueda para el acceso basado en roles. Este encabezado de solicitud es para las aplicaciones cliente que usan Microsoft Entra ID autenticación y asignaciones de roles. El código de cliente debe proporcionar el token. Puede usar este encabezado de solicitud con cualquier versión compatible de la API REST siempre que el servicio de búsqueda esté configurado para la autenticación del plano de datos.
Content-Type Content-Type Tipo de contenido del cuerpo de solicitud (PUT y POST). El valor predeterminado es application/json.
client-request-id GUID Identificador de solicitud especificado por el autor de la llamada opcional, en forma de GUID sin decoración, como llaves (por ejemplo, client-request-id: 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0). Valor definido por el autor de la llamada que identifica la solicitud determinada. Si se especifica, este valor se incluye en la información de respuesta como una manera de asignar la solicitud.
OData-MaxVersion "4.0" Especifica la versión máxima del protocolo de OData admitido por el cliente. El valor predeterminado es "4.0".
Prefer "return=representation" o "return=minimal" Se utiliza para controlar la carga de respuesta de las solicitudes PUT y POST /índices. El valor predeterminado es "return=representation" al crear un nuevo índice a través de POST o PUT, y "return=minimal" para actualizar un índice existente a través de PUT.
return-client-request-id Verdadero o falso Si se especifica cuando se especifica el identificador de la solicitud de cliente, indica al servidor que incluya el encabezado de identificador de la solicitud de cliente en la respuesta. El valor predeterminado es False.
If-Match ETag o * Se usa para cambiar un recurso solo si la versión actual coincide con la ETag especificada. Use este encabezado con métodos POST, PUT o DELETE en recursos (como indexadores, índices y orígenes de datos, pero no documentos) para habilitar el control de simultaneidad optimista.
If-None-Match ETag o * Se usa para cambiar un recurso solo si la versión actual no coincide con la ETag especificada. Use este encabezado con métodos POST, PUT o DELETE en recursos (como indexadores, índices y orígenes de datos, pero no documentos) para habilitar el control de simultaneidad optimista.
Encabezado de respuesta Tipo Descripción
client-request-id GUID Identificador especificado por el autor de la llamada en la solicitud original, si está presente.
Content-Type Content-Type Tipo de contenido del cuerpo de respuesta.
Location Resolución Dirección URL de la definición de índice recién creada para las solicitudes POST y PUT /indexes.
Versión de OData "4.0" Versión del Protocolo OData de la respuesta.
request-id GUID Un identificador único para la operación actual. Es igual al identificador de solicitud del cliente si se especifica; de lo contrario, el valor se genera en el servidor.
elapsed-time Number Tiempo, en milisegundos, que el servicio ha dedicado a procesar la solicitud. Este valor solo incluye el tiempo dedicado al procesamiento de la solicitud y no incluye el tiempo de transferencia de red.
ETag String Cadena opaca que representa la versión actual de un recurso (devuelto para indexadores, índices y orígenes de datos, pero no documentos). Use esta cadena en el encabezado If-Match o If-None-Match para el control de simultaneidad optimista.

Consulte también

API REST de Azure AI Search