HTTP 트리거 (1세대)

Cloud Run Functions에서 HTTP 트리거는 HTTP(S) 요청에 대한 응답으로 함수를 실행할 수 있습니다. 함수에 대해 HTTP 트리거를 지정할 때는 요청을 수신할 수 있는 URL이 함수에 할당됩니다. HTTP 트리거는 GET, POST, PUT, DELETE, OPTIONS 요청 메서드를 지원합니다.

기본적으로 HTTP 트리거의 함수 요청에는 인증이 필요합니다. 배포 중 인증되지 않은 호출을 허용하도록 선택할 수 있습니다. 자세한 내용은 인증되지 않은 HTTP 함수 호출 허용을 참조하세요.

HTTP 함수를 사용하여 일반 HTTP(S) 요청을 처리할 수 있는 Cloud Run Functions를 구현합니다.

배포

함수를 배포할 때 HTTP 트리거를 지정할 수 있습니다. 함수 배포 방법에 대한 일반 안내는 Cloud Run 함수 배포를 참조하고 배포 중 HTTP 트리거 구성에 대한 추가 정보는 이 섹션을 참조하세요.

gcloud

gcloud CLI를 사용하여 배포하는 경우 여기 표시된 플래그가 HTTP 트리거 구성을 위해 사용됩니다.

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • --trigger-http 플래그는 함수에 HTTP 트리거가 사용되도록 지정합니다.
  • --allow-unauthenticated 플래그는 인증 없이 함수를 호출할 수 있도록 지정합니다. 이 플래그를 생략하면 함수 호출에 인증이 필요합니다. 자세한 내용은 호출 인증을 참조하세요.
  • --security-level 플래그는 함수 엔드포인트에 HTTPS가 필요한지 여부를 제어합니다. secure-always 값을 선택하면 HTTPS가 필요하고 SSL 이외의 HTTP 요청이 지원되지 않습니다. secure-optional 값을 선택하면 HTTP 및 HTTPS가 모두 지원됩니다. 기본값은 secure-always입니다.

콘솔

Google Cloud 콘솔을 사용하여 배포하는 경우 트리거 섹션에서 HTTP 트리거를 구성할 수 있습니다.

  1. 트리거 유형 필드에서 HTTP를 선택합니다.
  2. 인증 필드에서 인증되지 않은 함수 호출을 허용할지 여부에 따라 옵션을 선택합니다. 기본적으로 인증이 필요합니다. 자세한 내용은 호출 인증을 참고하세요.
  3. HTTPS 필요 체크박스를 선택하거나 선택 해제하여 함수 엔드포인트에 HTTPS가 필요한지 여부를 제어합니다. 선택 해제하면 HTTP 및 HTTPS가 모두 지원됩니다.

함수 URL

함수가 HTTP 트리거에 배포된 경우 할당된 URL을 검색할 수 있습니다.

Cloud Run 함수에는 다음과 같은 형식의 URL이 할당됩니다. 이러한 URL에는 결정된 형식이 사용됩니다. 즉, 함수를 배포하기 전에 URL을 예측할 수 있습니다.

https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

다음과 같이 함수 URL을 검색할 수 있습니다.

gcloud

  gcloud functions describe YOUR_FUNCTION_NAME 
--format="value(httpsTrigger.url)"

콘솔

  1. Google Cloud 콘솔에서 Cloud Run Functions 개요 페이지로 이동합니다.

    Cloud Run 함수로 이동

  2. URL을 검색할 함수의 이름을 클릭합니다.

  3. 수정 탭을 클릭합니다.

  4. 트리거 섹션에서 함수의 URL을 확인합니다.

다음 단계