模板 ID:setheader
向现有的响应和/或请求标头赋值,或者添加新的响应和/或请求标头。 此模板在 Power Apps 和 Power Automate 中可用。
此策略模板的目标用例是替代 HTTP 请求或响应,或向其添加信息。
示例
让我们看一下使用以下参数的一些示例。
headers: test=foo
connectionParameters: cat=bar
标头名称 | 标头值 | 生成的标头 |
测试 | @headers('test')moo | test=foomoo |
测试 | moo@headers('test') | test=moofoo |
cat | @connectionParameters(‘cat’, ‘’) | test=foo; cat=bar |
姓名 | @connectionParameters(‘name’, ‘’) | test=foo; name="" |
开放源代码的连接器的示例
我们有多个将在开放源代码的连接器存储库中使用的此模板的实例,下面介绍了几个实例。
连接器 | 方案 | |
GetAccept | 响应中的 HTTP 标头由新的静态值替代 | |
Peltarion | 请求中的 HTTP 标头由静态值 application/json 替代,这是一种常见情形 | |
OpenText ContentServer | 请求中的 HTTP 标头由最终用户的连接设置替代 |
输入参数
客户 | 钥匙 | 需要 | Type | 描述 |
---|---|---|---|---|
Header name |
x-ms-apimTemplateParameter.name | 真 | String | 指定要设置的标头的名称。 |
Header value |
x-ms-apimTemplateParameter.value | 真 | String | 指定要设置的标头的值。 |
Action if header exists |
x-ms-apimTemplateParameter.existsAction | 枚举 | 指定在已指定标头时要执行的操作 - 替代:使用策略模板中的值替换现有值。 - 跳过:现有值不替换为策略模板中的值。 - 追加:将策略模板中的值追加到现有值。 |
|
Run policy on |
x-ms-apimTemplate-policySection | 真 | 枚举 | 指定运行此策略的时间 - 请求:策略模板将在请求发送到后端 API 之前运行。 - 响应:策略将在收到后端 API 的响应后运行。 - 失败:仅当对后端 API 的调用失败时才运行策略模板。 |
Operations |
x-ms-apimTemplate-operationName | 数组 | 将对其应用策略的操作和触发器的列表。 如果未选择任何操作,该策略将应用于所有操作。 |