用途:在单个 API 实例上列出、编辑或应用供应商原生策略(Kong 插件、Apigee 模板、Azure 策略、MuleSoft/Anypoint),并在写入后等待实际完成。
使用路径:Audit(查看已应用保护,Step A)、Edit(修改已应用的策略,Step E)、Apply(向实例新增尚未应用的原生插件,Steps 1–5)。需路由正确,不要对 Audit 或 Edit 请求执行 Apply 步骤。
主要能力与关键规则:使用原生目录而非 Universal,切勿把 Kong 插件名或 Apigee 模板 id 传给 apply_universal_policy;操作前展示原生策略名到 API 实例的映射并等待明确确认;配置项名称必须来自 get_policy_template_form(template.configuration),不要猜测属性名,Apigee 使用嵌套对象与 @ 前缀属性;一次性收集可见字段,不虚构可选参数;编辑时 configuration_data 整体替换,仅对合并后为空的必填字段再次询问。
等待完成:外部写入常返回 status: "success" 并带 httpStatus 202 / operationStatus=accepted,这只是受理,需轮询 list_instance_policy_operations;MuleSoft 写入通常同步。存在 FAILED 时说明 error.retryable 是否存在。
限制与注意:无批量编辑工具,多个实例需分别调用 edit_applied_policy;不改动 Apigee 现有策略的 @name / 显示名,否则异步 UPDATE 可能失败;ReadOnly 为 true 的策略跳过并停止;工具缺失或 403/gate-closed 时停止,不静默切换供应商。相关技能:apply-universal-policy(多实例/多供应商统一策略)、apply-policy-to-api-instance(Anypoint REST)、secure-api(先创建实例)。