기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
API에 대한 페이로드 압축 활성화
API Gateway를 통해 클라이언트는 지원되는 콘텐츠 코딩 중 하나를 사용하여 압축된 페이로드로 API를 호출할 수 있습니다. 기본적으로 API Gateway는 메서드 요청 페이로드의 압축 해제를 지원합니다. 하지만 메서드 응답 페이로드의 압축을 활성화하도록 API를 구성해야 합니다.
API에서 압축을 활성화하려면 API를 생성할 때나 API를 생성한 이후에 minimumCompressionsSize 속성을 0에서 10485760(1천만 바이트) 사이의 음이 아닌 정수로 설정하세요. API에서 압축을 비활성화하려면 minimumCompressionSize를 null로 설정하거나 제거하십시오. API Gateway 콘솔, AWS CLI 또는 API Gateway REST API를 사용하여 API에서 압축을 활성화하거나 비활성화할 수 있습니다.
크기에 상관없이 페이로드에서 압축을 적용하려면 minimumCompressionSize 값을 0으로 설정하십시오. 하지만 크기가 작은 데이터를 압축하면 실제로 최종 데이터 크기가 늘어날 수도 있습니다. 뿐만 아니라 API Gateway에서의 압축과 클라이언트에서의 압축 해제로 전체 지연 시간과 필요한 컴퓨팅 시간이 늘어날 수 있습니다. API에 대해 테스트 케이스를 실행하여 최적의 값을 결정해야 합니다.
클라이언트가 압축된 페이로드와 적절한 Content-Encoding 헤더와 함께 API 요청을 제출하면 API Gateway는 해당 요청을 통합 엔드포인트에 전달하기 전에 관련 매핑 템플릿을 압축 해제하고 적용할 수 있습니다. 압축이 활성화되고 API가 배포된 후 메서드 요청에서 적절한 Accept-Encoding 헤더가 지정된 경우, 클라이언트는 압축된 페이로드가 포함된 API 응답을 수신할 수 있습니다.
통합 엔드포인트가 압축되지 않은 JSON 페이로드를 예상하고 반환하면 압축되지 않은 JSON 페이로드를 위해 구성된 모든 매핑 템플릿을 압축된 페이로드에 적용할 수 있습니다. 압축된 메서드 요청 페이로드의 경우, API Gateway는 페이로드 압축을 해제하고 매핑 템플릿을 적용하며 매핑된 요청을 통합 엔드포인트에 전달합니다. 압축되지 않은 통합 응답 페이로드의 경우, API Gateway는 매핑 템플릿을 적용하고 매핑된 페이로드를 압축해 압축된 페이로드를 클라이언트에게 반환합니다.
