Todos los productos
Search
Centro de documentos

Object Storage Service:list-multipart-uploads

Última actualización: Sep 22, 2026

Enumera todas las tareas de carga multiparte en curso.

Notas de uso

Las tareas de carga multiparte en curso son aquellas que se inicializaron, pero aún no se completaron ni cancelaron.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios o roles de RAM asociados a una cuenta de Alibaba Cloud no cuentan con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o el administrador de la cuenta debe otorgar los permisos de operación mediante RAM policies o Bucket Policy.

API

Acción

Descripción

ListMultipartUploads

oss:ListMultipartUploads

Enumera todos los eventos de carga multiparte en curso, es decir, aquellos que se inicializaron pero aún no se completaron ni cancelaron.

Sintaxis del comando

ossutil api list-multipart-uploads --bucket value [flags]
Nota
  • El comando list-multipart-uploads corresponde a la operación ListMultipartUploads. Para obtener más información sobre los parámetros de esta operación, consulte ListMultipartUploads.

Parámetro

Tipo

Descripción

--bucket

string

Nombre del bucket.

--delimiter

string

Carácter que se utiliza para agrupar objetos por nombre.

--encoding-type

string

Tipo de codificación de los nombres de objeto en la respuesta.

--max-uploads

int

Número máximo de tareas de carga multiparte que devuelve OSS.

--prefix

string

Prefijo que deben contener los nombres de los objetos devueltos.

--upload-id-marker

string

Identificador de carga de la tarea de carga multiparte a partir de la cual comienza el listado. Este parámetro se usa junto con el parámetro key-marker.

  • Si no se establece el parámetro key-marker, OSS ignora el parámetro upload-id-marker.

  • Si se establece el parámetro key-marker, el resultado de la consulta incluye:

    • Tareas de carga multiparte cuyos nombres de objeto van después del valor del parámetro key-marker en orden alfabético.

    • Tareas de carga multiparte cuyo nombre de objeto coincide con el valor del parámetro key-marker, pero cuyo identificador de carga es mayor que el valor del parámetro upload-id-marker.

--key-marker

string

Este parámetro se usa junto con el parámetro upload-id-marker para especificar la posición desde donde comienzan los resultados devueltos.

  • Si no se establece el parámetro upload-id-marker, OSS devuelve todas las tareas de carga multiparte cuyos nombres de objeto van después del valor del parámetro key-marker en orden alfabético.

  • Si se establece el parámetro upload-id-marker, la respuesta incluye a continuación estas tareas:

    • Tareas de carga multiparte cuyos nombres de objeto van después del valor del parámetro key-marker en orden alfabético.

    • Tareas de carga multiparte cuyo nombre de objeto coincide con el valor del parámetro key-marker, pero cuyo identificador de carga es mayor que el valor del parámetro upload-id-marker.

Nota

Para obtener más información sobre las opciones globales de línea de comandos compatibles, consulte Global command-line options.

Ejemplos

  • Enumere todas las tareas de carga multiparte en curso de un bucket llamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket
  • Enumere todas las tareas de carga multiparte en curso de un bucket llamado examplebucket y muestre los resultados en formato JSON.

    ossutil api list-multipart-uploads --bucket examplebucket --output-format json
  • Enumere todas las tareas de carga multiparte en curso de un bucket llamado examplebucket y muestre los resultados en formato YAML.

    ossutil api list-multipart-uploads --bucket examplebucket --output-format yaml
  • Enumere todas las tareas de carga multiparte en curso cuyos nombres contienen el prefijo dir en el bucket llamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --prefix dir
  • Enumere las primeras 100 tareas de carga multiparte en curso de un bucket llamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --max-uploads 100
  • Enumere todas las tareas de carga multiparte en curso del directorio raíz de un bucket llamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --delimiter /
  • Enumere todas las tareas de carga multiparte en curso cuyos nombres van después de test.txt en orden alfabético dentro de un bucket llamado examplebucket.

    ossutil api list-multipart-uploads --bucket examplebucket --key-marker test.txt
  • Enumere todas las tareas de carga multiparte en curso de un bucket llamado examplebucket y aplique codificación URL a los nombres de los objetos.

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