Azure Functions HTTP 출력 바인딩

  • 아티클

HTTP 출력 바인딩을 사용하여 HTTP 요청 발신자(HTTP 트리거)에 응답합니다. 이 바인딩에는 HTTP 트리거가 필요하며 트리거 요청과 관련된 응답을 사용자 지정할 수 있습니다.

HTTP 트리거 함수의 기본 반환 값은 다음과 같습니다.

  • HTTP 204 No Content Functions 2.x 이상에서 빈 본문 포함
  • Functions 1.x에서 빈 본문이 있는 HTTP 200 OK

attribute

In Process 및 격리된 작업자 프로세스 C# 라이브러리 모두 특성이 필요하지 않습니다. 대신 C# 스크립트는 C# 스크립팅 가이드에 설명된 대로 function.json 구성 파일을 사용합니다.

반환 값 특성은 필요하지 않습니다. 자세한 내용은 사용량을 참조하세요.

주석

Java 함수 런타임 라이브러리에서 HttpOutput 주석을 사용하여 함수에서 반환된 기본 변수가 아닌 다른 출력 변수를 정의합니다. 이 주석은 다음 설정을 지원합니다.

Important

이 문서에서는 탭을 사용하여 여러 버전의 Node.js 프로그래밍 모델을 지원합니다. v4 모델은 일반적으로 사용 가능하며 JavaScript 및 TypeScript 개발자를 위해 보다 유연하고 직관적인 환경을 제공하도록 설계되었습니다. v4 모델의 작동 방식에 대한 자세한 내용은 Azure Functions Node.js 개발자 가이드를 참조하세요. v3과 v4의 차이점에 대해 자세히 알아보려면 마이그레이션 가이드를 참조하세요.

구성

output.http() 메서드에 전달된 options 개체는 현재 모델 v4에 대한 속성을 지원하지 않습니다.

구성

다음 표에서는 function.json 파일에 설정된 바인딩 구성 속성을 설명합니다.

속성 설명
type http로 설정해야 합니다.
direction out로 설정해야 합니다.
이름 응답에 대한 함수 코드에 사용되는 변수 이름이거나 반환 값을 사용하는 $return입니다.

사용

HTTP 응답을 보내려면 언어 표준 응답 패턴을 사용합니다.

응답 형식은 C# 모드에 따라 다릅니다.

HTTP 트리거 함수는 HttpResponseData 개체 또는 Task<HttpResponseData>을(를) 반환합니다. 앱이 .NET Isolated에서 ASP.NET Core 통합을 사용하는 경우 IActionResult, Task<IActionResult>, HttpResponse 또는 Task<HttpResponse>을(를) 사용할 수도 있습니다.

Java의 경우 HttpResponseMessage.Builder를 사용하여 HTTP 트리거에 대한 응답을 만듭니다. 자세한 내용은 HttpRequestMessage 및 HttpResponseMessage를 참조하세요.

예제 응답은 트리거 예제를 참조하세요.

다음 단계