쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

HttpApi

포커스 모드

이 페이지에서

HttpApi - AWS Serverless Application Model

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

필터 보기

HttpAPI 유형의 이벤트 소스를 설명하는 객체입니다.

지정된 경로 및 메서드에 대한 OpenAPI 정의가 API에 있는 경우 SAM은 Lambda 통합 및 보안 섹션(해당하는 경우)을 자동으로 추가합니다.

API에 지정된 경로와 메서드에 대한 OpenApi 정의가 없는 경우 SAM이 이 정의를 자동으로 생성합니다.

명령문

귀하의 AWS Serverless Application Model(AWS SAM) 템플릿에서 이 객체를 선언하려면 다음 명령문을 사용합니다.

속성

ApiId

이 템플릿에 정의된 AWS::Serverless::HttpApi 리소스의 식별자입니다.

정의되지 않은 경우, AWS::Serverless::HttpApi을 정의하지 않는 이 템플릿에 정의된 Api 이벤트에 의해 정의된 모든 경로와 메서드의 집합을 포함하는 생성된 OpenAPI 문서를 사용하여 ServerlessHttpApi라는 명칭의 기본 ApiId 리소스가 생성됩니다.

이것은 다른 템플릿에 정의된 AWS::Serverless::HttpApi 리소스를 참조할 수 없습니다.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

Auth

이 특정 Api+Path+Method에 대한 인증 구성입니다.

지정된 DefaultAuthorizer가 없는 경우, API의 DefaultAuthorizer을 재정의하거나 개별 경로에 인증 구성을 설정하는 데 유용합니다.

유형: http://API/FunctionAuth

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

Method

이 함수가 간접 호출되는 HTTP 메서드입니다.

Path이나 Method 어느 것도 지정되지 않은 경우, SAM은 다른 엔드포인트에 매핑되지 않는 모든 요청을 이 Lambda 함수로 라우팅하는 기본 API 경로를 생성합니다. API당 이러한 기본 경로 중 하나만 존재할 수 있습니다.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

Path

이 함수가 호출되는 Uri 경로입니다. /로 시작해야 합니다.

Path이나 Method 어느 것도 지정되지 않은 경우, SAM은 다른 엔드포인트에 매핑되지 않는 모든 요청을 이 Lambda 함수로 라우팅하는 기본 API 경로를 생성합니다. API당 이러한 기본 경로 중 하나만 존재할 수 있습니다.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

PayloadFormatVersion

통합으로 전송되는 페이로드의 형식을 지정합니다.

참고: PayloadFormatVersion을 사용하려면 SAM이 OpenAPI 정의를 수정해야 하므로 DefinitionBody 속성에 정의된 인라인 OpenApi와만 작동합니다.

유형: 문자열

필수 항목 여부: 아니요

기본값: 2.0

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

RouteSettings

이 HTTP API의 경로별 경로 설정입니다. 경로 설정에 대한 자세한 내용은 API 게이트웨이 개발자 가이드AWS::API 게이트웨이V2::StageRouteSettings을 참조하세요.

참고: RouteSettings가 HttpApi 리소스와 이벤트 소스 모두에 지정된 경우 AWS SAM은 이들을 우선 순위가 있는 이벤트 소스 속성과 병합합니다.

유형: RouteSettings

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 RouteSettings 리소스의 AWS::ApiGatewayV2::Stage 속성으로 직접 전달됩니다.

TimeoutInMillis

50~29,000밀리초 사이의 제한 시간 사용자 지정입니다.

참고: TimeoutInMillis를 사용하려면 SAM이 OpenAPI 정의를 수정해야 하므로 DefinitionBody 속성에 정의된 인라인 OpenApi와만 작동합니다.

유형: 정수

필수 항목 여부: 아니요

기본값: 5000

AWS CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 AWS CloudFormation 동등한 속성이 없습니다.

예시

기본 HttpApi 이벤트

기본 경로를 사용하는 HttpApi 이벤트입니다. 이 API의 매핑되지 않은 모든 경로와 메서드는 이 엔드포인트로 라우팅됩니다.

YAML

Events: HttpApiEvent: Type: HttpApi

HttpApi

특정 경로와 메서드를 사용하는 HttpApi 이벤트입니다.

YAML

Events: HttpApiEvent: Type: HttpApi Properties: Path: / Method: GET

HttpApi 승인

권한 부여자를 사용하는HttpApi 이벤트입니다.

YAML

Events: HttpApiEvent: Type: HttpApi Properties: Path: /authenticated Method: GET Auth: Authorizer: OpenIdAuth AuthorizationScopes: - scope1 - scope2
프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.