Azure Logic Apps を使用して HTTP または HTTPS エンドポイントに発信呼び出しを送信するSend outgoing calls to HTTP or HTTPS endpoints by using Azure Logic Apps

Azure Logic Apps と組み込みの HTTP トリガーまたはアクションを使用すると、HTTP または HTTPS エンドポイントに要求を定期的に送信する自動化されたタスクおよびワークフローを作成することができます。With Azure Logic Apps and the built-in HTTP trigger or action, you can create automated tasks and workflows that regularly send requests to any HTTP or HTTPS endpoint. これの代わりに着信した HTTP または HTTPS 呼び出しを受信して応答するには、組み込みの Request トリガーまたは Response アクションを使用します。To receive and respond to incoming HTTP or HTTPS calls instead, use the built-in Request trigger or Response action.

たとえば、対象の Web サイトのサービス エンドポイントは、そのエンドポイントを指定したスケジュールで確認することで監視できます。For example, you can monitor the service endpoint for your website by checking that endpoint on a specified schedule. Web サイトの停止など、そのエンドポイントで特定のイベントが発生すると、そのイベントによって対象のロジック アプリのワークフローがトリガーされ、指定したアクションが実行されます。When a specific event happens at that endpoint, such as your website going down, the event triggers your logic app's workflow and runs the specified actions.

定期的にエンドポイントを確認する、つまり "ポーリング" するために、ワークフローの最初のステップとして HTTP トリガーを使用できます。To check or poll an endpoint on a regular schedule, you can use the HTTP trigger as the first step in your workflow. チェックごとに、トリガーからエンドポイントに対する呼び出し、つまり要求が送信されます。On each check, the trigger sends a call or request to the endpoint. エンドポイントの応答によって、ロジック アプリのワークフローが実行されるかどうかが決定します。The endpoint's response determines whether your logic app's workflow runs. トリガーによって、応答の任意のコンテンツがロジック アプリのアクションに渡されます。The trigger passes along any content from the response to the actions in your logic app.

必要に応じてエンドポイントを呼び出すために、ワークフローの他の手順として HTTP アクションを使用できます。You can use the HTTP action as any other step in your workflow for calling the endpoint when you want. エンドポイントの応答によって、ワークフローの以降のアクションの実行方法が決まります。The endpoint's response determines how your workflow's remaining actions run.

この HTTP コネクタは、ターゲット エンドポイントの機能に基づき、トランスポート層セキュリティ (TLS) バージョン 1.0、1.1、1.2 をサポートしています。Based the target endpoint's capability, the HTTP connector supports Transport Layer Security (TLS) versions 1.0, 1.1, and 1.2. Logic Apps は、考えられる最高のサポート バージョンを使用してエンドポイントとネゴシエートします。Logic Apps negotiates with the endpoint over using the highest supported version possible. そのため、たとえば、エンドポイントが 1.2 をサポートする場合、コネクタは、まず 1.2 を使用します。So, for example, if the endpoint supports 1.2, the connector uses 1.2 first. それ以外の場合、コネクタは、2 番目に高いサポート バージョンを使用します。Otherwise, the connector uses the next highest supported version.

前提条件Prerequisites

HTTP トリガーの追加Add an HTTP trigger

この組み込みトリガーは、エンドポイントに指定された URL に対して HTTP 呼び出しを実行し、応答を返します。This built-in trigger makes an HTTP call to the specified URL for an endpoint and returns a response.

  1. Azure portal にサインインするSign in to the Azure portal. ロジック アプリ デザイナーで空のロジック アプリを開きます。Open your blank logic app in Logic App Designer.

  2. [アクションを選択してください] の下の検索ボックス内に、フィルターとして「http」と入力します。Under Choose an action, in the search box, enter "http" as your filter. [トリガー] の一覧から、 [HTTP] トリガーを選択します。From the Triggers list, select the HTTP trigger.

    HTTP トリガーを選択する

    この例では、トリガー名を "HTTP trigger" に変更して、このステップにわかりやすい名前を付けています。This example renames the trigger to "HTTP trigger" so that the step has a more descriptive name. また、この例では後で HTTP アクションを追加します。どちらの名前も一意である必要があります。Also, the example later adds an HTTP action, and both names must be unique.

  3. ターゲット エンドポイントへの呼び出しに含める HTTP トリガー パラメーターの値を指定します。Provide the values for the HTTP trigger parameters that you want to include in the call to the target endpoint. トリガーでターゲット エンドポイントを確認する頻度を設定します。Set up the recurrence for how often you want the trigger to check the target endpoint.

    [なし] 以外の認証の種類を選択した場合、認証設定は、選択に基づいて変化します。If you select an authentication type other than None, the authentication settings differ based on your selection. 詳しくは、「送信呼び出しに認証を追加する」をご覧ください。For more information, see Add authentication to outbound calls.

    HTTP トリガー パラメーターを入力する

  4. その他の使用可能なパラメーターを追加するには、 [新しいパラメーターの追加] リストを開き、必要なパラメーターを選択します。To add other available parameters, open the Add new parameter list, and select the parameters that you want.

  5. トリガーが起動したときに実行されるアクションを使用して、ロジック アプリのワークフローを引き続き構築します。Continue building your logic app's workflow with actions that run when the trigger fires.

  6. 完了したら、忘れずに対象のロジック アプリを保存してください。When you're done, remember to save your logic app. デザイナーのツール バーで、 [保存] を選択します。On the designer toolbar, select Save.

HTTP アクションの追加Add an HTTP action

この組み込みアクションは、エンドポイントに指定された URL に対して HTTP 呼び出しを実行し、応答を返します。This built-in action makes an HTTP call to the specified URL for an endpoint and returns a response.

  1. Azure portal にサインインするSign in to the Azure portal. ロジック アプリ デザイナーでロジック アプリを開きます。Open your logic app in Logic App Designer.

    この例では、最初のステップとして HTTP トリガーを使用します。This example uses the HTTP trigger as the first step.

  2. HTTP アクションを追加するステップで、 [新しいステップ] を選択します。Under the step where you want to add the HTTP action, select New step.

    ステップの間にアクションを追加するには、ステップ間の矢印の上にポインターを移動します。To add an action between steps, move your pointer over the arrow between steps. 表示されるプラス記号 ( + ) を選択してから、 [アクションの追加] を選択します。Select the plus sign (+) that appears, and then select Add an action.

  3. [アクションを選択してください] の下の検索ボックス内に、フィルターとして「http」と入力します。Under Choose an action, in the search box, enter "http" as your filter. [アクション] の一覧で、 [HTTP] アクションを選択します。From the Actions list, select the HTTP action.

    HTTP アクションを選択する

    この例では、アクション名を "HTTP action" に変更して、このステップにわかりやすい名前を付けています。This example renames the action to "HTTP action" so that the step has a more descriptive name.

  4. ターゲット エンドポイントへの呼び出しに含める HTTP アクション パラメーターの値を指定します。Provide the values for the HTTP action parameters that you want to include in the call to the target endpoint.

    [なし] 以外の認証の種類を選択した場合、認証設定は、選択に基づいて変化します。If you select an authentication type other than None, the authentication settings differ based on your selection. 詳しくは、「送信呼び出しに認証を追加する」をご覧ください。For more information, see Add authentication to outbound calls.

    HTTP アクションのパラメーターを入力する

  5. その他の使用可能なパラメーターを追加するには、 [新しいパラメーターの追加] リストを開き、必要なパラメーターを選択します。To add other available parameters, open the Add new parameter list, and select the parameters that you want.

  6. 完了したら、忘れずに対象のロジック アプリを保存してください。When you're done, remember to save your logic app. デザイナーのツール バーで、 [保存] を選択します。On the designer toolbar, select Save.

マルチパート/フォームデータ型のコンテンツContent with multipart/form-data type

HTTP 要求に multipart/form-data 型を含むコンテンツを処理する目的で、このフォーマットを使用することで、$content-type 属性と $multipart 属性を含む JSON オブジェクトを HTTP 要求の本文に追加できます。To handle content that has multipart/form-data type in HTTP requests, you can add a JSON object that includes the $content-type and $multipart attributes to the HTTP request's body by using this format.

"body": {
   "$content-type": "multipart/form-data",
   "$multipart": [
      {
         "body": "<output-from-trigger-or-previous-action>",
         "headers": {
            "Content-Disposition": "form-data; name=file; filename=<file-name>"
         }
      }
   ]
}

たとえば、Excel ファイルの HTTP POST 要求を Web サイトに送信するロジック アプリがあるとします。このとき、multipart/form-data 型をサポートする、そのサイトの API を使用します。For example, suppose you have a logic app that sends an HTTP POST request for an Excel file to a website by using that site's API, which supports the multipart/form-data type. このアクションは次のようになります。Here's how this action might look:

マルチパート フォーム データ

基礎ワークフロー定義で HTTP アクションの JSON 定義を示す同じ例は次のようになります。Here is the same example that shows the HTTP action's JSON definition in the underlying workflow definition:

{
   "HTTP_action": {
      "body": {
         "$content-type": "multipart/form-data",
         "$multipart": [
            {
               "body": "@trigger()",
               "headers": {
                  "Content-Disposition": "form-data; name=file; filename=myExcelFile.xlsx"
               }
            }
         ]
      },
      "method": "POST",
      "uri": "https://finance.contoso.com"
   },
   "runAfter": {},
   "type": "Http"
}

コネクタのレファレンスConnector reference

トリガーとアクションのパラメーターの詳細については、以下のセクションを参照してください。For more information about trigger and action parameters, see these sections:

出力の詳細Output details

ここでは、以下の情報を返す HTTP トリガーまたはアクションからの出力の詳細情報を示します。Here is more information about the outputs from an HTTP trigger or action, which returns this information:

プロパティ名Property name 種類Type [説明]Description
headersheaders objectobject 要求のヘッダーThe headers from the request
bodybody objectobject JSON オブジェクトJSON object 要求の本文の内容を含むオブジェクトThe object with the body content from the request
status codestatus code INTint 要求の状態コードThe status code from the request
status codeStatus code [説明]Description
200200 [OK]OK
202202 承認済みAccepted
400400 正しくない要求Bad request
401401 権限がありませんUnauthorized
403403 ForbiddenForbidden
404404 見つかりませんNot Found
500500 内部サーバー エラー。Internal server error. 不明なエラーが発生しました。Unknown error occurred.

次のステップNext steps