HTTP 요청을 사용하여 Azure 함수 실행
HTTP 요청은 대부분의 플랫폼 및 디바이스에서 공통적인 작업입니다. 사전에서 단어를 조회하거나 지역 날씨를 가져오는 요청인지에 관계없이 항상 HTTP 요청을 보냅니다. Azure Functions를 사용하면 HTTP 요청을 수신할 때 실행할 하나의 논리를 신속하게 만들 수 있습니다.
이 단원에서는 HTTP 트리거를 사용하여 함수를 만들고 호출하는 방법을 알아봅니다. 또한 HTTP 트리거에 사용 가능한 일부 사용자 지정 옵션을 살펴봅니다.
HTTP 트리거란?
HTTP 트리거는 HTTP 요청을 수신할 때 코드를 실행하는 트리거입니다. HTTP 트리거에는 다음을 포함한 많은 기능과 사용자 지정이 있습니다.
- 키를 제공하여 권한 부여된 액세스 제공.
- 지원되는 HTTP 동사 제한.
- 데이터를 호출자에게 다시 반환.
- 쿼리 문자열 매개 변수 또는 요청 본문을 통해 데이터 수신.
- 함수 URL을 수정하기 위한 URL 경로 템플릿 지원.
HTTP 트리거를 만들 때 트리거에 이름을 제공하고 권한 부여 수준을 선택해야 합니다.
HTTP 트리거 권한 수준이란?
HTTP 트리거 권한 부여 수준은 들어오는 HTTP 요청에 권한 부여용 API 키가 필요한지 여부를 나타내는 플래그입니다.
다음과 같은 세 가지 권한 수준이 있습니다.
- 함수
- 익명
- 관리자
함수 및 관리자 수준은 “키”를 기반으로 합니다. HTTP 요청을 보내려면 권한 부여용 키를 제공해야 합니다. 두 가지 형식의 키는 함수 및 호스트입니다. 두 키 사이의 차이점은 범위입니다. 함수 키는 함수에 적용됩니다. 호스트 키는 함수 앱 내의 모든 함수에 적용됩니다. 권한 수준이 함수로 설정된 경우 ‘함수’ 또는 ‘호스트’ 키를 사용할 수 있습니다. 권한 수준이 관리자로 설정된 경우 ‘호스트’ 키를 제공해야 합니다.
Important
호스트 키는 함수 앱에 대한 고급 액세스를 제공하므로 호스트 키를 안전하게 전송하고 저장해야 합니다.
익명 수준은 권한 부여가 필요하지 않음을 의미합니다. 이 연습에서는 익명 권한 부여 수준을 사용합니다.
HTTP 트리거를 만드는 방법
타이머 트리거처럼 Azure Portal을 통해 HTTP 트리거를 만들 수 있습니다. Azure 함수 내에 있는 미리 정의된 트리거 유형 목록에서 HTTP 트리거를 선택한 다음, 실행하려는 논리를 입력하고, 특정 HTTP 동사 사용 제한 같은 사용자 지정을 만듭니다.
알고 있어야 하는 하나의 설정은 요청 매개 변수 이름입니다. 이 설정은 들어오는 HTTP 요청에 대한 정보를 포함하는 매개 변수의 이름을 나타내는 문자열입니다. 기본적으로 매개 변수의 이름은 req입니다.
HTTP 트리거를 호출하는 방법
HTTP 트리거를 호출하려면 HTTP 요청을 함수의 URL로 보냅니다. 이 URL을 가져오려면 함수의 코드 페이지로 이동하여 함수 URL 가져오기 링크를 선택합니다.
함수의 URL을 가져온 후 HTTP 요청을 보낼 수 있습니다. 함수가 데이터를 수신하는 경우 쿼리 문자열 매개 변수를 사용하거나 요청 본문을 통해 데이터를 제공할 수 있습니다.
HTTP 트리거는 함수 URL에 대한 HTTP 요청을 수신할 때 실행됩니다. HTTP 트리거를 사용하면 데이터를 수신하고, 논리를 실행하고, 필요에 따라 데이터를 호출자에게 다시 반환할 수 있습니다.