Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Operações em carregamento de multiparte/ Listagem das partes carregadas de um objeto

Atualizado em 2022-11-14 GMT+08:00

Ver PDF

Listagem das partes carregadas de um objeto

Funções

Você pode executar essa operação para consultar todas as partes associadas a um carregamento de multiparte. O tamanho de cada parte listada por esta API é o mesmo que o tamanho da parte carregada.

Sintaxe da solicitação

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 solicitação

Essa solicitação usa parâmetros para especificar quais partes em um carregamento de multiparte serão listadas. Tabela 1 descreve os parâmetros.

**Tabela 1** Parâmetros de solicitação
Parâmetro	Descrição	Obrigatório
uploadId	Indica um ID de carregamento de multiparte. Tipo: string Valor padrão: none	Sim
max-parts	Especifica o número máximo de partes a serem listadas. Tipo: string Valor padrão: 1000.	Não
part-number -marcador	Indica a parte após a qual a listagem de partes começa. O OBS lista somente as partes com números maiores do que os especificados por este parâmetro. Tipo: string Valor padrão: none	Não
encoding-type	Codifica a chave na resposta com base no tipo especificado. Se a chave contiver caracteres de controle que não são suportados pelo padrão XML 1.0, você poderá definir o tipo de codificação para codificar a chave em resposta. Tipo: string Valor padrão: none Valor opcional: url	Não

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

    
     
       
       
         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>

        

      

    
   

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Esta resposta usa elementos para retornar informações sobre partes carregadas. Tabela 2 descreve os elementos.

**Tabela 2** Elementos de resposta
Elemento	Descrição
ListPartsResult	Indica o contêiner para respostas às solicitações de partes da lista. Tipo: container Crianças: Bucket, Chave, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, ÉTruncado, Parte Antepassado: nenhum
Bucket	Indica o nome de um bucket. Tipo: string Antepassado: ListPartsResult
EncodingType	Tipo de codificação de uma chave de objeto. Se encoding-type é especificado no pedido, a chave na resposta é codificado. Tipo: string Antepassado: ListPartsResult
Key	Indica um nome de objeto. Tipo: string Antepassado: ListPartsResult
UploadId	Indica o ID de um carregamento de multiparte. Tipo: string Antepassado: ListPartsResult
Initiator	Indica o iniciador de um carregamento de multiparte. Tipo: container Indica o ID do subnó. Antepassado: ListPartsResult
Owner	O valor deste parâmetro é o mesmo do Initiator. Tipo: container Crianças: ID Antepassado: ListPartsResult
ID	ID do domínio ao qual o proprietário pertence Tipo: string Antepassado: Initiator or Owner
StorageClass	Indica o tipo de armazenamento. Tipo: enumeração Opções de valor: STANDARD \| WARM \| COLD Antepassado: ListPartsResult
PartNumberMarker	Número da parte após o qual a listagem de partes começa. Tipo: integer Antepassado: ListPartsResult
NextPartNumberMarker	Indica o valor de PartNumberMarker na próxima solicitação quando o resultado retornado estiver incompleto. Tipo: integer Antepassado: ListPartsResult
MaxParts	Número máximo de partes retornadas em uma resposta Tipo: integer Antepassado: ListPartsResult
IsTruncated	Indica se a lista de partes retornada está truncada. O valor true indica que a lista foi truncada e false indica que a lista não foi truncada. Tipo: boolean Antepassado: ListPartsResult
Part	Indica o recipiente para elementos relacionados a uma parte específica. Tipo: string Crianças: PartNumber, ETag , Tamanho , LastModified Antepassado: ListPartsResult PartNumber identifica uma parte.
PartNumber	Número de uma parte carregada Tipo: integer Antepassado: ListPartsResult.Part
LastModified	Indica a data e a hora em que uma parte foi carregada. Tipo: data Antepassado: ListPartsResult.Part
ETag	Valor de ETag das partes carregadas. É o identificador exclusivo do conteúdo da parte e é utilizado para verificar a consistência dos dados durante a combinação de partes. Tipo: string Antepassado: ListPartsResult.Part
Size	Indica o tamanho de uma parte carregada. Tipo: integer Antepassado: ListPartsResult.Part

Respostas de erro

Se a AK ou assinatura for inválida, o OBS retornará 403 Forbidden e o código de erro será AccessDenied.
Se o intervalo solicitado não existir, o OBS retornará 404 Forbidden e o código de erro será NoSuchBucket.
Se a tarefa de carregamento de multiparte solicitada não existir, o OBS retornará 404 Not Found e o código de erro será NoSuchUpload.
O OBS determina se o ID de domínio do uso tem permissão de leitura para o intervalo especificado. Se o usuário não tiver a permissão, o OBS retornará 403 Forbidden e o código de erro será AccessDenied.

Para outros erros, veja Tabela 2.

Solicitação de exemplo

    
         GET /object02?carregamentoId=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=

Resposta de exemplo

    
     
       
       
         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>

        

      

    
   