次の方法で共有

URL からのヘッダー / クエリパラメーター値の設定 (プレビュー)

テンプレート ID: setvaluefromurl

変更された呼び出しからの応答で、ヘッダーまたはクエリ パラメーターをパス指定の値に設定します。 このテンプレートは Power Apps と Power Automate で利用可能です。

このシナリオのターゲット ユースケースは、ヘッダーまたはクエリ パラメーターを、同じホスト内の別のエンドポイントからのみ取得できる値に設定することです。

例

入力パラメーター値
parameterTemplate@headers('location')
httpMethod取得
parameterValueUrl/v1.0/TestAPI/tasks/{id}/foo
parameterValuePathTemplate@body().peopleObject.location

GET 呼び出しから /v1.0/TestAPI/tasks/{id}/foo への応答は以下のとおりです

    {
        "peopleObject":{
            "location": "USA",
            "XYZ":{
                "Age": "30"
            },
            "ABC":{
                "Age": "23"
            }
        }
    }

このテンプレートはヘッダー location から USA の値を設定します。

オープンソース コネクタの例

このテンプレートの複数のインスタンスがオープン ソース コネクタリポジトリで使用され、ここにそれらのいくつかを挙げておきます。

コネクタシナリオ
Plannerヘッダー「If-Match」の値は URL によって設定されます
CognitiveServicesTextAnalyticsクエリ パラメーター「access_token」の値は URL によって設定されます

入力パラメーター

件名 キー 必要 型 内容
Parameter template x-ms-apimTemplateParameter.parameterTemplate True String 宛先パラメーター テンプレート: @headers() または @queryParameters()。
HTTP Method x-ms-apimTemplateParameter.httpMethod 列挙型 HTTP メソッド。
- GET
- POST
- PUT
Relative URL x-ms-apimTemplateParameter.parameterValueUrl 真 String HTTP 呼び出しを行う必要があるバックエンド相対 URL。
Value path x-ms-apimTemplateParameter.parameterValuePathTemplate 真 String 応答内の値プロパティへのパス。
Run policy on x-ms-apimTemplate-policySection 真 列挙 このポリシーをいつ実行するかを指定します
- 要求 : ポリシー テンプレートは、要求がバックエンド API に送信される前に実行されます。
- 応答 : ポリシーは、バックエンド API から応答を受信した後に実行されます。
Operations x-ms-apimTemplate-operationName 配列 ポリシーが適用されるアクションとトリガーのリスト。 操作が選択されていない場合、このポリシーはすべての操作に適用されます。