Todos os produtos
Search
Central de documentação

Object Storage Service:synchronous processing

Última atualização: Sep 24, 2026

Especifique o campo x-oss-process para executar uma tarefa de processamento no modo síncrono. Nesse modo, um aplicativo só executa a próxima tarefa após a conclusão da tarefa atual. O processamento síncrono é ideal para tarefas que retornam resultados de forma eficiente, como processamento de imagens e documentos.

Operações que suportam processamento síncrono

Nota

Substitua o asterisco (*) no nome da operação descrita na tabela a seguir pelo parâmetro real de processamento de dados. Por exemplo, especifique x-oss-process=image/resize para redimensionar imagens.

Recurso

Operação

Referências

Métodos

Processamento de imagens

x-oss-process=image/*

IMG parameters

  • URL de arquivos

  • Alibaba Cloud SDK

  • APIs RESTful

Processamento de documentos

x-oss-process=doc/*

  • Alibaba Cloud SDK

  • APIs RESTful

Processamento de mídia

  • Vídeo: x-oss-process=video/*

  • Áudio: x-oss-process=audio/*

Inteligência de imagem (exceto decodificação de marcas d'água invisíveis)

x-oss-process=image/*

IMG parameters

Perguntas frequentes

Posso executar várias operações simultaneamente no modo síncrono?

  • Ao executar uma tarefa de processamento síncrono que permite o acesso anônimo, como o processamento de imagens, adicione vários parâmetros de processamento à URL para executar as operações simultaneamente.

    Redimensione a imagem e adicione marcas d'água usando a seguinte URL.

    https://examplebucket.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_300,h_300/watermark,image_cGFuZGEucG5n,t_90
  • Ao executar uma tarefa de processamento síncrono que não permite o acesso anônimo, como o processamento de documentos, use os SDKs do Object Storage Service (OSS) e adicione vários parâmetros de processamento para executar as operações simultaneamente.

    O código a seguir mostra um exemplo de como converter o formato e capturar um snapshot de um documento ao adicionar parâmetros e usar o OSS SDK for Java.

    getObjectRequest.setProcess("doc/convert,target_jpg,source_docx/snapshot,target_jpg,source_docx,page_2");

Referência

Para obter mais informações sobre como salve arquivos processados no OSS, consulte Salve como.