テンプレート ID: setheader
既存の応答ヘッダーまたは要求ヘッダーに値を割り当てるか、新しい応答ヘッダーまたは要求ヘッダーを追加します。 このテンプレートは Power Apps と Power Automate で利用可能です。
このポリシー テンプレートのターゲット ユース ケースは、HTTP 要求または応答に情報を上書きまたは追加することです。
例
次のパラメーターを使用する例をいくつか見てみましょう。
ヘッダー: test = foo
connectionParameters: cat=bar
| ヘッダー名 | ヘッダー値 | 結果のヘッダー |
| test | @headers('test')moo | test=foomoo |
| test | 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 ヘッダーは、エンド ユーザーの接続の設定によって上書きされます |
入力パラメーター
| 件名 | キー | 必要 | 型 | 内容 |
|---|---|---|---|---|
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 | 配列 | ポリシーが適用されるアクションとトリガーのリスト。 操作が選択されていない場合、このポリシーはすべての操作に適用されます。 |