Todos os produtos
Search
Central de documentação

Object Storage Service:list-multipart-uploads

Última atualização: Jul 03, 2026

Lista todas as tarefas de upload multipart em andamento.

Notas de uso

As tarefas de upload multipart em andamento são aquelas inicializadas, mas ainda não concluídas ou canceladas.

Permissões

Por padrão, uma conta da Alibaba Cloud tem permissões totais. Usuários do RAM ou funções do RAM vinculados a uma conta da Alibaba Cloud não têm nenhuma permissão por padrão. A conta da Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de políticas do RAM ou Bucket Policy.

API

Ação

Descrição

ListMultipartUploads

oss:ListMultipartUploads

Lista todos os eventos de upload multipart em andamento, ou seja, aqueles inicializados, mas ainda não concluídos ou abortados.

Sintaxe do comando

ossutil api list-multipart-uploads --bucket value [flags]
Nota
  • O comando list-multipart-uploads corresponde à operação ListMultipartUploads. Para mais informações sobre os parâmetros dessa operação, consulte ListMultipartUploads.

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

--delimiter

string

O caractere usado para agrupar objetos por nome.

--encoding-type

string

O tipo de codificação dos nomes dos objetos na resposta.

--max-uploads

int

O número máximo de tarefas de upload multipart retornadas pelo OSS.

--prefix

string

O prefixo que os nomes dos objetos retornados devem conter.

--upload-id-marker

string

O ID de upload da tarefa de upload multipart após a qual a listagem começa. Este parâmetro é usado junto com o parâmetro key-marker.

  • Se o parâmetro key-marker não for definido, o OSS ignora o parâmetro upload-id-marker.

  • Se o parâmetro key-marker for definido, o resultado da consulta inclui:

    • Tarefas de upload multipart cujos nomes de objeto estão alfabeticamente após o valor do parâmetro key-marker.

    • Tarefas de upload multipart cujos nomes de objeto são iguais ao valor do parâmetro key-marker, mas cujos IDs de upload são maiores que o valor do parâmetro upload-id-marker.

--key-marker

string

Este parâmetro é usado junto com o parâmetro upload-id-marker para especifique a posição a partir da qual os resultados retornados começam.

  • Se o parâmetro upload-id-marker não for definido, o OSS retorna todas as tarefas de upload multipart cujos nomes de objeto estão alfabeticamente após o valor do parâmetro key-marker.

  • Se o parâmetro upload-id-marker for definido, a resposta inclui as seguintes tarefas:

    • Tarefas de upload multipart cujos nomes de objeto estão alfabeticamente após o valor do parâmetro key-marker.

    • Tarefas de upload multipart cujos nomes de objeto são iguais ao valor do parâmetro key-marker, mas cujos IDs de upload são maiores que o valor do parâmetro upload-id-marker.

Nota

Para mais informações sobre as opções globais de linha de comando suportadas, consulte Opções globais de linha de comando.

Exemplos

  • Liste todas as tarefas de upload multipart em andamento em um bucket chamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket
  • Liste todas as tarefas de upload multipart em andamento em um bucket chamado examplebucket e exiba os resultados da lista no formato JSON.

    ossutil api list-multipart-uploads --bucket examplebucket --output-format json
  • Liste todas as tarefas de upload multipart em andamento em um bucket chamado examplebucket e exiba os resultados da lista no formato YAML.

    ossutil api list-multipart-uploads --bucket examplebucket --output-format yaml
  • Liste todas as tarefas de upload multipart em andamento cujos nomes contêm o prefixo dir no bucket chamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --prefix dir
  • Liste as primeiras 100 tarefas de upload multipart em andamento em um bucket chamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --max-uploads 100
  • Liste todas as tarefas de upload multipart em andamento no diretório raiz de um bucket chamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --delimiter /
  • Liste todas as tarefas de upload multipart em andamento cujos nomes estão alfabeticamente após test.txt em um bucket chamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --key-marker test.txt
  • Liste todas as tarefas de upload multipart em andamento em um bucket chamado examplebucket e codifique os nomes dos objetos em URL.

    ossutil api list-multipart-uploads --bucket examplebucket --encoding-type url