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

x-amazon-apigateway-integration.responses 객체

메서드의 응답을 정의하고 통합 응답에서 메서드 응답으로 파라미터 매핑 또는 페이로드 매핑을 지정합니다.

속성 이름 유형 설명
응답 상태 패턴 x-amazon-apigateway-integration.response 객체

메서드 응답에 대한 통합 응답을 일치시키는 데 사용되는 정규식이거나 구성하지 않은 응답을 포착하는 default입니다. HTTP 통합의 경우 이 regex가 통합 응답 상태 코드에 적용됩니다. Lambda 호출의 경우 Lambda 함수 실행에서 예외가 발생할 경우 AWS Lambda에서 반환한 오류 정보 객체의 errorMessage 필드에 regex가 실패 응답 본문으로 적용됩니다.

참고

응답 상태 패턴 속성 이름은 응답 상태 코드 그룹을 설명하는 응답 상태 코드 또는 정규 표현식을 참조합니다. 이는 API Gateway REST API의 IntegrationResponse 리소스의 ID에 해당되지 않습니다.

x-amazon-apigateway-integration.responses 예제

다음 예에서는 2xx 및 302 응답의 응답 목록을 표시합니다. 2xx 응답의 경우 메서드 응답이 application/json 또는 application/xml MIME 유형의 통합 응답의 페이로드에서 매핑됩니다. 이 응답에서는 제공된 매핑 템플릿을 사용합니다. 302 응답의 경우 메서드 응답은 통합 응답의 페이로드에 있는 Location 속성에서 값이 파생되는 redirect.url 헤더를 반환합니다.


"responses" : {
    "2\\d{2}" : {
        "statusCode" : "200",
        "responseTemplates" : {
            "application/json" : "#set ($root=$input.path('$')) { \"stage\": \"$root.name\", \"user-id\": \"$root.key\" }",
            "application/xml" : "#set ($root=$input.path('$')) <stage>$root.name</stage> "
        }
    },
    "302" : {
        "statusCode" : "302",
        "responseParameters" : {
            "method.response.header.Location": "integration.response.body.redirect.url"
        }
    }
}