Azure Logic Apps を使用して HTTP または HTTPS エンドポイントを呼び出すCall HTTP or HTTPS endpoints by using Azure Logic Apps

Azure Logic Apps と組み込み HTTP コネクタを使用すると、ロジック アプリを構築することで、任意の HTTP または HTTPS エンドポイントを定期的に呼び出すワークフローを自動化できます。With Azure Logic Apps and the built-in HTTP connector, you can automate workflows that regularly call any HTTP or HTTPS endpoint by building logic apps. たとえば、対象の 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」と入力します。On the designer, 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.

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

    HTTP に使用できる認証の種類の詳細については、「HTTP トリガーとアクションを認証する」を参照してください。For more information about authentication types available for HTTP, see Authenticate HTTP triggers and actions.

  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 finished, 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」と入力します。On the designer, 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.

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

    HTTP に使用できる認証の種類の詳細については、「HTTP トリガーとアクションを認証する」を参照してください。For more information about authentication types available for HTTP, see Authenticate HTTP triggers and actions.

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

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

コネクタのレファレンス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 TypeType 説明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 OKOK
202202 承認済みAccepted
400400 正しくない要求Bad request
401401 権限がありませんUnauthorized
403403 許可されていませんForbidden
404404 見つかりませんNot Found
500500 内部サーバー エラー。Internal server error. 不明なエラーが発生しました。Unknown error occurred.

次の手順Next steps