ListMultipartUploads - Object Storage Service - Centro de documentación de Alibaba Cloud

Enumera todas las tareas de carga multiparte en curso. Estas tareas no se han completado ni cancelado.

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 por defecto. 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 activos, es decir, aquellos que ya se inicializaron pero aún no se completaron ni cancelaron.

Sintaxis de la solicitud

Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Parámetros de la solicitud

Parámetro	Tipo	Descripción
delimiter	String	Carácter que se utiliza para agrupar objetos por nombre. Si especifica el parámetro Delimiter en la solicitud, la respuesta incluye el elemento CommonPrefixes. Los objetos cuyo nombre contiene la misma cadena entre el prefijo y la siguiente aparición del delimitador se agrupan como un único elemento de resultado dentro de CommonPrefixes.
max-uploads	Integer	Número máximo de tareas de carga multiparte que se pueden devolver en la solicitud actual. Valor predeterminado: 1000. Valor máximo: 1000.
key-marker	String	Este parámetro se usa junto con upload-id-marker para indicar la posición desde donde comienza la siguiente lista. Si no se configura el parámetro upload-id-marker, Object Storage Service (OSS) devuelve todas las tareas de carga multiparte cuyos nombres de objeto sean alfabéticamente posteriores al valor de key-marker. Si se configura el parámetro upload-id-marker, la respuesta incluye a continuación estas tareas: Tareas de carga multiparte cuyos nombres de objeto sean alfabéticamente posteriores al valor de key-marker. Tareas de carga multiparte cuyo nombre de objeto coincida con el valor de key-marker, pero cuyo ID de carga sea mayor que el valor de upload-id-marker.
prefix	String	Prefijo obligatorio en los nombres de los objetos devueltos. Si especifica un prefijo en la solicitud, este se incluye en la respuesta. Nota Los prefijos permiten agrupar y gestionar los objetos de los bucket de la misma manera en que se gestiona una carpeta en un sistema de archivos.
upload-id-marker	String	ID de carga de la tarea de carga multiparte a partir de la cual comienza la lista. Este parámetro se usa junto con key-marker. Si no se configura el parámetro key-marker, OSS ignora el parámetro upload-id-marker. Si se configura el parámetro key-marker, el resultado de la consulta incluye lo a continuación: Tareas de carga multiparte cuyos nombres de objeto sean alfabéticamente posteriores al valor de key-marker. Tareas de carga multiparte cuyo nombre de objeto coincida con el valor de key-marker, pero cuyo ID de carga sea mayor que el valor de upload-id-marker.
encoding-type	String	Tipo de codificación del nombre de objeto en la respuesta. Los valores de Delimiter, KeyMarker, Prefix, NextKeyMarker y Key admiten codificación UTF-8. Sin embargo, el estándar XML 1.0 no permite analizar sintácticamente caracteres de control, como aquellos cuyo valor en el Código Estándar Estadounidense para el Intercambio de Información (ASCII) va de 0 a 10. Configure el parámetro encoding-type para codificar los valores de Delimiter, KeyMarker, Prefix, NextKeyMarker y Key en la respuesta. Valor predeterminado: null

Elementos de la respuesta

Elemento	Tipo	Descripción
ListMultipartUploadsResult	Contenedor	Contenedor que almacena la respuesta a la solicitud ListMultipartUpload. Nodos secundarios: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated y Upload. Nodos primarios: Ninguna
Bucket	String	Nombre del bucket. Nodos primarios: ListMultipartUploadsResult
EncodingType	String	Método utilizado para codificar el nombre del objeto en la respuesta. Si se especifica encoding-type en la solicitud, los valores de elementos como Delimiter, KeyMarker, Prefix, NextKeyMarker y Key se codifican en el resultado devuelto. Nodos primarios: ListMultipartUploadsResult
KeyMarker	String	Nombre del objeto correspondiente a la tarea de carga multiparte a partir de la cual comienza la lista. Nodos primarios: ListMultipartUploadsResult
UploadIdMarker	String	ID de carga de la tarea de carga multiparte a partir de la cual comienza la lista. Nodos primarios: ListMultipartUploadsResult
NextKeyMarker	String	Marcador de nombre de objeto en la respuesta. Se utiliza en la siguiente solicitud para devolver los resultados restantes. Nodos primarios: ListMultipartUploadsResult
NextUploadMarker	String	Valor de NextUploadMarker que se emplea como UploadMarker en la siguiente solicitud cuando la respuesta no contiene todos los resultados requeridos. Nodos primarios: ListMultipartUploadsResult
MaxUploads	Integer	Número máximo de tareas de carga multiparte que devuelve OSS. Nodos primarios: ListMultipartUploadsResult
IsTruncated	Enumerated string	Indica si la lista de tareas de carga multiparte devuelta en la respuesta está truncada. Valor predeterminado: false. Valores válidos: true: en esta ocasión solo se devuelve una parte de los resultados. false: se devuelven todos los resultados. Nodos primarios: ListMultipartUploadsResult
Upload	Contenedor	Contenedor que almacena la información de las tareas de carga multiparte. Nodos secundarios: Key, UploadId e Initiated. Nodos primarios: ListMultipartUploadsResult
Key	String	Nombre del objeto para el cual se inició una tarea de carga multiparte. Nodos primarios: Upload Nota OSS ordena los resultados devueltos de forma ascendente según el nombre del objeto. Cuando existen varias tareas de carga multiparte iniciadas para el mismo objeto, estas se listan en orden ascendente por su ID de carga.
UploadId	String	ID de la tarea de carga multiparte. Nodos primarios: Upload
Initiated	Date	Hora en la que se inicializó la tarea de carga multiparte. Nodos primarios: Upload

Ejemplos

Solicitudes de ejemplo

Get /?uploads  HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respuestas de ejemplo

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c****
Date: Thu, 23 Feb 2012 06:14:27 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>oss-example</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>oss.avi</NextKeyMarker>
    <NextUploadIdMarker>0004B99B8E707874FC2D692FA5D77D3F</NextUploadIdMarker>
    <Delimiter></Delimiter>
    <Prefix></Prefix>
    <MaxUploads>1000</MaxUploads>
    <IsTruncated>false</IsTruncated>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>oss.avi</Key>
        <UploadId>0004B99B8E707874FC2D692FA5D7****</UploadId>
        <Initiated>2012-02-23T06:14:27.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

SDK de OSS

Puede usar los SDK de OSS para los a continuación lenguajes de programación con el fin de invocar la operación ListMultipartUploads:

ossutil

Para obtener información sobre el comando de ossutil equivalente a la operación ListMultipartUploads, consulte list-multipart-uploads.