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 buckets/ Listagem de buckets
Atualizado em 2022-11-07 GMT+08:00
Ver PDF

Listagem de buckets

Funções

Você pode executar essa operação para listar todos os buckets que você criou.

Sintaxe da solicitação

1
2
3
4
 
GET / HTTP/1.1 
Host: obs.region.myhuaweicloud.com
Date: date
Authorization: authorization

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

O cabeçalho da mensagem de operação é o mesmo que o de um pedido comum. Para mais detalhes, consulte Tabela 3. No entanto, essa solicitação pode conter cabeçalhos adicionais. A tabela a seguir descreve os cabeçalhos adicionais para essa solicitação.

Tabela 1 Cabeçalhos de solicitação adicionais

Cabeçalho

Descrição

Obrigatório

x-obs-bucket-type

Este campo de cabeçalho é usado para especificar o conteúdo a ser obtido.

Valor:

  • OBJECT: Obtenha a lista de todos os buckets.
  • POSIX: Obtenha a lista de todos os sistemas de arquivos paralelos.

Se esse cabeçalho não for carregado, a lista de todos os buckets e sistemas de arquivos paralelos será obtida.

Tipo: string

Exemplo: x-obs-bucket-type: POSIX

Não

Elementos de solicitação

A solicitação não usa elementos de solicitação.

Sintaxe da resposta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
 
GET HTTP/1.1 status_code
Content-Type: type
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ListAllMyBucketsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Owner> 
        <ID>id</ID>
    </Owner> 
    <Buckets>
        <Bucket> 
            <Name>bucketName</Name> 
            <CreationDate>date</CreationDate>
            <Location>region</Location>
            <BucketType>buckettype</BucketType>
        </Bucket> 
        ... 
    </Buckets> 
</ListAllMyBucketsResult>

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 a lista XML de buckets pertencentes ao usuário. Tabela 2 descreve os elementos.

Tabela 2 Elementos de resposta

Elemento

Descrição

ListAllMyBucketsResult

Lista de buckets criados pelo usuário

Tipo: XML

Owner

Informações sobre o proprietário do bucket, incluindo o ID do locatário.

Tipo: XML

ID

ID do domínio (ID da conta) de um usuário.

Tipo: string

Buckets:

Buckets de propriedade do usuário

Tipo: XML

Bucket

Detalhes sobre um balde

Tipo: XML

Name

Nome do bucket

Tipo: string

CreationDate

Tempo de criação do bucket

Tipo: string

Location

Localização do balde

Tipo: string

BucketType

Tipo de caçamba

Tipo: string. As opções de valor são as seguintes:

  • OBJECT: indica um balde.
  • POSIX: indica um sistema de arquivos paralelo.

Respostas de erro

Nenhuma resposta de erro especial está envolvida. Para obter detalhes sobre respostas de erro, consulte Tabela 2.

Solicitação de exemplo

1
2
3
4
5
6
 
GET / HTTP/1.1
User-Agent: curl/7.29.0
Host: obs.region.myhuaweicloud.com
Accept: */*
Date: Mon, 25 Jun 2018 05:37:12 +0000
Authorization: OBS GKDF4C7Q6SI0IPGTXTJN:9HXkVQIiQKw33UEmyBI4rWrzmic=

Resposta de exemplo

 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
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435722C11379647A8A00A
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSGGDRUM62QZi3hGP8Fz3gOloYCfZ39U
Content-Type: application/xml
Date: Mon, 25 Jun 2018 05:37:12 GMT
Content-Length: 460

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListAllMyBucketsResult xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Owner>
    <ID>783fc6652cf246c096ea836694f71855</ID>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>examplebucket01</Name>
      <CreationDate>2018-06-21T09:15:01.032Z</CreationDate>
      <Location>region</Location>
      <BucketType>OBJECT</BucketType>
    </Bucket>
    <Bucket>
      <Name>examplebucket02</Name>
      <CreationDate>2018-06-22T03:56:33.700Z</CreationDate>
      <Location>region</Location>
      <BucketType>OBJECT</BucketType>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>
Tópico principal: Operações em buckets