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

Permissões

Por padrão, uma conta da Alibaba Cloud possui permissões completas. Usuários RAM ou funções RAM vinculados a uma conta da Alibaba Cloud não têm nenhuma permissão por padrão. A conta da Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.

Sintaxe da requisição

Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Parâmetros da requisição

Parâmetro	Tipo	Descrição
delimiter	String	O caractere usado para agrupar objetos pelo nome. Quando o parâmetro Delimiter é especificado na requisição, a resposta inclui o elemento CommonPrefixes. Objetos cujos nomes compartilham a mesma string — do prefixo até a próxima ocorrência do delimitador — são agrupados como um único elemento em CommonPrefixes.
max-uploads	Integer	O número máximo de tarefas de upload multipart retornadas na requisição atual. Valor padrão: 1000. Valor máximo: 1000.
key-marker	String	Usado em conjunto com o parâmetro upload-id-marker para definir a posição a partir da qual a próxima listagem começa. Se upload-id-marker não estiver definido, o Object Storage Service (OSS) retorna todas as tarefas de upload multipart cujos nomes de objeto sejam alfabeticamente posteriores ao valor de key-marker. Se upload-id-marker estiver definido, a resposta inclui as seguintes tarefas: Tarefas de upload multipart cujos nomes de objeto sejam alfabeticamente posteriores ao valor de key-marker Tarefas de upload multipart cujos nomes de objeto sejam iguais ao valor de key-marker, mas cujos upload IDs sejam maiores que o valor de upload-id-marker
prefix	String	O prefixo que os nomes dos objetos retornados devem conter. Quando um prefixo é especificado na requisição, ele também é incluído na resposta. Nota Prefixos permitem agrupar e gerencie objetos em buckets da mesma forma que se organiza arquivos em pastas de um sistema de arquivos.
upload-id-marker	String	O upload ID da tarefa de upload multipart a partir da qual a listagem começa. Esse parâmetro é usado em conjunto com o parâmetro key-marker. Se key-marker não estiver definido, o OSS ignora o parâmetro upload-id-marker. Se key-marker estiver configurado, o resultado da consulta inclui: Tarefas de upload multipart cujos nomes de objeto sejam alfabeticamente posteriores ao valor de key-marker Tarefas de upload multipart cujos nomes de objeto sejam iguais ao valor de key-marker, mas cujos upload IDs sejam maiores que o valor de upload-id-marker
encoding-type	String	O 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. Contudo, o padrão XML 1.0 não processa caracteres de controle cujo valor ASCII esteja entre 0 e 10. Para contornar essa limitação, defina encoding-type a fim de codificar esses valores na resposta. Valor padrão: null

Elementos da resposta

Elemento	Tipo	Descrição
ListMultipartUploadsResult	Container	O container que armazena a resposta à requisição ListMultipartUpload. Nós filhos: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated e Upload Nós pai: nenhum
Bucket	String	O nome do bucket. Nós pai: ListMultipartUploadsResult
EncodingType	String	O método de codificação do nome do objeto na resposta. Quando encoding-type é especificado na requisição, os valores de Delimiter, KeyMarker, Prefix, NextKeyMarker e Key são codificados no resultado retornado. Nós pai: ListMultipartUploadsResult
KeyMarker	String	O nome do objeto correspondente à tarefa de upload multipart a partir da qual a listagem começa. Nós pai: ListMultipartUploadsResult
UploadIdMarker	String	O upload ID da tarefa de upload multipart a partir da qual a listagem começa. Nós pai: ListMultipartUploadsResult
NextKeyMarker	String	O marcador de nome de objeto na resposta, a ser usado na próxima requisição para retornar os resultados restantes. Nós pai: ListMultipartUploadsResult
NextUploadMarker	String	O valor de NextUploadMarker a ser usado como UploadMarker na próxima requisição, caso a resposta atual não contenha todos os resultados necessários. Nós pai: ListMultipartUploadsResult
MaxUploads	Integer	O número máximo de tarefas de upload multipart retornadas pelo OSS. Nós pai: ListMultipartUploadsResult
IsTruncated	String enumerada	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. false: todos os resultados foram retornados. Nós pai: ListMultipartUploadsResult
Upload	Container	O container que armazena as informações sobre as tarefas de upload multipart. Nós filhos: Key, UploadId e Initiated Nós pai: ListMultipartUploadsResult
Key	String	O nome do objeto para o qual uma tarefa de upload multipart foi iniciada. Nós pai: Upload Nota O OSS retorna os resultados em ordem alfabética crescente pelo nome do objeto. Várias tarefas de upload multipart iniciadas para o mesmo objeto são listadas em ordem crescente de upload ID.
UploadId	String	O ID da tarefa de upload multipart. Nós pai: Upload
Initiated	Date	O momento em que a tarefa de upload multipart foi inicializada. Nós pai: Upload

Exemplos

Exemplos de requisiçõ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>

OSS SDKs

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

ossutil

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

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