Object Storage Service:variable

Cas d'utilisation dans la console

• Tâches : Référencez les informations de l'objet source dans le chemin de sortie d'une tâche de traitement. Par exemple, pour convertir un document en images JPG, définissez le chemin de sortie sur oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Pendant le traitement, {autoext} est remplacé par jpg. Les images résultantes sont enregistrées dans oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg.

  Dans la boîte de dialogue Create Task, sélectionnez doc_to_jpg pour Style. Une invite sous Output Path indique que vous devez saisir une clé d'objet complète, que la clé d'objet peut inclure des variables et que les chemins d'entrée et de sortie doivent être différents. Dans la section Notification Configuration, sélectionnez Message Queue. Une fois la configuration terminée, cliquez sur OK.

• Traitement par lot : Lors de la création d'une tâche de traitement par lot, le système génère une tâche pour chaque objet existant. Pour éviter l'écrasement des données, nous vous recommandons d'utiliser des variables dans le chemin de sortie. Par exemple, pour extraire des images d'une vidéo et les enregistrer au format PNG, définissez le chemin de sortie sur oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Pendant le traitement, {autoext} est remplacé par png. Les images PNG générées sont enregistrées dans oss://test-bucket/output/source-directory/source-filename/frame-number.png.

  Après avoir configuré le chemin de sortie dans la section Output Configuration, assurez-vous que le chemin de sortie diffère du chemin d'entrée si vous utilisez les variables key, barename ou basename. Cela empêche l'écrasement de l'objet source et évite la création de boucles infinies. Dans la section Permission Configuration, sélectionnez AliyunIMMBatchTriggerRole (Default Role) pour Service Role, puis cliquez sur OK.

• Déclencheurs : La création d'un déclencheur génère une tâche pour chaque nouvel objet. Pour éviter l'écrasement des objets, nous vous recommandons d'utiliser des variables dans le chemin de sortie. Par exemple, si un déclencheur de conversion de document est créé pour convertir des documents en images JPG, définissez le chemin de sortie sur oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Pendant le traitement, {autoext} est remplacé par jpg. Les images JPG générées sont enregistrées dans oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg.

  Si vous utilisez les variables de clé d'objet, de nom de base sans extension ou de nom de base avec extension, assurez-vous que le chemin de sortie diffère du chemin d'entrée afin d'éviter l'écrasement des objets. Dans la section Permission Configuration, sélectionnez AliyunIMMBatchTriggerRole (Default Role) pour Service Role, puis cliquez sur OK.

Cas d'utilisation via API

• Enregistrer sous (sys/saveas) : Les paramètres b (bucket) et o (object) de l'opération Enregistrer sous (sys/saveas) prennent en charge les variables. Par exemple, pour convertir les pages 1 à 10 d'un document nommé example.docx en images PNG, définissez le paramètre sys/saveas sur b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw. Dans ce paramètre, e2J1Y2tldH0 correspond à la valeur encodée en Base64 de {bucket}, et ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw à la valeur encodée en Base64 de doc_images/{index}.png. Les images converties sont ensuite enregistrées dans le même bucket que l'objet source, à l'emplacement doc_images/index.png.

• Tâches : Le chemin de sortie des tâches prend en charge les variables. Par exemple, lorsque vous appelez l'opération CreateOfficeConversionTask pour créer une tâche de conversion de document, définissez le paramètre TargetURI sur le chemin de sortie complet, y compris l'extension. Le TargetURI peut contenir des variables, telles que oss://test-bucket/output/{dirname}/{barename}/{index}.jpg.

Exemple 1 : Conversion de format de document

L'exemple d'API RESTful suivant montre comment ajouter des paramètres de traitement à une requête PostObject pour convertir le format de example.docx. Les paramètres b (bucket) et o (object) de l'opération Enregistrer sous (sys/saveas) utilisent des variables.

• pages_MS0xMA : Convertit les pages 1 à 10 du document. MS0xMA est la valeur encodée en Base64 de « 1-10 ».

• target_png : Convertit le document au format d'image PNG.

• source_docx : Spécifie que le type d'objet source est DOCX.

• sys/saveas : Enregistrer sous.

  • b_e2J1Y2tldH0 : Une fois le transcodage terminé, la variable {bucket} enregistre les images résultantes dans le bucket source. e2J1Y2tldH0 est la valeur encodée en Base64 de {bucket}.

  • o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw : Enregistre l'objet dans le répertoire doc_images. La clé d'objet utilise la variable {index}, qui correspond au numéro de page de example.docx. ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw est la valeur encodée en Base64 de doc_images/{index}.png.

POST /exmaple.docx?x-oss-async-process HTTP/1.1
Host: doc-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
 // Converts pages 1 to 10 of the example.docx object to PNG images. The processed objects are saved to oss://source-bucket/doc_images/page-number.png.
x-oss-async-process=doc/convert,pages_MS0xMA,target_png,source_docx|sys/saveas,b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw

Exemple 2 : Transcodage vidéo

Cet exemple illustre comment transcoder l'objet example.avi en configurant plusieurs paramètres de traitement.

• f_mp4 : Définit le conteneur du fichier multimédia transcodé sur MP4.

• vcodec_h265 : Définit le format du flux vidéo sur H.265.

• s_1920x1080 : Définit la résolution sur 1920x1080.

• vb_2000000 : Définit le débit binaire vidéo sur 2 Mbps.

• fps_30 : Définit la fréquence d'images vidéo sur 30 ips.

• acodec_aac : Définit le format d'encodage audio sur AAC.

• ab_100000 : Définit le débit binaire audio sur 100 Kbps.

• sn_1 : Désactive le flux de sous-titres.

• sys/saveas : Enregistrer sous.

  • b_e2J1Y2tldH0 : Une fois le transcodage terminé, l'objet résultant est enregistré dans le bucket source à l'aide de la variable {bucket}. e2J1Y2tldH0 est la valeur encodée en Base64 de {bucket}.

  • o_b3V0cHV0LnthdXRvZXh0fQ : La variable {autoext} ajoute automatiquement une extension à l'objet, ce qui donne un objet enregistré nommé output.mp4. b3V0cHV0LnthdXRvZXh0fQ est la valeur encodée en Base64 de output.{autoext}.

POST /exmaple.avi?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
x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_e2J1Y2tldH0,o_b3V0cHV0LnthdXRvZXh0fQ