Operazioni supportate

Questa sezione elenca le operazioni supportate dall'ottimizzazione delle immagini di Cloud CDN. La tabella include parametri come operazione, sintassi, attributi, descrizione ed esempi, che ti aiutano a creare la query imop.

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

L'ottimizzazione delle immagini di Cloud CDN supporta un insieme di operazioni che ti consentono di trasformare le immagini, ad esempio ridimensionare, ritagliare e scalare. Ogni operazione ha una propria sintassi, attributi supportati e vincoli.

Questa pagina elenca le operazioni supportate dall'ottimizzazione delle immagini di Cloud CDN con esempi che ti aiutano a creare la query imop.

Nota: tutti i nomi, i valori e le operazioni dei parametri non sono sensibili alle maiuscole.

Operazione	Sintassi ed esempio	Attributi	Descrizione
Resize	?imop=Resize,width=<resized_width>,height=<resized_height> https://www.example.com/image.jpg?imop=Resize,width=250,height=125	width tipo: Integer (intervallo: 1-8192) height tipo: Integer (intervallo: 1-8192) la massima width * height non può superare i 67 mpx (67.108.864 pixel). Tipo di scalabilità (facoltativo): enum, valori: proportional, stretch.	Questa operazione non mantiene le proporzioni quando specifichi i parametri di larghezza e altezza. Se ometti una delle due dimensioni, l'ottimizzazione delle immagini di Cloud CDN calcola l'altra per mantenere le proporzioni. Per impostazione predefinita, l'ottimizzazione delle immagini applica una strategia rigorosa di riduzione delle dimensioni. Se specifichi il parametro scaling=stretch viene attivata la scalabilità, ma il sistema non lo consente se specifichi un solo parametro di dimensione.
Scale	?imop=Scale,ratio=<scale_ratio> https://www.example.com/image.jpg?imop=Scale,ratio=0.5	ratio Tipo: Float (limitato a 2 cifre decimali) Vincolo: 0 < value	Questa operazione scala l'immagine in base a un fattore specifico e applica solo la riduzione delle dimensioni. Si esclude a vicenda con le operazioni Resize e Crop. Se includi l'operazione Scale con le operazioni Resize o Crop in una singola richiesta, il sistema restituisce un errore.
Crop	?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y> https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512	shape Tipo: String (rectangle, circle) Valore predefinito: rectangle Dipendenza: deve essere utilizzato con il parametro crop. Un valore non valido restituirà HTTP 400. left, right, top, bottom Tipo: Float Intervallo: da 0,0 a 1,0, massimo 3 posizioni decimali Valore predefinito: 0,0, 1,0, 0,0, 1,0 snap_to_x, snap_to_y Tipo: Integer Intervallo: 0 o superiore Valore predefinito: 0 Vincolo: è obbligatorio includere almeno uno dei seguenti valori: left, right, top, bottom.	Questa operazione ritaglia l'immagine in base ai marcatori regionali. Se specifichi un valore non valido per il parametro shape, il sistema restituisce un errore HTTP 400 Bad Request. Le coordinate di ritaglio vengono automaticamente allineate al multiplo più vicino del valore snap_to_x o snap_to_y specificato.
Canvas	?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity> https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center	width, height Tipo: Integer Intervallo: 1-8192 La larghezza massima x l'altezza non può superare i 67.108.864 pixel. gravity Tipo: String Valori: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right Valore predefinito: center background_color Tipo: String Formato: codici esadecimali a 3, 4 o 6 cifre Valore predefinito: 000000 (nero).	Questa operazione migliora le immagini aggiungendo un layout di sfondo con dimensioni e colore specificati. Il parametro gravity determina il posizionamento dell'immagine interna su questa tela di sfondo.
Rotate	?imop=Rotate,degrees=<rotate_degrees> https://www.example.com/image.jpg?imop=Rotate,degrees=90	degrees Tipo: Integer Valori consentiti: 90, 180, 270.	Questa operazione ruota l'immagine di destinazione in senso orario.
Mirror	?imop=Mirror,flip=<flip> https://www.example.com/image.jpg?imop=Mirror,flip=h	flip Tipo: String Valori consentiti: h (orizzontale), v (verticale), hv (orizzontale e verticale).	Questa operazione riflette l'immagine in orizzontale, in verticale o in entrambi i modi.
Compress	?imop=Compress,strength=<value> https://www.example.com/image.jpg?imop=Compress,strength=medium	strength Tipo: String Valori consentiti: very_weak, weak, medium, strong, very_strong. Vincolo: supportato solo per jpeg, avif e webp. I valori al di fuori di questo intervallo restituiscono HTTP 400.	Questa operazione comprime l'immagine riducendone la qualità di destinazione. Il parametro strength ti consente di controllare il livello di compressione dell'immagine attiva.
Convert	?imop=Convert,format=<format> https://www.example.com/image.jpg?imop=Convert,format=webp	format Tipo: String. Valori consentiti: jpeg, png, webp, avif, gif Vincolo: qualsiasi altro valore non elencato genererà un errore di elaborazione.	Questa operazione modifica il formato di pubblicazione finale dell'immagine. Se si verifica un conflitto di elaborazione con la specifica dell'intestazione ACCEPT in entrata del browser, il sistema restituisce un errore HTTP 406 Not Acceptable.
Metadata	?imop=Metadata,preserve=<preserve> https://www.example.com/image.jpg?imop=Metadata,preserve=none	preserve Tipo: String Valori consentiti: none, copyright, max Valore predefinito: copyright	Questa operazione controlla la modalità di gestione delle proprietà dei metadati delle immagini durante l'esecuzione: none: rimuove tutte le proprietà dei metadati. max: conserva tutti i campi tranne l'orientamento EXIF e i profili colore che vengono applicati alla trasformazione . copyright: mantiene solo i campi Author, Copyright, e Caption.
Tone	?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation> https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50	brightness Tipo: Integer Intervallo: da -100 a 100 contrast Tipo: Integer Intervallo: da -100 a 100 saturation Tipo: Integer Intervallo: da -100 a 100	Questa operazione modifica dinamicamente i brightness, contrast, e saturation livelli di un'immagine. Se ometti un parametro specifico o lo imposti su 0, il sistema non modifica l'attributo. Se imposti la saturazione su -100, viene forzata la conversione in scala di grigi.
Sharpen	?imop=Sharpen,strength=<sharpness> https://www.example.com/image.jpg?imop=Sharpen,strength=50	strength Tipo: Integer Intervallo: da 0 a 100	Questa operazione aumenta la nitidezza dell'immagine.
Blur	?imop=Blur,strength=<blur_size> https://www.example.com/image.jpg?imop=Blur,strength=50	strength Tipo: Integer Intervallo: da 0 a 100	Questa operazione applica un filtro di sfocatura localizzato all'immagine.
Freeze	?imop=freeze,frame=<frame> https://www.example.com/image.gif?imop=freeze,frame=0	frame Tipo: Integer Intervallo: da 0 a 100.	Questa operazione estrae un singolo frame statico da una sequenza di immagini animate , ad esempio una GIF animata. Il parametro frame specifica l'indice del frame esatto da estrarre.

Passaggi successivi

• Limitazioni
• Casi d'uso dell'ottimizzazione delle immagini
• Protezione delle richieste di trasformazione delle immagini
• Risoluzione dei problemi e best practice