Prima di abilitare l'ottimizzazione delle immagini, esamina i vincoli tecnici, i formati supportati, e i limiti operativi della funzionalità. La comprensione di questi limiti contribuisce a garantire la compatibilità con i flussi di lavoro multimediali esistenti e a progettare una pipeline di pubblicazione delle immagini efficiente e affidabile.
Questa sezione descrive i vincoli generali, i limiti di quota e capacità, la gestione degli errori di sicurezza e le regole di convalida.
Vincoli generali
Il piano di controllo dei dati di ottimizzazione delle immagini convalida tutte le richieste in entrata in base a limiti di sistema e regole di convalida rigorosi. La pipeline edge elabora le richieste che utilizzano formati validi e soddisfano i seguenti vincoli di ottimizzazione:
Vincolo |
Valore |
Input/Output |
Dimensioni massime |
20 MB |
Input e output |
Dimensione massima |
8192 px per dimensione |
Input e output |
Risoluzione totale massima |
67 mpx (67.108.864 megapixel) |
Input e output |
Case dei parametri |
Snake_case (parole separate da trattini bassi), senza distinzione tra maiuscole e minuscole |
Input |
Convalida rigorosa |
Se anche un solo parametro non è valido, il sistema rifiuta l'intera
richiesta e restituisce un |
Input |
Limiti di quota e capacità
Cloud CDN trasforma dinamicamente le immagini all'edge. Per mantenere la stabilità del servizio ed evitare l'esaurimento delle risorse, Cloud CDN gestisce e applica la capacità di elaborazione del piano di controllo dei dati per ogni regione (punto di presenza o PoP).
Se il trasferimento di dati in una regione specifica supera la capacità di elaborazione locale, Cloud CDN implementa automaticamente le seguenti strategie di mitigazione per preservare la disponibilità:
Cloud CDN instrada automaticamente la richiesta alle regioni adiacenti per l'elaborazione. Sebbene questo routing contribuisca a garantire l'ottimizzazione dell'immagine, introduce una latenza di riempimento della cache tra le regioni.
Se anche le regioni adiacenti sono al massimo della capacità, Cloud CDN rifiuta la richiesta e restituisce un codice di stato HTTP 429 Troppe richieste.
Gestione degli errori di sicurezza
La piattaforma ha una soglia di elaborazione rigorosa:
Timeout di trasformazione: se un'azione di elaborazione edge richiede troppo tempo, la sequenza di elaborazione va in timeout.
Se l'elaborazione richiede troppo tempo, viene terminata e all'utente finale viene restituito un codice di errore esplicito.
Regole di convalida
Per assicurarti che il sistema elabori correttamente le immagini ed evitare errori, verifica che le richieste non superino i seguenti limiti:
Limite di operazioni: puoi includere un massimo di 10 operazioni sulle immagini (
imop) in una singola stringa di query. Nella singola stringa di query può essere inclusa una sola operazione di un determinato tipo.Limite di lunghezza dell'URL: l'intero percorso dell'URL, inclusa la stringa di modifica del parametro
imop, non può superare i 1024 caratteri.
Convalida dei parametri
Il sistema convalida tutti i parametri in entrata in base a uno schema. Per evitare che la tua
richiesta venga rifiutata con un HTTP 400 (Bad Request) error, verifica
che tutte le operazioni e i parametri nella stringa di query utilizzino l'ortografia e la
formattazione corrette.
Passaggi successivi
- Casi d'uso dell'ottimizzazione delle immagini
- Protezione delle richieste di trasformazione delle immagini
- Risoluzione dei problemi e best practice