Todos los productos
Search

Este producto

    Object Storage Service:Notificación de mensajes

    Centro de documentos

    Object Storage Service:Notificación de mensajes

    Última actualización: Sep 03, 2026

    Las solicitudes de procesamiento asíncrono solo devuelven un ID de tarea. Para obtener el resultado de una tarea tras completar el procesamiento de datos, agregue parámetros de notificación de mensajes a la solicitud de procesamiento.

    Notas de uso

    • La notificación de mensajes solo es compatible con el procesamiento asíncrono.

    • La notificación de mensajes solo admite temas de Simple Message Queue (SMQ). SMQ se conocía anteriormente como MNS. Para obtener más información sobre SMQ, consulte SMQ Quick Start.

    Descripción de parámetros

    Cuando utilice el parámetro notify, incluya la siguiente opción:

    Parámetro

    Obligatorio

    Descripción

    topic

    Sí

    Nombre del tema de SMQ.

    • El tema de SMQ debe estar en la misma región que el bucket.

    • El nombre del tema debe tener codificación Base64 segura para URL. Por ejemplo, un tema llamado test debe ingresarse como dGVzdA==. Use una herramienta de codificación Base64 URL para codificar el nombre.

    Para saber cómo obtener el nombre del tema de SMQ, consulte How do I view the name of my SMQ topic in the console?

    Uso de API REST

    Si su programa requiere un alto nivel de personalización, inicie directamente solicitudes de API REST. Para ello, escriba manualmente el código para calcular las firmas.

    Al llamar a la operación PostObject para procesar un objeto, pase el parámetro x-oss-async-process en el cuerpo de la solicitud. Luego, agregue el parámetro notify a la solicitud para recibir notificaciones de mensajes sobre los resultados. La notificación de mensajes solo admite temas de SMQ. Para obtener más información sobre el uso de SMQ, consulte Python SDK version guide.

    A continuación se proporcionan ejemplos de recepción de notificaciones de mensajes de SMQ en diferentes escenarios.

    Uso de parámetros de procesamiento para convertir un documento y recibir notificaciones de mensajes de SMQ

    Información de conversión

    • Antes de la conversión

      • Tipo de archivo: DOCX

      • Nombre del archivo: example.docx

    • Después de la conversión

      • Tipo de archivo: PNG

      • Ruta de almacenamiento: oss://test-bucket/doc_images/

    • Notificación de mensajes

      La notificación del resultado de la conversión se envía al tema de SMQ llamado test-topic.

    Ejemplo de procesamiento

    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_dGVzdC10b3BpYw

    Uso de parámetros de estilo para transcodificar un video y guardarlo en un bucket específico

    Información de transcodificación

    • Antes de la transcodificación

      • Formato de video: AVI

      • Nombre del video: example.avi

    • Después de la transcodificación

      • Formato de video: MP4

      • Nombre del video: outobjprefix.mp4

      • Ruta de almacenamiento: oss://outbucket/outobjprefix.mp4

    • Notificación de mensajes

      La notificación del resultado de la transcodificación se envía al tema de SMQ llamado 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_dGVzdC10b3BpYw

      Formatos de mensaje para operaciones x-oss-process

      Módulo de función

      Operación x-oss-process

      Formato de mensaje

      Procesamiento de documentos

      doc/convert

      Sample MNS message for the CreateOfficeConversionTask operation

      ApsaraVideo Media Processing

      Sample MNS message for the CreateMediaConvertTask operation

      Procesamiento de archivos

      pointcloud/compress

      Sample MNS message for the CreateCompressPointCloudTask operation

      Procesamiento de imágenes

      image/deblindwatermark

      Sample MNS message for the CreateDecodeBlindWatermarkTask operation

      Preguntas frecuentes

      ¿Cómo consulto el nombre de mi tema de SMQ en la consola?

      Para configurar un tema de Simple Message Queue (SMQ) para notificaciones de eventos de OSS, use un tema que esté en la misma región que su bucket de OSS. Siga estos pasos para encontrar el nombre de un tema de SMQ. SMQ se conocía anteriormente como MNS.

      1. Inicie sesión en la consola de Simple Message Queue (SMQ), anteriormente MNS.

      2. En la barra de navegación superior de la consola, asegúrese de seleccionar la misma región que su bucket de OSS.

      3. En el panel de navegación izquierdo, haga clic en Topic-based Model > Topic List para consultar todos los temas creados en la región actual.

      4. Revise la lista de temas para encontrar el nombre del tema que desea usar en la configuración de notificaciones de eventos de OSS.

      Con estos pasos encontrará el nombre del tema de SMQ en la misma región que su bucket de OSS. Usar el nombre de tema correcto garantiza que los eventos de OSS se envíen a la cola de mensajes para su procesamiento.