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 cargas de varias partes iniciadas en un bucket
Actualización más reciente 2024-09-18 GMT+08:00
Ver PDF
Compartir

Listado de cargas de varias partes iniciadas 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 (excluido 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 solo 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

Codifica algunos elementos de la respuesta según el tipo especificado. Si Delimiter, KeyMarker, Prefix, NextKeyMarker y Key contienen caracteres de control que no son compatibles con el estándar XML 1.0, puede establecer el tipo de codificación para codificar Delimiter, KeyMarker, Prefix (incluido el prefijo en CommonPrefixes), NextKeyMarker y Key en respuesta.

Tipo: string

Opción de valor: url

No

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para obtener más información, véase Tabla 3.

Elementos de solicitud

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
 
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 información 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

Codifica algunos elementos de la respuesta según el tipo especificado. Si se especifica encoding-type en la solicitud, se codificarán Delimiter, KeyMarker, Prefix (incluido Prefix en CommonPrefixes), NextKeyMarker y Key en la respuesta.

Tipo: string

Antepasado: ListMultipartUploadsResult

KeyMarker

Claves de objeto en o después de las cuales comienza la 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 cuando 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. El valor true indica que la lista se truncó y false indica que la lista no se truncó.

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

Secundario: ID

Tipo: container

Antepasado: Upload

ID

ID de la cuenta a la que pertenece el propietario.

Tipo: string

Antepasado: Initiator u Owner

Owner

Propietario de la pieza.

Tipo: container

Secundario: ID

Antepasado: Upload

StorageClass

Indica la clase de almacenamiento que se utilizará para almacenar un objeto cuando se cargue la multiparte.

Tipo: string

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

Indica la información de grupo. 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.

Otros errores se incluyen en Tabla 2.

Ejemplo de solicitud: Listado de cargas multiparte iniciadas

1
2
3
4
5
6
 
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=

Ejemplo de respuesta: Listado de cargas multiparte iniciadas

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
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>

Ejemplo de solicitud: Listado de cargas multiparte iniciadas (con un prefijo y delimitador especificado)

En el siguiente ejemplo se describe cómo enumerar dos cargas multiparte iniciadas (con los objetos multipart-object001 y part2-key02 en el bucket examplebucket). En esta operación de enumeración, prefix se establece en multipart y object001 se establece en delimiter.

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=

Ejemplo de respuesta: Listado de cargas de varias partes iniciadas (con un prefijo y un delimitador especificado)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
 
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>