Validate OData request
適用於:所有 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 中變數名稱。 |
No | N/A |
default-odata-version | 如果要求不包含 OData-Version 標頭,則為參數驗證所假設的預設 OData 版本。 |
No | 4.0 |
min-odata-version | 原則接受的要求 OData-Version 標頭中的最小 OData 版本。 |
No | N/A |
max-odata-version | 原則接受的要求 OData-Version 標頭中的最大 OData 版本。 |
No | N/A |
max-size | 要求承載的大小上限,以位元組為單位。 | No | N/A |
使用方式
使用注意事項
- 設定已匯入至 API 管理的 OData API 所用的原則。
- 此原則只能在原則區段中使用一次。
範例
下列範例會驗證 OData API 的要求,如果沒有任何 OData-Version
標頭,則假設預設 OData 版本為 4.01:
<validate-odata-request default-odata-version="4.01" />
相關原則
相關內容
如需使用原則的詳細資訊,請參閱:
- 教學課程:轉換及保護 API
- 原則參考,取得原則陳述式及其設定的完整清單
- 原則運算式
- 設定或編輯原則
- 重複使用原則設定
- 原則程式碼片段存放庫 (英文)
- Azure API 管理 原則工具組
- 使用 Microsoft Azure Copilot 撰寫原則