Todos os produtos
Search
Central de documentação

Object Storage Service:list-parts

Última atualização: Jul 03, 2026

O comando list-parts lista todas as partes enviadas associadas a um upload ID específico.

Observações de uso

  • O Object Storage Service (OSS) retorna os resultados ordenados em ordem crescente pelos números das partes.

  • Erros podem ocorrer durante a transmissão de rede. Não utilize os números das partes e os valores ETag dos resultados da operação ListParts para gerar a lista de partes enviadas.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm 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 políticas do RAM ou Bucket Policy.

API

Ação

Descrição

ListParts

oss:ListParts

Lista todas as partes enviadas com base em um upload ID.

Sintaxe do comando

ossutil api list-parts --bucket value --key value --upload-id value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--key

string

Caminho completo do objeto.

--encoding-type

string

Tipo de codificação do nome do objeto na resposta.

--max-parts

int

Número máximo de partes na resposta do OSS.

--part-number-marker

int

Posição inicial da listagem. Todas as partes com números superiores ao valor deste parâmetro serão listadas.

--upload-id

string

ID da tarefa de multipart upload.

Nota
  • O comando list-parts corresponde à operação ListParts. Para obter mais informações sobre os parâmetros da operação ListParts, consulte ListParts.

  • Para mais detalhes sobre as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.

Exemplos

  • Liste todas as partes enviadas no bucket examplebucket com nome exampleobject e Upload ID 123.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123
  • Liste todas as partes enviadas no bucket examplebucket com nome exampleobject e Upload ID 123 e exiba a saída no formato JSON.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format json
  • Liste todas as partes enviadas no bucket examplebucket com nome exampleobject e Upload ID 123 e exiba a saída no formato YAML.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format yaml
  • Liste as primeiras 100 partes no bucket examplebucket.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --max-parts 100
  • Liste todas as partes no bucket examplebucket e aplique codificação URL nos nomes dos objetos retornados.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --encoding-type url