画像最適化を有効にする前に、技術的な制約、サポートされている形式、機能の運用上の境界を確認してください。これらの上限を理解しておくと、既存のメディア ワークフローとの互換性を確保し、効率的で信頼性の高い画像配信パイプラインを設計するうえで役立ちます。
このセクションでは、一般的な制約、割り当てと容量の上限、フェイルセーフ エラー処理、検証ルールについて説明します。
一般的な制約
画像最適化データプレーンは、厳格なシステム境界と検証ルールに照らして、すべての受信リクエストを検証します。エッジ パイプラインは、有効な形式を使用し、次の最適化制約を満たすリクエストを処理します。
制約 |
値 |
入力/出力 |
最大サイズ |
20 MB |
入力と出力 |
最大ディメンション |
ディメンションあたり 8,192 ピクセル |
入力と出力 |
Max Total Resolution |
67 mpx（67,108,864 メガピクセル） |
入力と出力 |
パラメータのケース |
snake_case（単語がアンダースコアで区切られている）、大文字と小文字を区別しない |
入力 |
厳格な検証 |
パラメータが 1 つでも無効な場合、システムはリクエスト全体を拒否し、 |
入力 |
割り当てと容量の上限
Cloud CDN はエッジで画像を動的に変換します。サービスの安定性を維持し、リソースの枯渇を防ぐため、Cloud CDN は各リージョン（ポイント オブ プレゼンス、または PoP）のデータプレーン処理容量を管理し、適用します。
特定のリージョンでのデータ転送がローカル処理容量を超えると、Cloud CDN は可用性を維持するために次の緩和策を自動的に実装します。
Cloud CDN は、リクエストを処理するために隣接するリージョンに自動的にルーティングします。このルーティングはイメージの最適化に役立ちますが、リージョン間のキャッシュ入力のレイテンシが発生します。
隣接するリージョンも容量を超えている場合、Cloud CDN はリクエストを拒否し、HTTP 429 Too Many Requests ステータス コードを返します。
フェイルセーフ エラー処理
このプラットフォームには、厳しい処理しきい値があります。
変換タイムアウト: エッジ処理アクションに時間がかかりすぎると、処理シーケンスがタイムアウトします。
処理に時間がかかりすぎると、処理は終了し、エンドユーザーに明示的なエラーコードが返されます。
検証ルール
システムで画像を正常に処理し、エラーを防ぐため、リクエストが次の上限を超えないようにしてください。
オペレーションの上限: 1 つのクエリ文字列に含めることができる画像オペレーション（
imop）は最大 10 個です。1 つのクエリ文字列に含めることができるのは、特定のタイプのオペレーション 1 つのみです。URL の長さの上限:
imopパラメータの変更文字列を含む URL パス全体が 1,024 文字を超えてはなりません。
パラメータの検証
システムは、受信したすべてのパラメータをスキーマと照らして検証します。リクエストが HTTP 400 (Bad Request) error で拒否されないようにするには、クエリ文字列内のすべてのオペレーションとパラメータで正しいスペルと形式が使用されていることを確認します。