Object Storage Service:variable

Casos de uso no Console

• Tarefas: Referencie informações do objeto de origem no caminho de saída de uma tarefa de processamento. Por exemplo, para converter um documento em imagens JPG, defina o caminho de saída como oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Durante o processamento, {autoext} é substituído por jpg. As imagens resultantes são salvas em oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg.

  Na caixa de diálogo Create Task, selecione doc_to_jpg em Style. Um aviso abaixo de Output Path indica que você deve inserir uma chave de objeto completa, que pode incluir variáveis, e que os caminhos de entrada e saída devem ser diferentes. Na seção Notification Configuration, selecione Message Queue. Após concluir as configurações, clique em OK.

• Processamento em lote: Ao criar um trabalho de processamento em lote, o sistema gera uma tarefa para cada objeto existente. Para evitar sobreposição de dados, recomendamos o uso de variáveis no caminho de saída. Por exemplo, para extrair quadros de um vídeo e salvá-los como imagens PNG, defina o caminho de saída como oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Durante o processamento, {autoext} é substituído por png. As imagens PNG geradas são salvas em oss://test-bucket/output/source-directory/source-filename/frame-number.png.

  Após configurar o caminho de saída na seção Output Configuration, certifique-se de que ele seja diferente do caminho de entrada caso utilize as variáveis key, barename ou basename. Essa precaução evita que o objeto de origem seja sobrescrito e previne a criação de loops infinitos. Na seção Permission Configuration, selecione AliyunIMMBatchTriggerRole (Default Role) em Service Role e clique em OK.

• Triggers: A criação de um trigger gera uma tarefa para cada novo objeto. Para evitar sobreposições, use variáveis no caminho de saída. Por exemplo, se um trigger de conversão de documentos for criado para converter arquivos em imagens JPG, defina o caminho de saída como oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Durante o processamento, {autoext} é substituído por jpg. As imagens JPG geradas são salvas em oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg.

  Caso utilize as variáveis de chave de objeto, barename ou basename, garanta que o caminho de saída difira do caminho de entrada para impedir a sobreposição de objetos. Na seção Permission Configuration, selecione AliyunIMMBatchTriggerRole (Default Role) em Service Role e clique em OK.

Casos de uso da API

• Salvar como (sys/saveas): Os parâmetros b (bucket) e o (objeto) da operação salvar como (sys/saveas) aceitam variáveis. Por exemplo, para converter as páginas 1 a 10 de um documento chamado example.docx em imagens PNG, defina o parâmetro sys/saveas como b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw. Nesse parâmetro, e2J1Y2tldH0 representa o valor codificado em Base64 de {bucket}, e ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw é o valor codificado em Base64 de doc_images/{index}.png. As imagens convertidas são então salvas no mesmo bucket do objeto de origem, no caminho doc_images/index.png.

• Tarefas: O caminho de saída das tarefas aceita variáveis. Por exemplo, ao chamar a operação CreateOfficeConversionTask para criar uma tarefa de conversão de documentos, defina o parâmetro TargetURI com o caminho completo de saída, incluindo a extensão. O TargetURI pode conter variáveis, como oss://test-bucket/output/{dirname}/{barename}/{index}.jpg.

Exemplo 1: Conversão de formato de documento

O exemplo de API RESTful a seguir demonstra como adicionar parâmetros de processamento a uma solicitação PostObject para converter o formato de example.docx. Os parâmetros b (bucket) e o (objeto) da operação salvar como (sys/saveas) usam variáveis.

• pages_MS0xMA: Converte as páginas 1 a 10 do documento. MS0xMA é o valor codificado em Base64 de "1-10".

• target_png: Converte o documento para o formato de imagem PNG.

• source_docx: Especifica que o tipo do objeto de origem é DOCX.

• sys/saveas: Salvar como.

  • b_e2J1Y2tldH0: Após a conclusão da transcodificação, a variável {bucket} salva as imagens resultantes no bucket de origem. e2J1Y2tldH0 é o valor codificado em Base64 de {bucket}.

  • o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw: Salva o objeto no diretório doc_images. A chave do objeto usa a variável {index}, que corresponde ao número da página de example.docx. ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw é o valor codificado em Base64 de doc_images/{index}.png.

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 pages 1 to 10 of the example.docx object to PNG images. The processed objects are saved to oss://source-bucket/doc_images/page-number.png.
x-oss-async-process=doc/convert,pages_MS0xMA,target_png,source_docx|sys/saveas,b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw

Exemplo 2: Transcodificação de vídeo

Este exemplo demonstra como transcodificar o objeto example.avi configurando múltiplos parâmetros de processamento.

• f_mp4: Define o contêiner do arquivo de mídia transcodificado como MP4.

• vcodec_h265: Define o formato do fluxo de vídeo como H.265.

• s_1920x1080: Define a resolução como 1920x1080.

• vb_2000000: Define a taxa de bits de vídeo como 2 Mbps.

• fps_30: Define a taxa de quadros de vídeo como 30 fps.

• acodec_aac: Define o formato de codificação de áudio como AAC.

• ab_100000: Define a taxa de bits de áudio como 100 Kbps.

• sn_1: Desativa o fluxo de legendas.

• sys/saveas: Salvar como.

  • b_e2J1Y2tldH0: Após a conclusão da transcodificação, o objeto resultante é salvo no bucket de origem usando a variável {bucket}. e2J1Y2tldH0 é o valor codificado em Base64 de {bucket}.

  • o_b3V0cHV0LnthdXRvZXh0fQ: A variável {autoext} adiciona automaticamente uma extensão ao objeto, resultando em um objeto salvo chamado output.mp4. b3V0cHV0LnthdXRvZXh0fQ é o valor codificado em Base64 de output.{autoext}.

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
x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_e2J1Y2tldH0,o_b3V0cHV0LnthdXRvZXh0fQ