# API Gateway의 REST API에 대한 매핑 템플릿이 없는 페이로드의 메서드 요청 동작 메서드 요청에 페이로드가 있고 `Content-Type` 헤더에 대해 정의된 매핑 템플릿이 없는 경우 변환 없이 통합 요청을 통해 클라이언트가 제공한 요청 페이로드를 백엔드로 전달하도록 선택할 수 있습니다. 이 프로세스를 통합 패스스루라고 합니다. 수신 요청의 실제 패스스루 동작은 이 설정에 따라 결정됩니다. 여기에는 다음과 같은 세 가지 옵션이 있습니다. **요청 Content-Type 헤더와 일치하는 템플릿이 없는 경우** 메서드 요청 콘텐츠 유형이 매핑 템플릿과 연결된 콘텐츠 유형 중 일치하지 않는 경우 메서드 요청 본문이 변환 없이 통합 요청을 지나 백엔드에 전달되도록 하려면 이 옵션을 선택합니다. API Gateway API를 호출하는 경우 이 옵션을 선택하려면 [통합](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html)에서 `WHEN_NO_MATCH`를 `passthroughBehavior` 속성 값으로 설정하면 됩니다. **정의된 템플릿이 없는 경우(권장)** 매핑 템플릿이 통합 요청에 정의되어 있지 않을 때 메서드 요청 본문이 변환 없이 통합 요청을 지나 벡엔드에 전달되도록 하려면 이 옵션을 선택합니다. 이 옵션을 선택할 때 템플릿이 정의되어 있는 경우 정의된 매핑 템플릿과 일치하지 않은 페이로드와 콘텐츠 유형이 있는 메서드 요청은 HTTP 415 미지원 미디어 유형 응답과 함께 거부됩니다. API Gateway API를 호출하는 경우 이 옵션을 선택하려면 [통합](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html)에서 `WHEN_NO_TEMPLATES`를 `passthroughBehavior` 속성 값으로 설정하면 됩니다. **없음** 매핑 템플릿이 통합 요청에 정의되어 있지 않을 때 메서드 요청 본문이 변환 없이 통합 요청을 지나 벡엔드에 전달되지 않도록 하려면 이 옵션을 선택합니다. 이 옵션을 선택할 때 템플릿이 정의되어 있는 경우 매핑되지 않은 콘텐츠 유형의 메서드 요청은 HTTP 415 미지원 미디어 유형 응답과 함께 거부됩니다. API Gateway API를 호출하는 경우 이 옵션을 선택하려면 [통합](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html)에서 `NEVER`를 `passthroughBehavior` 속성 값으로 설정하면 됩니다. 다음 예제에서는 가능한 패스스루 동작을 설명합니다. 예제 1: 하나의 매핑 템플릿이 `application/json` 콘텐츠 유형에 대한 통합 요청에 정의되어 있습니다. | 콘텐츠 유형 | 패스스루 옵션 | 동작 | | --- | --- | --- | | 없음 API Gateway의 기본값은 `application/json`입니다. | WHEN\$1NO\$1MATCH | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | 없음 API Gateway의 기본값은 `application/json`입니다. | WHEN\$1NO\$1TEMPLATES | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | 없음 API Gateway의 기본값은 `application/json`입니다. | NEVER | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | application/json | WHEN\$1NO\$1MATCH | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | application/json | WHEN\$1NO\$1TEMPLATES | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | application/json | NEVER | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | application/xml | WHEN\$1NO\$1MATCH | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | application/xml | WHEN\$1NO\$1TEMPLATES | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | | application/xml | NEVER | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | 예제 2: 하나의 매핑 템플릿이 `application/xml` 콘텐츠 유형에 대한 통합 요청에 정의되어 있습니다. | 콘텐츠 유형 | 패스스루 옵션 | 동작 | | --- | --- | --- | | 없음 API Gateway의 기본값은 `application/json`입니다. | WHEN\$1NO\$1MATCH | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | 없음 API Gateway의 기본값은 `application/json`입니다. | WHEN\$1NO\$1TEMPLATES | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | | 없음 API Gateway의 기본값은 `application/json`입니다. | NEVER | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | | application/json | WHEN\$1NO\$1MATCH | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | application/json | WHEN\$1NO\$1TEMPLATES | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | | application/json | NEVER | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | | application/xml | WHEN\$1NO\$1MATCH | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | application/xml | WHEN\$1NO\$1TEMPLATES | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | | application/xml | NEVER | 템플릿을 사용하여 요청 페이로드가 변환됩니다. | 예제 3: 통합 요청에 매핑 템플릿이 정의되지 않았습니다. | 콘텐츠 유형 | 패스스루 옵션 | 동작 | | --- | --- | --- | | 없음 API Gateway의 기본값은 `application/json`입니다. | WHEN\$1NO\$1MATCH | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | 없음 API Gateway의 기본값은 `application/json`입니다. | WHEN\$1NO\$1TEMPLATES | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | 없음 API Gateway의 기본값은 `application/json`입니다. | NEVER | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | | application/json | WHEN\$1NO\$1MATCH | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | application/json | WHEN\$1NO\$1TEMPLATES | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | application/json | NEVER | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. | | application/xml | WHEN\$1NO\$1MATCH | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | application/xml | WHEN\$1NO\$1TEMPLATES | 요청 페이로드가 변환되지 않고 백엔드로 그대로 전송됩니다. | | application/xml | NEVER | 요청이 HTTP 415 Unsupported Media Type 응답과 함께 거부됩니다. |