# x-amazon-apigateway-integration.requestParameters 객체
<a name="api-gateway-swagger-extensions-integration-requestParameters"></a>

REST API의 경우 명명된 메서드 요청 파라미터에서 통합 요청 파라미터로의 매핑을 지정합니다. 참조되기 전에 메서드 요청 파라미터를 정의해야 합니다.

HTTP API에 대해 지정된 `AWS_PROXY`과의 `integrationSubtype` 통합에 전달되는 파라미터를 지정합니다.


| 속성 이름 | 유형 | 설명 | 
| --- | --- | --- | 
| integration.request.<param-type>.<param-name> | string |  REST API의 경우 값은 주로 `method.request.<param-type>.<param-name>` 형식의 사전 정의된 메서드 요청 파라미터입니다. 여기서 `<param-type>`은 `querystring`, `path`, `header` 또는 `body`일 수 있습니다. 하지만 `$context.VARIABLE_NAME`, `$stageVariables.VARIABLE_NAME`, `STATIC_VALUE`도 유효합니다. `body` 파라미터의 경우 `<param-name>`은 `$.` 접두사가 없는 JSON 경로 표현식입니다.  | 
| parameter | string |  HTTP API의 경우 요청 파라미터는 지정된 `AWS_PROXY`과의 `integrationSubtype` 통합에 전달되는 파라미터를 지정하는 키-값 맵입니다. 정적 값을 제공하거나 런타임 시 평가되는 요청 데이터, 스테이지 변수 또는 컨텍스트 변수를 매핑할 수 있습니다. 자세한 내용은 [API Gateway에서 HTTP API에 대한 AWS 서비스 통합 생성](http-api-develop-integrations-aws-services.md) 단원을 참조하세요.  | 

## `x-amazon-apigateway-integration.requestParameters` 예제
<a name="api-gateway-swagger-extensions-request-parameters-example"></a>

다음에 나오는 요청 파라미터 매핑 예제에서는 메서드 요청의 쿼리(`version`), 헤더(`x-user-id`) 및 경로(`service`) 파라미터를 통합 요청의 쿼리(`stage`), 헤더(`x-userid`) 및 경로 파라미터(`op`)로 각각 변환합니다.

**참고**  
OpenAPI 또는 CloudFormation을 통해 리소스를 생성할 경우에는 정적 값을 작은따옴표로 묶어야 합니다.  
콘솔에서 이 값을 추가하려면 상자에 `application/json`을 따옴표 없이 입력합니다.

```
"requestParameters" : {
    "integration.request.querystring.stage" : "method.request.querystring.version",
    "integration.request.header.x-userid" : "method.request.header.x-user-id",
    "integration.request.path.op" : "method.request.path.service"
},
```