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.

En esta página

Funciones
Sintaxis de solicitud
Parámetros de solicitud
Encabezados de solicitud
Elementos de solicitud
Sintaxis de respuesta
Encabezados de respuesta
Elementos de respuesta
Respuestas de error
Ejemplo de solicitud: Listado de cargas multiparte iniciadas
Ejemplo de respuesta: Listado de cargas multiparte iniciadas
Ejemplo de solicitud: Listado de cargas multiparte iniciadas (con un prefijo y delimitador especificado)
Ejemplo de respuesta: Listado de cargas de varias partes iniciadas (con un prefijo y un delimitador especificado)

Mostrar todo

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

Listado de cargas de varias partes iniciadas en un bucket

Actualización más reciente 2024-09-18 GMT+08:00

Ver PDF

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

    
     
       
       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

    
       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

    
     
       
       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)

    
     
       
       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>

      

    
   

Tema principal: Operaciones en carga multiparte

Tema anterior: Operaciones en carga multiparte

Tema siguiente: Inicio de una carga multiparte

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar