Example: Process asynchronous task messages with SMQ - Intelligent Media Management

Cette rubrique explique comment utiliser Simple Message Queue (SMQ) pour recevoir les notifications d'état des tâches asynchrones provenant d'Intelligent Media Management (IMM).

Créer des ressources Simple Message Queue (SMQ)

Étape 1 : Créer un topic SMQ

Connectez-vous à la console de gestion Simple Message Queue (SMQ).
Dans le volet de navigation de gauche, sélectionnez Topic List, puis cliquez sur Create Topic.
Dans le panneau Create Topic, créez un topic nommé tf-test-mns-topic.

Définissez maximum message length sur 65536 et réglez Enable Logging sur No.
Cliquez sur OK.

Étape 2 : Créer une file d'attente SMQ

Connectez-vous à la console de gestion Simple Message Queue (SMQ).
Dans le volet de navigation de gauche, sélectionnez Queue List, puis cliquez sur Create Queue.
Dans le panneau Create Queue, créez une file d'attente nommée tf-test-mns-queue.

Configurez les paramètres de la file d'attente comme suit : définissez maximum message length sur 64 Ko, long polling time sur 0 seconde (ce qui désactive le long polling), visibility timeout sur 30 secondes, message retention period sur 4 jours et message delay sur 0 seconde. Laissez Enable Logging désactivé.
Cliquez sur OK.

Étape 3 : Associer le topic et la file d'attente SMQ

Connectez-vous à la console de gestion Simple Message Queue (SMQ).
Dans le volet de navigation de gauche, sélectionnez Topic List, puis cliquez sur le topic créé à l'étape 1 : Créer un topic SMQ, à savoir tf-test-mns-topic.
Sélectionnez l'onglet Subscription List, puis cliquez sur Create Subscription.
Dans le panneau Create Subscription, créez un abonnement nommé tf-test-mns-subscription avec les paramètres suivants :
- Subscription Type : Sélectionnez Queue.
- Receiver Endpoint : Sélectionnez tf-test-mns-queue, la file d'attente créée à l'étape 2 : Créer une file d'attente SMQ.
- Message Format : Sélectionnez JSON.
Cliquez sur OK.

Facultatif : Créer des ressources Object Storage Service (OSS)

Remarque

Si vous disposez déjà des ressources requises dans Object Storage Service (OSS), ignorez cette section et passez directement à l'appel à IMM.

Étape 1 : Créer un bucket

Connectez-vous à la console de gestion Object Storage Service (OSS).
Dans le volet de navigation de gauche, sélectionnez Buckets, puis cliquez sur Create Bucket.
Dans le panneau Create Bucket, créez un bucket nommé tf-test-oss-bucket.

Étape 2 : Télécharger un fichier

Connectez-vous à la console de gestion Object Storage Service (OSS).
Dans le volet de navigation de gauche, sélectionnez Buckets, puis cliquez sur tf-test-oss-bucket, le bucket créé à l'étape 1 : Créer un bucket.
Cliquez sur Upload Object et suivez les instructions à l'écran pour télécharger le fichier 1.docx.

Effectuer un appel à IMM

Étape 1 : Créer un projet

Connectez-vous à la console de gestion Intelligent Media Management (IMM).
Dans le volet de navigation de gauche, sélectionnez Project List, puis cliquez sur Create Project.
Dans le panneau Create Project, créez un projet nommé tf-test-imm-project et définissez service-linked role sur AliyunIMMDefaultRole.

Important
Si vous utilisez un rôle de service personnalisé, consultez la rubrique Configurer un rôle de service pour un projet pour savoir comment définir les autorisations.
Cliquez sur OK.

Étape 2 : Effectuer un appel à IMM

Accédez à OpenAPI Explorer.
Dans la liste des API située à gauche, choisissez Document Processing > CreateOfficeConversionTask.
Saisissez les valeurs de paramètre suivantes :
- ProjectName : Saisissez tf-test-imm-project, le projet créé à l'étape 1 : Créer un projet.
- SourceURI : Saisissez oss://tf-test-oss-bucket/1.docx, le chemin d'accès au fichier source téléchargé à l'étape 2 : Télécharger un fichier ou à un autre document présent dans le bucket.
- TargetURIPrefix : Saisissez oss://tf-test-oss-bucket/output, le préfixe du chemin de stockage pour le fichier de sortie converti.
- TargetType : Saisissez png, le type de fichier de la sortie convertie.
- TopicName : Saisissez tf-test-mns-topic, le topic SMQ créé à l'étape 1 : Créer un topic SMQ.
Cliquez sur Initiate Call.

Recevoir des messages SMQ

Connectez-vous à la console de gestion Simple Message Queue (SMQ).
Dans le volet de navigation de gauche, sélectionnez Queue List, puis cliquez sur tf-test-mns-queue, la file d'attente créée à l'étape 2 : Créer une file d'attente SMQ.
Dans le coin supérieur droit de la page Queue Details, cliquez sur Send and Receive Messages.
Sur la page Send and Receive Messages, cliquez sur Receive Message. Un nouveau message s'affiche.

L'enregistrement du message reçu inclut les colonnes Message ID, Consume Count, First Consume Time, Message Creation Time et Actions (Details, Delete).
Dans la colonne Actions du message, cliquez sur Details pour afficher les détails du message.

La boîte de dialogue des détails du message contient les informations de base (message ID, Consume Count, First Consume Time, Message Creation Time, Next Visible Time et message handle) ainsi qu'une zone Original Message Content. Le type de message est imm:Task:OfficeConversion et la source est acs.imm, ce qui indique que la tâche de conversion de document IMM a été déclenchée avec succès. La boîte de dialogue affiche également Base64-decoded message content et Message MD5 Content.

FAQ

Impossible de recevoir des messages SMQ

Si vous ne parvenez pas à recevoir de messages SMQ, vérifiez les points suivants :

Vérifiez que le topic SMQ et le projet IMM se trouvent dans la même région.
Assurez-vous que la file d'attente SMQ est abonnée au topic et que message format de l'abonnement est défini sur JSON.
Vérifiez si plusieurs consommateurs traitent simultanément les messages de la file d'attente.
Vérifiez que le rôle de service du projet IMM dispose des autorisations nécessaires pour envoyer des messages à SMQ. Pour plus de détails, consultez la rubrique Configurer un rôle de service pour un projet.