Validación de la solicitud de OData
SE APLICA A: todos los niveles de API Management
La directiva validate-odata-request valida la dirección URL de solicitud, los encabezados y los parámetros de una solicitud a una API de OData para garantizar la conformidad con la especificación de OData.
Instrucción de la directiva
<validate-odata-request error-variable-name="variable name" default-odata-version="OData version number" min-odata-version="OData version number" max-odata-version="OData version number" max-size="size in bytes" />
Atributos
| Atributo | Descripción | Necesario | Valor predeterminado |
|---|---|---|---|
| error-variable-name | Nombre de la variable de context.Variables en la que se registrarán los errores de validación. |
No | N/D |
| default-odata-version | Versión predeterminada de OData que se asume para la validación de parámetros si la solicitud no contiene un encabezado OData-Version. |
No | 4.0 |
| min-odata-version | Versión mínima de OData en el encabezado OData-Version de la solicitud que acepta la directiva. |
No | N/D |
| max-odata-version | Versión máxima de OData en el encabezado OData-Version de la solicitud que acepta la directiva. |
No | N/D |
| max-size | Tamaño máximo de la carga útil de la solicitud en bytes. | No | N/D |
Uso
- Secciones de la directiva: inbound (entrada)
- Ámbitos de la directiva: global, área de trabajo, producto, API
- Puertas de enlace: clásica, v2, consumo, autohospedado y área de trabajo
Notas de uso
- Configure la directiva de una API de OData que se ha importado a API Management.
- Esta directiva solo se puede usar una vez en una sección de directiva.
Ejemplo
En el ejemplo siguiente se valida una solicitud a una API de OData y se asume una versión predeterminada de OData 4.01 si no hay ningún encabezado OData-Version presente:
<validate-odata-request default-odata-version="4.01" />
Directivas relacionadas
Contenido relacionado
Para más información sobre el trabajo con directivas, vea:
- Tutorial: Transformación y protección de una API
- Referencia de directivas para una lista completa de instrucciones de directivas y su configuración
- Expresiones de directiva
- Establecimiento o edición de directivas
- Reutilización de configuraciones de directivas
- Repositorio de fragmentos de código de directiva
- Kit de herramientas de directivas de Azure API Management
- Creación de directivas mediante Microsoft Copilot en Azure