Request Size Limiting

개요

요청 크기 제한 정책은 들어오는 API 요청에서 허용되는 최대 페이로드 크기(본문 내용)를 제한하는 데 사용됩니다. 이는 API가 과도한 데이터 소비와 대용량 페이로드로 인한 서비스 거부(DoS) 위험으로부터 보호하는 데 도움이 됩니다.

이 정책이 적용되면 모든 들어오는 요청이 측정되며, 허용된 크기를 초과하는 요청은 오류 응답과 함께 종료됩니다.

Field	Description
PayloadSize (필수)	요청에 대해 허용되는 최대 본문 크기(킬로바이트, KB)입니다. 값은 1KB 이상이어야 합니다.

노트

변경할 수 없음: 활성화되면 이 정책은 적용된 후 켜거나 끌 수 없습니다.

설정 값을 변경할 수 없음: 활성화되면 PayloadSize 는 저장된 후 수정할 수 없습니다.

통신 목적으로 최소 페이로드도 기본 전송 오버헤드를 발생시키므로 허용되는 최소 값은 1KB입니다.

요청 본문은 요청 출처 및 방법에 따라 콘텐츠 크기를 기준으로 평가됩니다. 이 정책이 활성화되면 페이로드 양에 따라 처리 시간이 달라질 수 있습니다.

클라이언트가 정의된 PayloadSize보다 큰 요청 본문을 보내면 API 게이트웨이는 오류를 반환합니다(일반적으로 HTTP 413 - 페이로드가 너무 큽니다).
JSON, XML 또는 파일 업로드와 같은 구조화된 입력을 예상하는 엔드포인트에서 이 정책을 사용하여 예상치 못한 대용량 본문에 대해 보호할 수 있습니다.
이 제한은 API 요청당 적용되며 예상 평균 요청 크기 + 버퍼 여유를 기준으로 선택해야 합니다.