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 tarefas de multiparte inicializadas em um bucket
Atualizado em 2022-11-14 GMT+08:00

Listagem das tarefas de multiparte inicializadas em um bucket

Funções

Esta operação consulta todas as tarefas de carregamento de multiparte que foram inicializadas, mas não foram mescladas ou canceladas em um bucket.

Sintaxe da solicitação

GET /?uploads&max-uploads=max HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization

Parâmetros de solicitação

Essa solicitação usa parâmetros para especificar o bucket de consulta para carregamentos de multiparte. Tabela 1 descreve os parâmetros.

Tabela 1 Parâmetros de solicitação

Parâmetro

Descrição

Obrigatório

delimiter

Para um carregamento de multiparte que contém delimitadores, a string entre o primeiro caractere e o primeiro delimitador no nome do objeto (excluindo o prefixo especificado na solicitação, se houver) é retornada como CommonPrefix. Os carregamentos de multiparte com objetos que contêm CommonPrefix são considerados como um grupo e retornados como um registro. O registro não contém informações sobre as tarefas, apenas informando ao usuário que o grupo envolve carregamentos de multiparte.

Tipo: string

Não

prefix

Se um prefixo for especificado, a resposta conterá apenas tarefas cujos nomes começam com o valor do prefixo.

Tipo: string

Não

max-uploads

Número máximo de tarefas de carregamento de multiparte retornadas. O valor varia de 1 a 1000. Se o valor tiver excedido esse bucket, 1000 tarefas serão retornadas por padrão.

Tipo: integer

Não

key-marker

Lista carregamentos de multiparte que seguem o valor de key-marker.

Tipo: string

Não

upload-id-marker

Lista tarefas de multiparte que seguem o valor de carregamento-id-marker em key-marker. Este parâmetro funciona apenas em conjunto com key-marker.

Tipo: string

Não

encoding-type

Codifica alguns elementos na resposta com base no tipo especificado. Se Delimiter, KeyMarker, Prefix, NextKeyMarker e Key contiverem caracteres de controle que não são suportados pelo padrão XML 1.0, você pode definir o tipo de codificação para codificar Delimiter, KeyMarker, Prefixo (incluindo o Prefix em CommonPrefixes), NextKeyMarker e Key em resposta.

Tipo: string

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
HTTP/1.1 status_code
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ListMultipartUploadsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Bucket>bucketname</Bucket> 
    <KeyMarker/> 
    <UploadIdMarker/> 
    <NextKeyMarker>nextMarker</NextKeyMarker> 
    <NextUploadIdMarker>idMarker</NextUploadIdMarker> 
    <MaxUploads>maxUploads</MaxUploads> 
    <IsTruncated>true</IsTruncated> 
    <Upload> 
        <Key>key</Key> 
        <UploadId>uploadID</UploadId> 
        <Initiator> 
            <ID>domainID/domainID:userID/userID</ID> 
        </Initiator> 
        <Owner> 
            <ID>ownerID</ID>
        </Owner> 
        <StorageClass>storageclass</StorageClass> 
        <Initiated>initiatedDate</Initiated>  
    </Upload> 
</ListMultipartUploadsResult>

Cabeçalhos de resposta

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

Elementos de resposta

Essa resposta contém elementos de informação sobre os carregamentos de multiparte. Tabela 2 descreve os elementos.

Tabela 2 Elementos de resposta

Elemento

Descrição

ListMultipartUploadsResult

Container para respostas de solicitações.

Tipo: container

Crianças: Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimitador, Prefixo, Upload, CommonPrefixes, ÉTruncado

Antepassado: nenhum

Bucket

Nome do bucket para o qual o carregamento de multiparte foi iniciado

Tipo: string

Antepassado: ListMultipartUploadsResult

EncodingType

Codifica alguns elementos na resposta com base no tipo especificado. Se o tipo de codificação for especificado na solicitação, Delimiter, KeyMarker, Prefix (incluindo o prefixo em CommonPrefixes), NextKeyMarker e Key na resposta serão codificados.

Tipo: string

Nó pai: ListMultipartUploadsResult

KeyMarker

Chaves de objeto no ou após o qual a listagem de carregamento de multiparte começa

Tipo: string

Antepassado: ListMultipartUploadsResult

UploadIdMarker

ID de carregamento após o qual a listagem de carregamento de multiparte começa

Tipo: string

Antepassado: ListMultipartUploadsResult

NextKeyMarker

Valor de KeyMarker em uma solicitação subsequente depois que uma lista de carregamento de multiparte é truncada

Tipo: string

Antepassado: ListMultipartUploadsResult

NextUploadIdMarker

Valor de UploadMarker em uma solicitação subsequente depois que uma lista de carregamento de multiparte é truncada

Tipo: string

Antepassado: ListMultipartUploadsResult

MaxUploads

Máximo de carregamentos de multiparte a serem retornados na resposta

Tipo: integer

Antepassado: ListMultipartUploadsResult

IsTruncated

Indica se a lista retornada de carregamentos de multiparte está truncada. true: Nem todos os resultados são retornados. false: Todos os resultados foram retornados.

Tipo: boolean

Antepassado: ListMultipartUploadsResult

Upload

Contêiner para elementos relacionados a um carregamento de multiparte específico

Tipo: container

Crianças: Chave, UploadId, InitiatorOwner, StorageClass, Iniciado

Antepassado: ListMultipartUploadsResult

Key

Indica o nome do objeto para o qual um carregamento de multiparte é iniciado.

Tipo: string

Antepassado: Upload

UploadId

ID do carregamento de multiparte

Tipo: string

Antepassado: Upload

Initiator

Elemento de contêiner que identifica quem iniciou o carregamento de multiparte

ID dos nós filhos.

Tipo: container

Antepassado: Upload

ID

ID da conta à qual o proprietário pertence.

Tipo: string

Antepassado: Iniciador, Proprietário

Owner

Proprietário da peça.

Tipo: Container

Indica o ID do subnó.

Antepassado: Upload

StorageClass

Indica a classe de armazenamento que será usada para armazenar um objeto quando a multiparte é carregada.

Tipo: enumeração

Antepassado: Upload

Initiated

Data e hora em que o carregamento de multipartes foi iniciado

Tipo: data

Antepassado: Upload

ListMultipartUploadsResult.Prefix

Prefixo especificado em uma solicitação.

Tipo: string

Antepassado: ListMultipartUploadsResult

Delimiter

Delimitador em uma solicitação.

Tipo: string

Antepassado: ListMultipartUploadsResult

CommonPrefixes

Indica informações do grupo. Se você especificar um delimitador na solicitação, a resposta conterá informações de grupo em CommonPrefixes.

Tipo: container

Antepassado: ListMultipartUploadsResult

CommonPrefixes. Prefixo

Indica um prefixo diferente nas informações do grupo em CommonPrefixes.

Tipo: string

Antepassado: CommonPrefixes

Respostas de erro

Se o valor de maxUploads for não inteiro ou menor que 0, o OBS retornará 400 Bad Request.

Para outros erros, veja Tabela 2.

Solicitação de exemplo 1

Listar as tarefas de várias partes inicializadas sem nenhum parâmetro.

1
2
3
4
5
6
GET /?uploads HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=

Resposta de exemplo 1

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D405534D046A2295674C
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSDaHP+a+Bp0RI6Mm9XvCOrf7q3qvBQW
Content-Type: application/xml
Date: WED, 01 Jul 2015 04:51:21 GMT
Content-Length: 681

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListMultipartUploadsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Bucket>examplebucket</Bucket>
  <KeyMarker/>
  <UploadIdMarker/>
  <Delimiter/>
  <Prefix/>
  <MaxUploads>1000</MaxUploads>
  <IsTruncated>false</IsTruncated>
  <Upload>
    <Key>obj2</Key>
    <UploadId>00000163D40171ED8DF4050919BD02B8</UploadId>
    <Initiator>
      <ID>domainID/b4bf1b36d9ca43d984fbcb9491b6fce9:userID/71f390117351534r88115ea2c26d1999</ID>
    </Initiator>
    <Owner>
      <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2015-07-01T02:30:54.582Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>

Solicitação de exemplo 2

Liste as tarefas de várias partes inicializadas com o prefixo e o delimitador.

O exemplo a seguir descreve como listar tarefas de multipartes inicializadas quando há duas tarefas de multipartes no bucket examplebucket e seus nomes de objeto são multipart-object001 e part2-key02. Defina prefix como multipart e defina delimiter como object001.

GET /?carregamentos&delimiter=object001&prefix=multipart HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:51:21 GMT
Authorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=

Resposta de exemplo 2

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 5DEB00000164A27A1610B8250790D703
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSq3ls2ZtLDD6pQLcJq1yGITXgspSvBR
Content-Type: application/xml
Date: WED, 01 Jul 2015 04:51:21 GMT
Content-Length: 681
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListMultipartUploadsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Bucket>newbucket0001</Bucket>
  <KeyMarker></KeyMarker>
  <UploadIdMarker>
  </UploadIdMarker>
  <Delimiter>object</Delimiter>
  <Prefix>multipart</Prefix>
  <MaxUploads>1000</MaxUploads>
  <IsTruncated>false</IsTruncated>
  <CommonPrefixes>
    <Prefix>multipart-object001</Prefix>
  </CommonPrefixes>
</ListMultipartUploadsResult>