验证 OData 请求
适用于:所有 API 管理层级
validate-odata-request
策略验证 OData API 请求的请求 URL、标头和参数,以确保符合 OData 规范。
策略语句
<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" />
属性
属性 | 说明 | 需要 | 默认 |
---|---|---|---|
error-variable-name | context.Variables 中的要将验证错误记录到的变量的名称。 |
否 | 不适用 |
default-odata-version | 请求不包含 OData-Version 标头时假定用于参数验证的默认 OData 版本。 |
否 | 4.0 |
min-odata-version | 策略接受的请求 OData-Version 标头中的最低 OData 版本。 |
否 | 不适用 |
max-odata-version | 策略接受的请求 OData-Version 标头中的最高 OData 版本。 |
否 | 空值 |
max_size | 请求有效负载的最大大小(以字节为单位)。 | 否 | 空值 |
使用情况
使用注意事项
- 为已导入到 API 管理的 OData API 配置策略。
- 此策略只能在策略部分中使用一次。
示例
以下示例验证 OData API 请求,并假定不存在 OData-Version
标头时默认 OData 版本为 4.01:
<validate-odata-request default-odata-version="4.01" />
相关策略
后续步骤
有关使用策略的详细信息,请参阅:
- 教程:转换和保护 API
- 策略参考,其中提供了策略语句及其设置的完整列表
- 策略表达式
- 设置或编辑策略
- 策略示例