ListMultipartUploads - Object Storage Service: Central de Documentação do Alibaba Cloud

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 /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Parâmetros da solicitação

Parâmetro	Tipo	Descrição
delimiter	String	Caractere usado para agrupar objetos por nome. Se você especificar o parâmetro Delimiter na solicitação, a resposta conterá o elemento CommonPrefixes. Objetos cujos nomes contêm a mesma string entre o prefixo e a próxima ocorrência do delimitador são agrupados como um único elemento de resultado em CommonPrefixes.
max-uploads	Integer	Número máximo de tarefas de upload multipart retornadas na solicitação atual. Valor padrão: 1000. Valor máximo: 1000.
key-marker	String	Use este parâmetro com upload-id-marker para especificar a posição inicial da próxima lista. Se o parâmetro upload-id-marker não estiver definido, o Object Storage Service (OSS) retorna todas as tarefas de upload multipart cujos nomes de objeto estão alfabeticamente após o valor de key-marker. Caso o parâmetro upload-id-marker esteja definido, a resposta inclui as seguintes tarefas: Tarefas de upload multipart cujos nomes de objeto estão alfabeticamente após o valor de key-marker. Tarefas de upload multipart cujos nomes de objeto são iguais ao valor do parâmetro key-marker, mas cujos IDs de upload são maiores que o valor do parâmetro upload-id-marker.
prefix	String	Prefixo obrigatório nos nomes dos objetos retornados. Se você especificar um prefixo na solicitação, ele será incluído na resposta. Nota Use prefixos para agrupar e gerenciar objetos em buckets da mesma forma que você gerencia pastas em um sistema de arquivos.
upload-id-marker	String	ID de upload da tarefa de upload multipart após a qual a lista começa. Use este parâmetro com key-marker. Se o parâmetro key-marker não estiver definido, o OSS ignora o parâmetro upload-id-marker. Quando o parâmetro key-marker está configurado, o resultado da consulta inclui: Tarefas de upload multipart cujos nomes de objeto estão alfabeticamente após o valor de key-marker. Tarefas de upload multipart cujos nomes de objeto são iguais ao valor do parâmetro key-marker, mas cujos IDs de upload são maiores que o valor do parâmetro upload-id-marker.
encoding-type	String	Tipo de codificação do nome do objeto na resposta. Os valores de Delimiter, KeyMarker, Prefix, NextKeyMarker e Key podem ser codificados em UTF-8. No entanto, o padrão XML 1.0 não consegue analisar caracteres de controle, como caracteres com valor ASCII (American Standard Code for Information Interchange) de 0 a 10. Defina o parâmetro encoding-type para codificar os valores de Delimiter, KeyMarker, Prefix, NextKeyMarker e Key na resposta. Valor padrão: null

Elementos da resposta

Elemento	Tipo	Descrição
ListMultipartUploadsResult	Container	Contêiner que armazena a resposta à solicitação ListMultipartUpload. Nós filhos: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated e Upload Nós pais: nenhum
Bucket	String	Nome do bucket. Nós pais: ListMultipartUploadsResult
EncodingType	String	Método usado para codificar o nome do objeto na resposta. Se encoding-type for especificado na solicitação, os valores desses elementos, incluindo Delimiter, KeyMarker, Prefix, NextKeyMarker e Key, serão codificados no resultado retornado. Nós pais: ListMultipartUploadsResult
KeyMarker	String	Nome do objeto correspondente à tarefa de upload multipart após a qual a lista começa. Nós pais: ListMultipartUploadsResult
UploadIdMarker	String	ID de upload da tarefa de upload multipart após a qual a lista começa. Nós pais: ListMultipartUploadsResult
NextKeyMarker	String	Marcador de nome de objeto na resposta para a próxima solicitação retornar os resultados restantes. Nós pais: ListMultipartUploadsResult
NextUploadMarker	String	Valor de NextUploadMarker usado como valor de UploadMarker na próxima solicitação, caso a resposta não contenha todos os resultados necessários. Nós pais: ListMultipartUploadsResult
MaxUploads	Integer	Número máximo de tarefas de upload multipart retornadas pelo OSS. Nós pais: ListMultipartUploadsResult
IsTruncated	Enumerated string	Indica se a lista de tarefas de upload multipart retornada na resposta foi truncada. Valor padrão: false. Valores válidos: true: Apenas parte dos resultados foi retornada desta vez. false: Todos os resultados foram retornados. Nós pais: ListMultipartUploadsResult
Upload	Container	Contêiner que armazena as informações sobre as tarefas de upload multipart. Nós filhos: Key, UploadId e Initiated Nós pais: ListMultipartUploadsResult
Key	String	Nome do objeto para o qual uma tarefa de upload multipart foi iniciada. Nós pais: Upload Nota Os resultados retornados pelo OSS são listados em ordem alfabética crescente dos nomes dos objetos. Múltiplas tarefas de upload multipart iniciadas para o mesmo objeto são listadas em ordem crescente de IDs de upload.
UploadId	String	ID da tarefa de upload multipart. Nós pais: Upload
Initiated	Date	Hora em que a tarefa de upload multipart foi inicializada. Nós pais: Upload

Exemplos

Exemplos de solicitações

Get /?uploads  HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemplos de respostas

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c****
Date: Thu, 23 Feb 2012 06:14:27 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>oss-example</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>oss.avi</NextKeyMarker>
    <NextUploadIdMarker>0004B99B8E707874FC2D692FA5D77D3F</NextUploadIdMarker>
    <Delimiter></Delimiter>
    <Prefix></Prefix>
    <MaxUploads>1000</MaxUploads>
    <IsTruncated>false</IsTruncated>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>oss.avi</Key>
        <UploadId>0004B99B8E707874FC2D692FA5D7****</UploadId>
        <Initiated>2012-02-23T06:14:27.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

SDKs do OSS

Use os SDKs do OSS nas seguintes linguagens de programação para chamar a operação ListMultipartUploads:

ossutil

Para obter informações sobre o comando ossutil correspondente à operação ListMultipartUploads, consulte list-multipart-uploads.

API	Ação	Descrição
ListMultipartUploads	`oss:ListMultipartUploads`	Lista todos os eventos de upload multipart em andamento, ou seja, aqueles inicializados, mas ainda não concluídos ou abortados.