Les requêtes de traitement asynchrone renvoient uniquement un ID de tâche. Pour obtenir le résultat d'une tâche une fois le traitement des données terminé, ajoutez des paramètres de notification de messages à la requête de traitement.
Remarques sur l'utilisation
La notification de messages est disponible uniquement pour le traitement asynchrone.
La notification de messages prend en charge uniquement les topics Simple Message Queue (SMQ). SMQ était auparavant connu sous le nom de MNS. Pour plus d'informations sur SMQ, consultez Démarrage rapide de SMQ.
Description des paramètres
Lorsque vous utilisez le paramètre notify, incluez l'option suivante :
|
Paramètre |
Obligatoire |
Description |
|
topic |
Oui |
Nom du topic SMQ.
Pour savoir comment obtenir le nom du topic SMQ, consultez Comment afficher le nom de mon topic SMQ dans la console ? |
Utiliser les API REST
Si votre programme nécessite un niveau élevé de personnalisation, initiez directement des requêtes d'API REST. Vous devez alors écrire manuellement le code de calcul des signatures.
Lorsque vous appelez l'opération PostObject pour traiter un objet, transmettez le paramètre x-oss-async-process dans le corps de la requête. Ajoutez ensuite le paramètre notify à la requête pour recevoir des notifications de messages concernant les résultats. La notification de messages prend en charge uniquement les topics SMQ. Pour plus d'informations sur l'utilisation de SMQ, consultez Guide de version du SDK Python.
Les sections suivantes fournissent des exemples de réception de notifications de messages SMQ dans différents scénarios.
Utiliser des paramètres de traitement pour convertir un document et recevoir des notifications de messages SMQ
Informations sur la conversion
-
Avant la conversion
Type de fichier : DOCX
Nom du fichier :
example.docx
-
Après la conversion
Type de fichier : PNG
Chemin de stockage :
oss://test-bucket/doc_images/
-
Notification de message
La notification de résultat de conversion est envoyée au topic SMQ nommé
test-topic.
Exemple de traitement
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 example.docx to PNG, saves it to oss://test-bucket/doc_images/, and sends a notification to the test-topic SMQ topic.
x-oss-async-process=doc/convert,target_png,source_docx|sys/saveas,b_dGVzdC1idWNrZXQ,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw/notify,topic_dGVzdC10b3BpYwUtiliser des paramètres de style pour transcoder une vidéo et l'enregistrer dans un bucket spécifié
Informations sur le transcodage
-
Avant le transcodage
Format vidéo : AVI
Nom de la vidéo :
example.avi
-
Après le transcodage
Format vidéo : MP4
Nom de la vidéo :
outobjprefix.mp4Chemin de stockage :
oss://outbucket/outobjprefix.mp4
-
Notification de message
La notification de résultat de transcodage est envoyée au topic SMQ nommé
test-topic.
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
// Transcodes example.avi using the examplestyle style, saves the output to oss://outbucket/outobjprefix.mp4, and sends a notification to the test-topic SMQ topic.
x-oss-async-process=style/examplestyle|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_dGVzdC10b3BpYwFormats de message pour les opérations x-oss-process
|
Module de fonctionnalité |
Opération x-oss-process |
Format de message |
|
Traitement de documents |
Exemple de message MNS pour l'opération CreateOfficeConversionTask |
|
|
ApsaraVideo Media Processing |
Exemple de message MNS pour l'opération CreateMediaConvertTask |
|
|
Traitement de fichiers |
Exemple de message MNS pour l'opération CreateCompressPointCloudTask |
|
|
Traitement d'images |
Exemple de message MNS pour l'opération CreateDecodeBlindWatermarkTask |
FAQ
Comment afficher le nom de mon topic SMQ dans la console ?
Pour configurer un topic Simple Message Queue (SMQ) pour les notifications d'événements OSS, vous devez utiliser un topic qui se trouve dans la même région que votre bucket OSS. Suivez ces étapes pour trouver le nom d'un topic SMQ. SMQ était auparavant connu sous le nom de MNS.
Connectez-vous à la console Simple Message Queue (SMQ), anciennement MNS.
Dans la barre de navigation supérieure de la console, assurez-vous de sélectionner la même région que votre bucket OSS.
Dans le volet de navigation de gauche, cliquez sur Topic-based Model > Topic List pour afficher tous les topics créés dans la région actuelle.
Parcourez la liste des topics pour trouver le nom du topic que vous souhaitez utiliser pour votre configuration de notification d'événements OSS.
En suivant ces étapes, vous pouvez trouver le nom du topic SMQ dans la même région que votre bucket OSS. L'utilisation du nom de topic correct garantit que les événements OSS sont envoyés à la file d'attente de messages pour traitement.