Todos os produtos
Search
Central de documentação

Object Storage Service:list-multipart-uploads

Última atualização: Sep 22, 2026

Lista todas as tarefas de upload multipart em andamento.

Observações de uso

As tarefas de upload multipart em andamento referem-se às tarefas inicializadas que ainda não foram concluídas e que você não cancelou.

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões totais. Os usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não possuem nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de RAM policies ou Bucket Policy.

API

Ação

Descrição

ListMultipartUploads

oss:ListMultipartUploads

Lista todos os eventos de upload multipart em andamento, ou seja, eventos de upload multipart que foram inicializados, mas ainda não foram 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 obter mais informações sobre os parâmetros da operação ListMultipartUploads, 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 a partir da qual a listagem começa. Use este parâmetro em conjunto com o parâmetro key-marker.

  • Caso não defina o parâmetro key-marker, o OSS ignora o parâmetro upload-id-marker.

  • Caso defina o parâmetro key-marker, o resultado da consulta inclui:

    • Tarefas de upload multipart nas quais os nomes dos objetos são alfabeticamente posteriores ao valor do parâmetro key-marker.

    • Tarefas de upload multipart nas quais os nomes dos objetos 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

Use este parâmetro em conjunto com o parâmetro upload-id-marker e especifique a posição a partir da qual os resultados retornados começam.

  • Caso não defina o parâmetro upload-id-marker, o OSS retorna todas as tarefas de upload multipart nas quais os nomes dos objetos são alfabeticamente posteriores ao valor do parâmetro key-marker.

  • Caso defina o parâmetro upload-id-marker, a resposta inclui as seguintes tarefas:

    • Tarefas de upload multipart nas quais os nomes dos objetos são alfabeticamente posteriores ao valor do parâmetro key-marker.

    • Tarefas de upload multipart nas quais os nomes dos objetos 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 obter mais informações sobre as opções globais de linha de comando suportadas, consulte Global command-line options.

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 contenham 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 sejam alfabeticamente posteriores a 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