API Gateway 압축 임계값 점검

압축이 필요하면 유효한 바이트 단위 임계값을 지정하세요.

설명

REST API의 MinimumCompressionSize는 압축을 적용할 최소 본문 크기이며 유효 범위는 0부터 10485760바이트까지입니다. 생략하면 압축을 끌 수 있습니다. 압축은 전송 효율 설정으로, 암호화를 대신하지 않습니다.

잠재적 영향

범위 밖의 값은 API 구성을 실패하게 할 수 있고, 부적절한 임계값은 전송량과 처리 비용을 늘릴 수 있습니다.

해결 방법

응답 특성에 맞는 유효한 값을 선택하고 배포 후 지원되는 Accept-Encoding 요청으로 동작을 확인하세요. 압축이 불필요하면 설정을 생략하세요.

예시

예시는 유효하지 않은 -1을 0으로 바꿉니다. 0은 모든 본문 크기에 압축을 허용하지만, 실제 압축 여부는 콘텐츠 인코딩 조건에도 달려 있습니다.

변경 전

yaml
Resources:
  RestApi:
    Type: AWS::ApiGateway::RestApi
    Properties:
      Name: myApi
      MinimumCompressionSize: -1

변경 후

yaml
Resources:
  RestApi:
    Type: AWS::ApiGateway::RestApi
    Properties:
      Name: myApi
      MinimumCompressionSize: 0

참조