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/ Enumeración de piezas cargadas

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

Ver PDF

Enumeración de piezas cargadas

Funciones

Puede realizar esta operación para consultar todas las piezas asociadas a una carga de varias piezas. El tamaño de cada parte listada por esta API es el mismo que el tamaño de la parte cargada.

Sintaxis de solicitud

GET /ObjectName?uploadId=uploadid&max-parts=max&part-number-marker=marker HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date 
Authorization: auth

Parámetros de solicitud

Esta solicitud utiliza parámetros para especificar qué partes de una carga de varias partes se listarán. Tabla 1 describe los parámetros.

**Tabla 1** Parámetros de solicitud
Parámetro	Descripción	Obligatorio
uploadId	ID de la carga multiparte Tipo: string Valor predeterminado: ninguno	Sí
max-parts	Número máximo de piezas que se pueden enumerar Tipo: integer Valor predeterminado: 1,000	No
part-number -marker	Parte después de la cual comienza la enumeración de piezas. OBS enumera solo las piezas con números mayores que el especificado por este parámetro. Tipo: integer Valor predeterminado: ninguno	No
encoding-type	Tipo de codificación para la clave en la respuesta. Si la clave contiene caracteres de control que no son compatibles con el estándar XML 1.0, puede establecer el tipo de codificación para codificar la clave en respuesta. Tipo: string Valor predeterminado: ninguno 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"?> 
<ListPartsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
    <Bucket>BucketName</Bucket> 
    <Key>object</Key> 
    <UploadId>uploadid</UploadId> 
    <Initiator> 
        <ID>id</ID>  
    </Initiator> 
    <Owner> 
        <ID>ownerid</ID> 
    </Owner> 
    <StorageClass>storageclass</StorageClass> 
    <PartNumberMarker>partNmebermarker</PartNumberMarker> 
    <NextPartNumberMarker>nextPartnumberMarker</NextPartNumberMarker> 
    <MaxParts>maxParts</MaxParts> 
    <IsTruncated>true</IsTruncated> 
    <Part> 
        <PartNumber>partNumber</PartNumber> 
        <LastModified>modifiedDate</LastModified> 
        <ETag>etag</ETag> 
        <Size>size</Size> 
    </Part> 
</ListPartsResult>

        

      

    
   

Encabezados de respuesta

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

Elementos de respuesta

Esta respuesta utiliza elementos para devolver información sobre las piezas cargadas. Tabla 2 describe los elementos.

**Tabla 2** Elementos de respuesta
Elemento	Descripción
ListPartsResult	Contenedor para respuestas a solicitudes de enumeración de piezas Tipo: container Secundarios: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part Antepasado: ninguno
Bucket	Nombre del bucket Tipo: string Antepasado: ListPartsResult
EncodingType	Tipo de codificación de una clave de objeto. Si se especifica encoding-type en la solicitud, se codifica la clave de la respuesta. Tipo: string Antepasado: ListPartsResult
Key	Nombre del objeto Tipo: string Antepasado: ListPartsResult
UploadId	ID of the multipart upload Tipo: string Antepasado: ListPartsResult
Initiator	Iniciador de la carga multiparte Tipo: container Secundario: ID Antepasado: ListPartsResult
Owner	El valor de este parámetro es el mismo que el de Initiator. Tipo: container Secundario: ID Antepasado: ListPartsResult
ID	ID del dominio al que pertenece el propietario Tipo: string Antepasado: Initiator u Owner
StorageClass	Clase de almacenamiento Tipo: string Opciones de valor: STANDARD, WARM, COLD Antepasado: ListPartsResult
PartNumberMarker	Número de pieza después del cual comienza la enumeración de piezas Tipo: integer Antepasado: ListPartsResult
NextPartNumberMarker	Valor de PartNumberMarker en la siguiente solicitud cuando el resultado devuelto está incompleto Tipo: integer Antepasado: ListPartsResult
MaxParts	Número máximo de piezas devueltas en una respuesta Tipo: integer Antepasado: ListPartsResult
IsTruncated	Si la lista de piezas devuelta está truncada. El valor true indica que la lista se truncó y false indica que la lista no se truncó. Tipo: boolean Antepasado: ListPartsResult
Part	Contenedor para elementos relacionados con una pieza en particular. Tipo: string Hijos: PartNumber, LastModified, ETag, Size Antepasado: ListPartsResult PartNumber identifica una pieza.
PartNumber	Número de una pieza cargada Tipo: integer Antepasado: ListPartsResult.Part
LastModified	Cuando se cargó una parte Tipo: date Antepasado: ListPartsResult.Part
ETag	Valor ETag de las piezas cargadas. Es el identificador único del contenido de la pieza y se utiliza para verificar la coherencia de los datos durante la combinación de piezas. Tipo: string Antepasado: ListPartsResult.Part
Size	Tamaño de una parte cargada Tipo: integer Antepasado: ListPartsResult.Part

Respuestas de error

Si la AK o la firma no son válidas, OBS devuelve 403 Forbidden y el código de error es AccessDenied.
Si no se encuentra el bucket solicitado, OBS devuelve 404 Not Found y el código de error es NoSuchBucket.
Si la tarea de carga multiparte solicitada no existe, OBS devuelve 404 Not Found y el código de error es NoSuchUpload.
OBS determina si el ID de dominio del uso tiene el permiso de lectura para el bucket especificado. Si el usuario no tiene el permiso, OBS devuelve 403 Forbidden y el código de error es AccessDenied.

Otros errores se incluyen en Tabla 2.

Modelo de solicitud

    
         GET /object02?uploadId=00000163D40171ED8DF4050919BD02B8 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 05:20:35 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:xkABdSrBPrz5yqzuZdJnK5oL/yU=

Ejemplo de respuesta

    
     
       
       
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D40C099A04EF4DD1BDD9
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSK71fr+hDnzB0JBvQC1B9+S12AWxC41
Content-Type: application/xml
Date: WED, 01 Jul 2015 05:20:35 GMT
Content-Length: 888

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Bucket>test333</Bucket>
  <Key>obj2</Key>
  <UploadId>00000163D40171ED8DF4050919BD02B8</UploadId>
  <Initiator>
    <ID>domainID/domainiddomainiddomainiddo000008:userID/useriduseriduseriduseridus000008</ID>
  </Initiator>
  <Owner>
    <ID>domainiddomainiddomainiddo000008</ID>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
  <PartNumberMarker>0</PartNumberMarker>
  <NextPartNumberMarker>2</NextPartNumberMarker>
  <MaxParts>1000</MaxParts>
  <IsTruncated>false</IsTruncated>
  <Part>
    <PartNumber>1</PartNumber>
    <LastModified>2018-06-06T07:39:32.522Z</LastModified>
    <ETag>"b026324c6904b2a9cb4b88d6d61c81d1"</ETag>
    <Size>2058462721</Size>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2018-06-06T07:41:03.344Z</LastModified>
    <ETag>"3b46eaf02d3b6b1206078bb86a7b7013"</ETag>
    <Size>4572</Size>
  </Part>
</ListPartsResult>

        

      

    
   