Todos os produtos
Search
Central de documentação

Object Storage Service:listpart

Última atualização: Sep 22, 2026

Este tópico descreve como executar o comando listpart para listar as partes de um objeto cuja tarefa de upload multipart está incompleta.

Observações de uso

  • Para listar as partes, é necessário ter a permissão oss:ListParts. Para mais informações, consulte Grant a custom policy.

  • Para o ossutil 1.6.16 e versões posteriores, use diretamente ossutil como o nome do binário na linha de comando, sem precisar atualizar o nome com base no sistema operacional. Já para versões do ossutil anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte ossutil command reference.

  • Para mais informações sobre uploads multipart, consulte Multipart upload.

Sintaxe do comando

ossutil listpart oss://bucketname/objectname uploadid

A tabela a seguir descreve esses parâmetros.

Parâmetro

Descrição

bucketname

O nome do bucket que armazena as partes que você deseja listar.

objectname

O nome do objeto cuja tarefa de upload multipart está incompleta.

uploadid

O ID de upload que identifica a tarefa de upload multipart. O sistema retorna esse ID quando você inicia a tarefa. Use o ID de upload para executar operações de upload multipart: consulte o status ou cancele a tarefa.

Importante

Use a opção -m no comando ls para consultar informações das partes, como o objeto cuja tarefa de upload multipart não foi concluída, o horário de início da tarefa e o ID de upload. Para mais informações, consulte ls.

Exemplos

Execute o comando a seguir para listar as partes do objeto exampleobject.txt cuja tarefa de upload multipart está incompleta no bucket examplebucket:

ossutil listpart oss://examplebucket/exampleobject.txt 89A46B10E94A4ED5A7E9869F9409****

A saída de exemplo a seguir mostra informações das partes, incluindo a quantidade de partes, ETags e o tamanho de cada parte.

PartNumber      Etag                                    Size(Byte)      LastModifyTime
2               "BD106FED29B349A635BE289746DB****"      4443891         2021-07-21 09:01:33
3               "25DA5C7BB933DBD732B6C11111EB****"      4443891         2021-07-21 09:01:31
4               "AFDA91A8D4F476BAC972306873A3****"      4443891         2021-07-21 09:01:31
11              "2FFEE8D5049AB059D7EC801927BB****"      4443891         2021-07-21 09:01:32

total part count:4      total part size(MB):16.95

0.101978(s) elapsed

Opções comuns

Para acessar um bucket em uma região diferente, use -e e especifique o endpoint. Para acessar um bucket pertencente a outra conta Alibaba Cloud, use -i para o AccessKey (AccessKeyID) e -k para o AccessKeySecret.

Por exemplo, execute o comando a seguir para consultar as partes do objeto testobject.txt cuja tarefa de upload multipart está incompleta. O objeto testobject.txt está no bucket testbucket, localizado na região china (Hangzhou) e pertencente a outra conta Alibaba Cloud.

ossutil listpart oss://testbucket/testobject.txt 46C56B10E94A4ED6G8U9869F9409**** -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.