Opérations prises en charge

Cette section liste les opérations compatibles avec l'optimisation des images Cloud CDN. Le tableau inclut des paramètres tels que l'opération, la syntaxe, les attributs, la description et des exemples, ce qui vous aide à créer votre requête imop.

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

L'optimisation des images Cloud CDN est compatible avec un ensemble d'opérations qui vous permettent de transformer vos images, par exemple en les redimensionnant, en les recadrant et en les mettant à l'échelle. Chaque opération possède sa propre syntaxe, ses propres attributs compatibles et ses propres contraintes.

Cette page liste les opérations compatibles avec l'optimisation des images Cloud CDN, avec des exemples qui vous aident à créer votre requête imop.

Remarque : Les noms, valeurs et opérations des paramètres ne sont pas sensibles à la casse.

Opération	Syntaxe et exemple	Attributs	Description
Resize	?imop=Resize,width=<resized_width>,height=<resized_height> https://www.example.com/image.jpg?imop=Resize,width=250,height=125	Type width : entier (plage : 1 à 8192) Type height : entier (plage : 1 à 8192) La valeur maximale de width * height ne peut pas dépasser 67 mpx (67 108 864 pixels). Type de mise à l'échelle (facultatif) : énumération, valeurs : proportionnel, étirement.	Cette opération ne conserve pas les proportions lorsque vous spécifiez les paramètres de largeur et de hauteur. Si vous omettez l'une des dimensions, l'optimisation des images Cloud CDN calcule l'autre pour conserver les proportions. Par défaut, l'optimisation des images applique une stratégie stricte de réduction uniquement. Si vous spécifiez le scaling=stretch paramètre, la mise à l’échelle est activée, mais le système ne l’autorise pas si vous spécifiez qu’un seul paramètre de taille.
Scale	?imop=Scale,ratio=<scale_ratio> https://www.example.com/image.jpg?imop=Scale,ratio=0.5	ratio Type : float (limité à deux décimales) Contrainte : 0 < value	Cette opération met l'image à l'échelle selon un facteur spécifique et n'autorise que la réduction. Elle est mutuellement exclusive des opérations de redimensionnement et de recadrage. Si vous incluez l'opération Scale avec les opérations Resize ou Crop dans une seule requête, le système renvoie une erreur.
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 Type : chaîne (rectangle, cercle) Valeur par défaut : rectangle Dépendance : doit être utilisé avec le paramètre de recadrage. Une valeur non valide renvoie une erreur HTTP 400. left, right, top, bottom Type : float Plage : 0,0 à 1,0, 3 décimales maximum Valeur par défaut : 0,0, 1,0, 0,0, 1,0 snap_to_x, snap_to_y Type : entier Plage : 0 ou plus Valeur par défaut : 0 Contrainte : au moins l'un des éléments suivants doit être inclus : left, right, top, bottom.	Cette opération recadre l'image en fonction de repères régionaux. Si vous spécifiez une valeur non valide pour le paramètre shape, le système renvoie une erreur HTTP 400 Bad Request. Les coordonnées de recadrage s'alignent automatiquement sur le multiple le plus proche de la valeur snap_to_x ou snap_to_y spécifiée.
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 Type : entier Plage : 1 à 8192 La largeur maximale multipliée par la hauteur ne peut pas dépasser 67 108 864 pixels. gravity Type : chaîne Valeurs : center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right Valeur par défaut : center background_color Type : chaîne Format : codes hexadécimaux à 3, 4 ou 6 chiffres Valeur par défaut : 000000 (noir).	Cette opération améliore les images en ajoutant une mise en page d'arrière-plan avec les dimensions et la couleur spécifiées. Le paramètre gravity détermine l' emplacement de l'image intérieure sur ce canevas d'arrière-plan.
Rotate	?imop=Rotate,degrees=<rotate_degrees> https://www.example.com/image.jpg?imop=Rotate,degrees=90	degrees Type : entier Valeurs autorisées : 90, 180, 270.	Cette opération fait pivoter l'image cible dans le sens des aiguilles d'une montre.
Mirror	?imop=Mirror,flip=<flip> https://www.example.com/image.jpg?imop=Mirror,flip=h	flip Type : chaîne Valeurs autorisées : h (horizontal), v (vertical), hv (horizontal et vertical).	Cette opération met l'image en miroir horizontalement, verticalement ou les deux.
Compress	?imop=Compress,strength=<value> https://www.example.com/image.jpg?imop=Compress,strength=medium	strength Type : chaîne Valeurs autorisées : very_weak, weak, medium, strong, very_strong. Contrainte : compatible uniquement avec les formats JPEG, AVIF et WebP. Les valeurs en dehors de cette plage renvoient une erreur HTTP 400.	Cette opération compresse l'image en réduisant sa qualité. Le paramètre strength vous permet de contrôler le niveau de compression de l'image active.
Convert	?imop=Convert,format=<format> https://www.example.com/image.jpg?imop=Convert,format=webp	format Type : chaîne. Valeurs autorisées : JPEG, PNG, WebP, AVIF, GIF Contrainte : toute autre valeur non listée entraînera une erreur de traitement.	Cette opération modifie le format de diffusion final de l'image. En cas de conflit de traitement avec la spécification de l'en-tête ACCEPT entrant du navigateur, le système renvoie une erreur HTTP 406 Not Acceptable.
Metadata	?imop=Metadata,preserve=<preserve> https://www.example.com/image.jpg?imop=Metadata,preserve=none	preserve Type : chaîne Valeurs autorisées : none, copyright, max Valeur par défaut : copyright	Cette opération contrôle la façon dont les propriétés des métadonnées d'image sont gérées lors de l'exécution : none : supprime toutes les propriétés des métadonnées. max : conserve tous les champs à l'exception de l'orientation EXIF et des profils de couleur qui sont appliqués lors de la transformation . copyright : ne conserve que les champs Author, Copyright, et Caption fields.
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 Type : entier Plage : -100 à 100 contrast Type : entier Plage : -100 à 100 saturation Type : entier Plage : -100 à 100	Cette opération modifie dynamiquement les brightness, contrast, et saturation niveaux d'une image. Si vous omettez un paramètre spécifique ou que vous le définissez sur 0, le système ne modifie pas cet attribut. Si vous définissez la saturation sur -100, la conversion en niveaux de gris est forcée.
Sharpen	?imop=Sharpen,strength=<sharpness> https://www.example.com/image.jpg?imop=Sharpen,strength=50	strength Type : entier Plage : 0 à 100	Cette opération augmente la netteté de l'image.
Blur	?imop=Blur,strength=<blur_size> https://www.example.com/image.jpg?imop=Blur,strength=50	strength Type : entier Plage : 0 à 100	Cette opération applique un filtre de flou localisé sur l'image.
Freeze	?imop=freeze,frame=<frame> https://www.example.com/image.gif?imop=freeze,frame=0	frame Type : entier Plage : 0 à 100.	Cette opération extrait une seule image statique d'une séquence d'images animées , comme un GIF animé. Le paramètre frame spécifie l'index exact de l'image à extraire.

Étape suivante

• Limites
• Cas d'utilisation de l'optimisation des images
• Sécuriser les requêtes de transformation d'image
• Dépannage et bonnes pratiques