x-amazon-apigateway-integration.requestParameters 객체 - Amazon API Gateway
x-amazon-apigateway-integration.requestParameters 예제

x-amazon-apigateway-integration.requestParameters 객체

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 서비스 통합 생성 단원을 참조하세요.

x-amazon-apigateway-integration.requestParameters 예제

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

참고

OpenAPI 또는 AWS 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"
},