Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Operaciones en carga multiparte/ Listado de tareas multiparte inicializadas en un bucket

Actualización más reciente 2023-07-11 GMT+08:00

Ver PDF

Listado de tareas multiparte inicializadas en un bucket

Funciones

Esta operación consulta todas las tareas de carga de varias partes que se inicializan pero que no se han combinado o cancelado en un bucket.

Sintaxis de solicitud

GET /?uploads&max-uploads=max HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization

Parámetros de solicitud

Esta solicitud utiliza parámetros para especificar el intervalo de consultas para las cargas de varias partes. Tabla 1 describe los parámetros.

**Tabla 1** Parámetros de solicitud
Parámetro	Descripción	Obligatorio
Delimitador	Para una carga multiparte que contiene delimitadores, la string entre el primer carácter y el primer delimitador en el nombre del objeto (excluyendo el prefijo especificado en la solicitud, si lo hay) se devuelve como "CommonPrefix". Las cargas de varias partes con objetos que contienen CommonPrefix se consideran como un grupo y se devuelven como un registro. El registro no contiene información sobre las tareas, solo informa al usuario de que el grupo implica cargas de varias partes. Tipo: string	No
prefix	Si se especifica un prefijo, la respuesta sólo contiene tareas cuyos nombres comienzan con el valor del prefijo. Tipo: string	No
max-uploads	Número máximo de tareas de carga de varias partes devueltas. El valor está entre 1 y 1000. Si el valor ha superado este intervalo, se devuelven 1000 tareas de forma predeterminada. Tipo: integer	No
key-marker	Enumera las cargas de varias partes que siguen el valor de key-marker. Tipo: string	No
upload-id-marker	Enumera las tareas de varias partes que siguen el valor de upload-id-marker en key-marker. Este parámetro solo funciona junto con key-marker. Tipo: string	No
encoding-type	Encodes some elements in the response based on the specified type. If Delimiter, KeyMarker, Prefix, NextKeyMarker, and Key contain control characters that are not supported by the XML 1.0 standard, you can set encoding-type to encode Delimiter, KeyMarker, Prefix (including the Prefix in CommonPrefixes), NextKeyMarker, and Key in response. Type: string Optional value: url	No

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 3.

Elementos de solicitud.

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

    
     
       
       
         HTTP/1.1 status_code
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ListMultipartUploadsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Bucket>bucketname</Bucket> 
    <KeyMarker/> 
    <UploadIdMarker/> 
    <NextKeyMarker>nextMarker</NextKeyMarker> 
    <NextUploadIdMarker>idMarker</NextUploadIdMarker> 
    <MaxUploads>maxUploads</MaxUploads> 
    <IsTruncated>true</IsTruncated> 
    <Upload> 
        <Key>key</Key> 
        <UploadId>uploadID</UploadId> 
        <Initiator> 
            <ID>domainID/domainID:userID/userID</ID> 
        </Initiator> 
        <Owner> 
            <ID>ownerID</ID>
        </Owner> 
        <StorageClass>storageclass</StorageClass> 
        <Initiated>initiatedDate</Initiated>  
    </Upload> 
</ListMultipartUploadsResult>

        

      

    
   

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta contiene elementos de inentrenamiento sobre las cargas de varias partes. Tabla 2 describe los elementos.

**Tabla 2** Elementos de respuesta
Elemento	Descripción
ListMultipartUploadsResult	Contenedor para respuestas de solicitudes. Tipo: container Hijos: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, Upload, CommonPrefixes, IsTruncated Antepasado: ninguno
Bucket	Nombre del bucket en el que se inició la carga de varias partes Tipo: string Antepasado: ListMultipartUploadsResult
EncodingType	Encodes some elements in the response based on the specified type. If encoding-type is specified in the request, Delimiter, KeyMarker, Prefix (including the Prefix in CommonPrefixes), NextKeyMarker, and Key in the response will be encoded. Type: string Parent node: ListMultipartUploadsResult
KeyMarker	Claves de objeto en o después de las cuales comienza el enumeración de carga de varias partes Tipo: string Antepasado: ListMultipartUploadsResult
UploadIdMarker	ID de carga después del cual comienza la enumeración de carga de varias partes Tipo: string Antepasado: ListMultipartUploadsResult
NextKeyMarker	Valor de KeyMarker en una solicitud posterior después de que se trunca una lista de carga de varias partes Tipo: string Antepasado: ListMultipartUploadsResult
NextUploadIdMarker	Valor de UploadMarker en una solicitud posterior después de que se trunca una lista de carga de varias partes Tipo: string Antepasado: ListMultipartUploadsResult
MaxUploads	Máximo de cargas de varias partes que se devolverán en la respuesta Tipo: integer Antepasado: ListMultipartUploadsResult
IsTruncated	Indica si la lista de subidas de varias partes devueltas está truncada. true: no se devuelven todos los resultados. false: se han devuelto todos los resultados. Tipo: boolean Antepasado: ListMultipartUploadsResult
Upload	Contenedor para elementos relacionados con una carga multiparte específica Tipo: container Hijos: Key, UploadId, InitiatorOwner, StorageClass, Initiated Antepasado: ListMultipartUploadsResult
Key	Indica el nombre del objeto para el que se inicia una carga de varias partes. Tipo: string Antepasado: Upload
UploadId	ID de la carga multiparte Tipo: string Antepasado: Upload
Initiator	Elemento del contenedor que identifica quién inició la carga multiparte ID de los nodos secundarios. Tipo: container Antepasado: Upload
ID	ID de la cuenta a la que pertenece el propietario. Tipo: string Antepasado: Initiator, Owner
Owner	Propietario de la pieza. Tipo: container Indica el ID del subnodo. Antepasado: Upload
StorageClass	Indica la clase de almacenamiento que se utilizará para almacenar un objeto cuando se cargue la multiparte. Tipo: Enumeration Antepasado: Upload
Initiated	Fecha y hora en que se inició la carga multiparte Tipo: date Antepasado: Upload
ListMultipartUploadsResult.Prefix	Prefijo especificado en una solicitud. Tipo: string Antepasado: ListMultipartUploadsResult
Delimiter	Delimitador en una solicitud. Tipo: string Antepasado: ListMultipartUploadsResult
CommonPrefixes	Indicates group information. Si especifica un delimitador en la solicitud, la respuesta contiene información de grupo de CommonPrefixes. Tipo: container Antepasado: ListMultipartUploadsResult
CommonPrefixes. Prefix	Indica un prefijo diferente en la información de grupo de CommonPrefixes. Tipo: string Antepasado: CommonPrefixes

Respuestas de error

Si el valor de maxUploads es un no entero o menor que 0, OBS devuelve 400 Bad Request.

Para otros errores, consulte Tabla 2.

Muestra de solicitud 1

Enumerar las tareas multiparte inicializadas sin ningún parámetro.

    
         GET /?uploads HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=

Muestra de respuesta 1

    
     
       
       
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D405534D046A2295674C
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSDaHP+a+Bp0RI6Mm9XvCOrf7q3qvBQW
Content-Type: application/xml
Date: WED, 01 Jul 2015 04:51:21 GMT
Content-Length: 681

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListMultipartUploadsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Bucket>examplebucket</Bucket>
  <KeyMarker/>
  <UploadIdMarker/>
  <Delimiter/>
  <Prefix/>
  <MaxUploads>1000</MaxUploads>
  <IsTruncated>false</IsTruncated>
  <Upload>
    <Key>obj2</Key>
    <UploadId>00000163D40171ED8DF4050919BD02B8</UploadId>
    <Initiator>
      <ID>domainID/b4bf1b36d9ca43d984fbcb9491b6fce9:userID/71f390117351534r88115ea2c26d1999</ID>
    </Initiator>
    <Owner>
      <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2015-07-01T02:30:54.582Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>

        

      

    
   

Muestra de solicitud 2

Enumere las tareas multiparte inicializadas con el prefijo y el delimitador.

En el ejemplo siguiente se describe cómo enumerar tareas multiparte inicializadas cuando hay dos tareas multiparte en el bucket examplebucket, y sus nombres de objeto son multipart-object001 y part2-key02. Establezca prefix en multipart y establezca delimiter en object001.

GET /?uploads&delimiter=object001&prefix=multipart HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=

Muestra de respuesta 2

    
     
       
       
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 5DEB00000164A27A1610B8250790D703
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSq3ls2ZtLDD6pQLcJq1yGITXgspSvBR
Content-Type: application/xml
Date: WED, 01 Jul 2015 04:51:21 GMT
Content-Length: 681
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListMultipartUploadsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Bucket>newbucket0001</Bucket>
  <KeyMarker></KeyMarker>
  <UploadIdMarker>
  </UploadIdMarker>
  <Delimiter>object</Delimiter>
  <Prefix>multipart</Prefix>
  <MaxUploads>1000</MaxUploads>
  <IsTruncated>false</IsTruncated>
  <CommonPrefixes>
    <Prefix>multipart-object001</Prefix>
  </CommonPrefixes>
</ListMultipartUploadsResult>

        

      

    
   