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. 예를 들어 지정 된 일정에 따라 해당 끝점을 확인 하 여 웹 사이트에 대 한 서비스 끝점을 모니터링할 수 있습니다.For example, you can monitor the service endpoint for your website by checking that endpoint on a specified schedule. 웹 사이트의 작동이 중단 되는 경우와 같이 해당 끝점에서 특정 이벤트가 발생 하면 이벤트는 논리 앱의 워크플로를 트리거하고 지정 된 작업을 실행 합니다.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. 그렇지 않으면 커넥터에서 지원 되는 가장 높은 다음 버전을 사용 합니다.Otherwise, the connector uses the next highest supported version.

필수 구성 요소Prerequisites

  • Azure 구독.An Azure subscription. Azure 구독이 없는 경우 체험 Azure 계정에 등록합니다.If you don't have an Azure subscription, sign up for a free Azure account.

  • 호출 하려는 대상 끝점의 URL입니다.The URL for the target endpoint that you want to call

  • 논리 앱 만드는 방법에 관한 기본 지식Basic knowledge about how to create logic apps. 논리 앱을 처음 접하는 경우 Azure Logic Apps란?을 검토합니다.If you're new to logic apps, review What is Azure Logic Apps?

  • 대상 끝점을 호출 하려는 논리 앱입니다.The logic app from where you want to call the target endpoint. HTTP 트리거를 시작 하려면 빈 논리 앱을 만듭니다.To start with the HTTP trigger, create a blank logic app. HTTP 작업을 사용 하려면 원하는 트리거를 사용 하 여 논리 앱을 시작 합니다.To use the HTTP action, start your logic app with any trigger that you want. 이 예제에서는 첫 번째 단계로 HTTP 트리거를 사용 합니다.This example uses the HTTP trigger as the first step.

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 트리거"로 트리거의 이름을 바꿉니다.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. Logic Apps 디자이너에서 논리 앱을 엽니다.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.

Multipart/form 데이터 형식의 콘텐츠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>"
         }
      }
   ]
}

예를 들어 multipart/form-data 형식을 지 원하는 해당 사이트의 API를 사용 하 여 Excel 파일에 대 한 HTTP POST 요청을 웹 사이트로 보내는 논리 앱이 있다고 가정 합니다.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 개체(object)object 요청의 헤더입니다.The headers from the request
bodybody 개체(object)object JSON 개체JSON object 요청의 본문 내용이 포함 된 개체입니다.The object with the body content from the request
status codestatus code ssNoversionint 요청의 상태 코드The status code from the request
status codeStatus code 설명Description
200200 확인OK
202202 수락됨Accepted
400400 잘못된 요청Bad request
401401 권한 없음Unauthorized
403403 사용할 수 없음Forbidden
404404 찾을 수 없음Not Found
500500 내부 서버 오류.Internal server error. 알 수 없는 오류 발생.Unknown error occurred.

다음 단계Next steps