Todos los productos
Search
Centro de documentos

Object Storage Service:listpart

Última actualización: Sep 03, 2026

Este tema describe cómo ejecutar el comando listpart para listar las partes de un objeto cuya tarea de carga multiparte está incompleta.

Notas de uso

  • Para listar las partes, debe contar con el permiso oss:ListParts. Para obtener más información, consulte Grant a custom policy.

  • En ossutil 1.6.16 y versiones posteriores, puede usar directamente ossutil como nombre del binario en la línea de comandos. No es necesario actualizar el nombre del binario según el sistema operativo. En versiones de ossutil anteriores a la 1.6.16, debe ajustar el nombre del binario según el sistema operativo. Para obtener más información, consulte ossutil command reference.

  • Para obtener más información sobre las cargas multiparte, consulte Multipart upload.

Sintaxis del comando

ossutil listpart oss://bucketname/objectname uploadid

A continuación se describen los parámetros anteriores.

Parámetro

Descripción

bucketname

Nombre del bucket donde se almacenan las partes que desea listar.

objectname

Nombre del objeto cuya tarea de carga multiparte está incompleta.

uploadid

ID de carga que identifica la tarea de carga multiparte. Este ID se devuelve al iniciar la tarea de carga multiparte. Puede usar el ID de carga para realizar operaciones de carga multiparte, como cancelar o consultar la tarea.

Importante

Puede usar la opción -m en el comando ls para consultar información de las partes, como el objeto cuya tarea de carga multiparte no se ha completado, la hora de inicio de la tarea y el ID de carga. Para obtener más información, consulte ls.

Ejemplos

Ejecute el siguiente comando para listar las partes del objeto exampleobject.txt cuya tarea de carga multiparte está incompleta en el bucket examplebucket:

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

El siguiente ejemplo de salida muestra información de las partes, incluido el número de partes, los ETags y el tamaño 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

Opciones comunes

Para acceder a un bucket en otra región, use -e para especificar el endpoint. Para acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, use -i para el AccessKey ID y -k para el AccessKey secret.

Por ejemplo, ejecute el siguiente comando para consultar las partes del objeto testobject.txt cuya tarea de carga multiparte está incompleta. El objeto testobject.txt se encuentra en el bucket testbucket, ubicado en la región China (Hangzhou) y propiedad de otra cuenta de Alibaba Cloud.

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

Common options.