Tous les produits
Search

Ce produit

    Object Storage Service:Styles

    Centre de documentation

    Object Storage Service:Styles

    Dernière mise à jour :Aug 18, 2026

    Regroupez plusieurs paramètres de traitement dans un style réutilisable afin de simplifier le traitement des médias, des documents ou des images.

    Remarque

    Les API et SDK de traitement des données sont disponibles dans les régions disposant de points de terminaison Intelligent Media Management (IMM).

    Utiliser des styles personnalisés

    Créer un style

    Remarque

    Un bucket prend en charge jusqu'à 50 styles, qui s'appliquent uniquement aux fichiers de ce bucket. Pour demander davantage de styles, contactez le support technique.

    1. Connectez-vous à la console OSS.

    2. Dans le volet de navigation de gauche, cliquez sur Buckets, puis sur le nom du bucket de destination.

    3. Dans le volet de navigation de gauche, choisissez Data Processing.

    4. Selon votre type de fichier, choisissez IMG, Document Processing ou Media Processing.

    5. Sélectionnez l'onglet Style Management, puis cliquez sur Create Style.

    6. Dans le panneau Create Style, configurez le style.

    7. Cliquez sur OK.

    Utiliser un style

    Utilisez un style pour traiter des fichiers via une URL d'objet (synchrone) ou une requête asynchrone.

    Traitement synchrone avec une URL d'objet

    Pour traiter un objet de manière synchrone, ajoutez le style à son URL : http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName. Le tableau suivant décrit les paramètres.

    Paramètre

    Description

    Exemple

    http(s)://BucketName.Endpoint/ObjectName

    L'URL de l'objet. Obtenir les URL d'un ou plusieurs fichiers.

    https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/small

    x-oss-process=style/

    Préfixe fixe pour le traitement basé sur un style.

    StyleName

    Le nom du style personnalisé.

    Simplifiez l'URL avec un séparateur personnalisé et un nom de domaine personnalisé :

    Par exemple, si vous mappez le nom de domaine personnalisé example.com au bucket, vous pouvez utiliser https://example.com/example.jpg!small pour traiter l'image.

    Remarque

    Depuis le 9 octobre 2022 (UTC+8), l'aperçu en ligne est désactivé pour les nouveaux buckets sans nom de domaine personnalisé mappé. Consultez l'annonce officielle.

    Traitement asynchrone avec un style

    Utilisez x-oss-async-process=style/StyleName pour traiter un fichier de manière asynchrone :

    POST /ObjectName?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
 // Asynchronously process the file example.avi with the StyleName style and save the output to oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

    Le tableau suivant décrit les paramètres.

    Paramètre

    Description

    ObjectName

    Le nom de l'objet.

    x-oss-async-process=style/

    Préfixe fixe pour le traitement basé sur un style.

    StyleName

    Le nom du style personnalisé.

    Utiliser des styles intégrés

    OSS propose également des styles intégrés pour le traitement des fichiers.

    Traitement asynchrone avec un style

    Utilisez x-oss-async-process=style/::systemStyleName pour traiter un fichier de manière asynchrone avec un style intégré :

    POST /ObjectName?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 
// Asynchronously process the file example.avi with the built-in style h264-mp4-1080p and save the output to oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

    Le tableau suivant décrit les paramètres.

    Paramètre

    Description

    ObjectName

    Le nom de l'objet.

    x-oss-async-process=style/

    Préfixe fixe pour le traitement basé sur un style.

    :: 

    Préfixe pour un style intégré.

    systemStyleName

    Le nom du style intégré.

    Remarque

    Vous pouvez afficher tous les paramètres de style intégrés pris en charge sur la page Data Processing>Media Processing.

    Importer des styles entre buckets

    Remarque

    Cette fonctionnalité prend uniquement en charge les styles IMG.

    Exportez les styles depuis un bucket source et importez-les dans un bucket de destination pour réutiliser les mêmes styles de traitement d'image.

    1. Exportez les styles depuis le bucket source.

      1. Sur la page de gestion du bucket source, choisissez Data Processing>IMG.

      2. Sur la page IMG, cliquez sur Export Style.

      3. Dans la boîte de dialogue qui s'affiche, sélectionnez un emplacement pour enregistrer le fichier de style, puis cliquez sur Save.

    2. Importez les styles dans le bucket de destination.

      1. Sur la page de gestion du bucket de destination, choisissez Data Processing>IMG.

      2. Sur la page IMG, cliquez sur Import Style.

      3. Dans la boîte de dialogue qui s'affiche, sélectionnez le fichier de style exporté, puis cliquez sur Open.

        Les styles importés sont désormais disponibles pour le traitement des fichiers image dans le bucket de destination.

    Références