適用於：所有 APIM 層
原則 include-fragment 會在原則定義中插入先前建立的原則片段內容。 原則片段是集中管理的可重複使用 XML 原則程式碼片段，可包含在 APIM 執行個體中的原則定義。
原則會依原則定義中選取的位置插入原則片段。
注意
請依照原則陳述式中提供的順序，來設定原則的元素和子元素。 深入了解如何設定或編輯 APIM 原則。
原則陳述式
<include-fragment fragment-id="fragment" />
屬性
| 屬性 | 描述 | 是必要欄位 | 預設 |
|---|---|---|---|
| fragment-id | 字串。 指定 APIM 執行個體中建立之原則片段的識別碼 (名稱)。 不允許使用原則運算式。 | 是的 | N/A |
Important
當使用 Reference fragment-id政策片段時，連結存取不會被檢查。 擁有撰寫政策權限的使用者可以參考任何可用的政策片段，並促使 API Management 執行其政策陳述，即使使用者沒有對政策片段資源的讀取權限。 這不會授予查看或修改政策片段定義的權限。
使用方式
範例
在下列範例中，名為 myFragment 的原則片段會新增至原則定義的輸入區段中。
<inbound>
<include-fragment fragment-id="myFragment" />
<base />
</inbound>
[...]
相關原則
相關內容
如需使用原則的詳細資訊，請參閱：
- 教學課程：轉換及保護 API
- 原則參考，取得原則陳述式及其設定的完整清單
- 原則運算式
- 設定或編輯原則
- 重複使用原則設定
- 原則程式碼片段存放庫 (英文)
- Policy 範例 repo
- Azure API 管理 原則工具組
- 取得 Copilot 協助以建立、說明及疑難排解原則