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.

Nesta página

Funções
Sintaxe da solicitação
Parâmetros de solicitação
Cabeçalhos de solicitação
Elementos de solicitação
Sintaxe da resposta
Cabeçalhos de resposta
Elementos de resposta
Respostas de erro
Solicitação de exemplo
Resposta de exemplo

Mostrar todos

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

Listagem das partes carregadas de um objeto

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

Ver PDF

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>

      

    
   

Tópico principal: Operações em carregamento de multiparte

Tópico anterior: Carregamento de uma parte de um objeto - copiar

Próximo tópico: Mescla das partes em um objeto completo

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar