ListParts - List uploaded parts by upload ID in OSS - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

Os resultados são classificados em ordem crescente pelo número da parte.
Crie a lista de partes com base nos números de parte e ETags registrados localmente, em vez de usar as respostas do ListParts. Partes podem ser sobrescritas acidentalmente, e erros de transmissão de rede podem causar discrepâncias nos dados. Se houver sobrescrita, exclua as partes desnecessárias antes de chamar o CompleteMultipartUpload. Sem registros locais, não é possível identificar as partes corretas ou verifique a integridade dos dados.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

Sintaxe da solicitação

Get  /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Cabeçalhos da solicitação

Todos os cabeçalhos em uma solicitação ListParts são cabeçalhos comuns de solicitação. Para mais informações, consulte Cabeçalhos comuns de solicitação.

Parâmetros da solicitação

Parâmetro	Tipo	Exemplo	Descrição
uploadId	String	0004B999EF5A239BB9138C6227D6****	ID da tarefa de upload multipart. Padrão: vazio.
max-parts	Integer	1000	Número máximo de partes a retornar. Valor padrão: 1000. Valor máximo: 1000.
part-number-marker	Integer	100	Lista as partes com números maiores que este valor. Padrão: vazio.
encoding-type	String	url	Tipo de codificação do nome do objeto na resposta. O XML 1.0 não analisa certos caracteres de controle, como aqueles com valores ASCII de 0 a 10. Defina este parâmetro para codificar nomes de objetos que contenham esses caracteres. Padrão: vazio. Valor válido: url.

Cabeçalhos da resposta

Todos os cabeçalhos na resposta a uma solicitação ListParts são cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
ListPartsResult	Container	N/A	Contêiner raiz da resposta ListParts. Nós filhos: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated e Part Nós pais: nenhum
Bucket	String	multipart_upload	Nome do bucket. Nós pais: ListPartsResult
EncodingType	String	url	Tipo de codificação do nome do objeto. Retornado quando encoding-type é especificado na solicitação. Nós pais: ListPartsResult
Key	String	multipart.data	Nome do objeto. Nós pais: ListPartsResult
UploadId	String	0004B999EF5A239BB9138C6227D69F95	ID da tarefa de upload. Nós pais: ListPartsResult
PartNumberMarker	Integer	10	Marcador de número de parte especificado na solicitação. As partes com números maiores que este valor são listadas. Nós pais: ListPartsResult
NextPartNumberMarker	Integer	5	Marcador a ser usado como part-number-marker na próxima solicitação quando os resultados forem truncados. Nós pais: ListPartsResult
MaxParts	Integer	1000	Número máximo de partes na resposta. Nós pais: ListPartsResult
IsTruncated	Enumerated string	false	Indica se a resposta foi truncada. true: há mais partes disponíveis. false: todas as partes foram retornadas. Valores válidos: true e false. Nós pais: ListPartsResult
Part	Container	N/A	Contêiner dos detalhes da parte. Nós filhos: PartNumber, LastModified, ETag e Size Nós pais: ListPartsResult
PartNumber	Integer	1	Número da parte. Nós pais: ListPartsResult.Part
LastModified	Date	2012-02-23T07:01:34.000Z	Hora em que a parte foi enviada. Nós pais: ListPartsResult.Part
ETag	String	3349DC700140D7F86A0784842780****	ETag da parte enviada. Nós pais: ListPartsResult.Part
Size	Integer	6291456	Tamanho da parte enviada. Nós pais: ListPartsResult.Part

Exemplos

Solicitação de exemplo

Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D6****  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Resposta de sucesso de exemplo

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>multipart_upload</Bucket>
    <Key>multipart.data</Key>
    <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
    <NextPartNumberMarker>5</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>"7265F4D211B56873A381D321F586****"</ETag>
        <Size>1024</Size>
    </Part>
</ListPartsResult>

SDKs do OSS

Use o ListParts com os seguintes SDKs do OSS:

ossutil

Para obter informações sobre o comando ossutil correspondente à operação ListParts, consulte list-parts.

API	Action	Descrição
ListParts	`oss:ListParts`	Lista todas as partes enviadas com um ID de upload.