Todos os produtos
Search

Este produto

    Object Storage Service:Notificação de mensagens

    Central de documentação

    Object Storage Service:Notificação de mensagens

    Última atualização: Jul 03, 2026

    Solicitações de processamento assíncrono retornam apenas um ID de tarefa. Para obter o resultado após a conclusão do processamento de dados, adicione os parâmetros de notificação de mensagens à solicitação.

    Observações de uso

    • A notificação de mensagens tem suporte apenas para processamento assíncrono.

    • Esse recurso aceita exclusivamente tópicos do Simple Message Queue (SMQ), anteriormente conhecido como MNS. Para mais informações sobre o SMQ, consulte Guia de início rápido do SMQ.

    Descrição dos parâmetros

    Ao usar o parâmetro notify, inclua a seguinte opção:

    Parâmetro

    Obrigatório

    Descrição

    topic

    Sim

    Nome do tópico SMQ.

    • O tópico SMQ deve estar na mesma região do bucket.

    • Codifique o nome do tópico em Base64 seguro para URL. Por exemplo, insira um tópico chamado test como dGVzdA==. Use uma ferramenta de codificação Base64 URL para codificar o nome.

    Para saber como obter o nome do tópico SMQ, consulte Como visualizo o nome do meu tópico SMQ no console?

    Uso de APIs REST

    Se seu programa exigir alto nível de personalização, inicie diretamente solicitações de API REST. Para isso, escreva manualmente o código necessário para calcular as assinaturas.

    Ao chamar a operação PostObject para processar um objeto, passe o parâmetro x-oss-async-process no corpo da solicitação. Em seguida, adicione o parâmetro notify à solicitação para receber notificações de mensagens sobre os resultados. A notificação de mensagens aceita apenas tópicos SMQ. Para mais detalhes sobre o uso do SMQ, consulte Guia de versão do SDK Python.

    As seções a seguir apresentam exemplos de recebimento de notificações de mensagens SMQ em diferentes cenários.

    Conversão de documentos com parâmetros de processamento e recebimento de notificações SMQ

    Informações da conversão

    • Antes da conversão

      • Tipo de arquivo: DOCX

      • Nome do arquivo: example.docx

    • Após a conversão

      • Tipo de arquivo: PNG

      • Caminho de armazenamento: oss://test-bucket/doc_images/

    • Notificação de mensagens

      O sistema envia a notificação do resultado da conversão para o tópico SMQ denominado test-topic.

    Exemplo de processamento

    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

    Transcodificação de vídeo com parâmetros de estilo e salvamento em bucket específico

    Informações da transcodificação

    • Antes da transcodificação

      • Formato do vídeo: AVI

      • Nome do vídeo: example.avi

    • Após a transcodificação

      • Formato do vídeo: MP4

      • Nome do vídeo: outobjprefix.mp4

      • Caminho de armazenamento: oss://outbucket/outobjprefix.mp4

    • Notificação de mensagens

      O sistema envia a notificação do resultado da transcodificação para o tópico SMQ chamado 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 mensagem para operações x-oss-process

    Módulo de recurso

    Operação x-oss-process

    Formato da mensagem

    Processamento de documentos

    doc/convert

    Exemplo de mensagem MNS para a operação CreateOfficeConversionTask

    ApsaraVideo Media Processing

    Exemplo de mensagem MNS para a operação CreateMediaConvertTask

    Processamento de arquivos

    pointcloud/compress

    Exemplo de mensagem MNS para a operação CreateCompressPointCloudTask

    Processamento de imagens

    image/deblindwatermark

    Exemplo de mensagem MNS para a operação CreateDecodeBlindWatermarkTask

    Perguntas frequentes

    Como visualizo o nome do meu tópico SMQ no console?

    Para configurar um tópico do Simple Message Queue (SMQ) para notificações de eventos do OSS, use um tópico localizado na mesma região do seu bucket OSS. Siga estas etapas para localizar o nome de um tópico SMQ (antigo MNS).

    1. Faça login no console do Simple Message Queue (SMQ), antigo MNS.

    2. Na barra de navegação superior do console, confirme se a região selecionada corresponde à do seu bucket OSS.

    3. No painel de navegação à esquerda, clique em Topic-based Model > Topic List para visualizar todos os tópicos criados na região atual.

    4. Percorra a lista de tópicos para identificar o nome daquele que deseja usar na configuração de notificação de eventos do OSS.

    Essas etapas permitem encontrar o nome do tópico SMQ na mesma região do seu bucket OSS. O uso do nome correto garante que os eventos do OSS sejam enviados à fila de mensagens para processamento.