이미지 최적화를 사용 설정하기 전에 기능의 기술적 제약 조건, 지원되는 형식, 운영 경계를 검토하세요. 이러한 한도를 이해하면 기존 미디어 워크플로와의 호환성을 보장하고 효율적이고 안정적인 이미지 전송 파이프라인을 설계하는 데 도움이 됩니다.
이 섹션에서는 일반적인 제약 조건, 할당량 및 용량 한도, 안전 장치 오류 처리, 유효성 검사 규칙을 설명합니다.
일반 제약 조건
이미지 최적화 데이터 영역은 엄격한 시스템 경계 및 유효성 검사 규칙에 따라 모든 수신 요청의 유효성을 검사합니다. 에지 파이프라인은 유효한 형식 을 사용하고 다음 최적화 제약 조건을 충족하는 요청을 처리합니다.
제약 조건 |
값 |
입력/출력 |
최대 크기 |
20 MB |
입력 및 출력 |
최대 크기 |
크기당 8192px |
입력 및 출력 |
최대 총 해상도 |
6,700만 화소 (67,108,864 메가픽셀) |
입력 및 출력 |
매개변수 대소문자 |
snake_case (단어는 밑줄로 구분), 대소문자 구분 안 함 |
입력 |
엄격한 유효성 검사 |
하나의 매개변수라도 유효하지 않으면 시스템에서 전체
요청을 거부하고 |
입력 |
할당량 및 용량 한도
Cloud CDN은 에지에서 이미지를 동적으로 변환합니다. 서비스 안정성을 유지하고 리소스 소진을 방지하기 위해 Cloud CDN은 각 리전(접속 지점 또는 PoP)의 데이터 영역 처리 용량을 관리하고 적용합니다.
특정 리전의 데이터 전송이 로컬 처리 용량을 초과하면 Cloud CDN은 가용성을 유지하기 위해 다음 완화 전략을 자동으로 구현합니다.
Cloud CDN은 처리를 위해 요청을 인접 리전으로 자동 라우팅합니다. 이 라우팅은 이미지가 최적화되도록 하는 데 도움이 되지만 리전 간 캐시 채우기 지연 시간이 발생합니다.
인접 리전도 용량에 도달하면 Cloud CDN은 요청을 거부하고 HTTP 429 Too Many Requests 상태 코드를 반환합니다.
안전 장치 오류 처리
플랫폼에는 엄격한 처리 기준점이 있습니다.
변환 제한 시간: 에지 처리 작업이 너무 오래 걸리면 처리 시퀀스가 제한 시간 초과됩니다.
처리가 너무 오래 걸리면 종료되고 최종 사용자에게 명시적 오류 코드가 제공됩니다.
유효성 검사 규칙
시스템에서 이미지를 성공적으로 처리하고 오류를 방지하려면 요청이 다음 한도 내에 있어야 합니다.
작업 한도: 단일 쿼리 문자열에 최대 10개의 이미지 작업 (
imop)을 포함할 수 있습니다. 단일 쿼리 문자열에는 지정된 유형의 작업 하나만 포함될 수 있습니다.URL 길이 한도:
imop매개변수 수정 문자열을 포함한 전체 URL 경로는 1,024자를 초과할 수 없습니다.
매개변수 유효성 검사
시스템은 스키마에 따라 모든 수신 매개변수의 유효성을 검사합니다.
요청이 HTTP 400 (Bad Request) error으로 거부되지 않도록 하려면 쿼리 문자열의 모든 작업과 매개변수에 올바른 맞춤법과
형식이 사용되었는지 확인하세요.