다음을 통해 공유

Azure Functions HTTP 출력 바인딩

  • 아티클

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

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

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

특성

HttpResponseData를 사용하는 경우 반환 값 특성이 필요하지 않습니다. 그러나 ASP.NET Core 통합 및 다중 바인딩 출력 개체[HttpResultAttribute]를 사용하는 경우 개체 속성에 특성을 적용해야 합니다. 이 특성은 매개 변수를 사용하지 않습니다. 자세한 내용은 사용량을 참조하세요.

주석

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 응답을 보내려면 언어 표준 응답 패턴을 사용합니다.

.NET에서 응답 형식은 C# 모드에 따라 달라집니다.

HTTP 트리거 함수는 다음 형식 중 하나의 개체를 반환합니다.

  • IActionResult1 (또는 Task<IActionResult>)
  • HttpResponse1 (또는 Task<HttpResponse>)
  • HttpResponseData (또는 Task<HttpResponseData>)
  • 응답에 대한 응답 본문을 나타내는 JSON 직렬화 가능 형식입니다 200 OK .

1 이 형식은 ASP.NET Core 통합을 사용하는 경우에만 사용할 수 있습니다.

이러한 형식 중 하나가 다중 바인딩 출력 개체[HttpResult]의 일부로 사용되는 경우 개체 속성에 특성을 적용해야 합니다. 이 특성은 매개 변수를 사용하지 않습니다.

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

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

다음 단계