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/ Obtenção de metadados de um bucket

Atualizado em 2022-11-14 GMT+08:00

Ver PDF

Obtenção de metadados de um bucket

Funções

Esta operação consulta os metadados de um bucket. Para usar essa operação, você deve ter permissão para ler o bucket.

Sintaxe da solicitação

    
         HEAD / HTTP/1.1 
Host: bucketname.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

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Tabela 1 lista os campos de cabeçalho necessários ao obter informações de configuração do CORS.

**Tabela 1** Solicitar cabeçalhos para obter a configuração do CORS
Cabeçalho	Descrição	Obrigatório
Origin	Origem da solicitação de cross-domain especificada pela pré-solicitação. Geralmente, é um nome de domínio. Tipo: string	Sim
Access-Control-Request-Headers	Cabeçalhos HTTP de uma solicitação. A solicitação pode usar vários cabeçalhos HTTP. Tipo: string	Não

Elementos de solicitação

Este pedido não contém elementos.

Sintaxe da resposta

    
         HTTP/1.1 status_code
x-obs-bucket-location: region
Date: date

Cabeçalhos de resposta

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

Tabela 2 lista parâmetros adicionais de cabeçalho de resposta que são usados, exceto para os parâmetros comuns de cabeçalho de resposta.

**Tabela 2** Parâmetros adicionais de cabeçalho de resposta
Cabeçalho	Descrição
x-obs-bucket-location	A região onde o bucket reside. Tipo: string
x-obs-storage-class	A classe de armazenamento padrão do bucket. As opções são as seguintes: STANDARD (classe de armazenamento padrão), WARM (classe de armazenamento de acesso infrequente) e COLD (classe de armazenamento de arquivo) Tipo: string
x-obs-version	Versão OBS do bucket. Tipo: string
x-obs-fs-file-interface	Indica se o bucket é um sistema de arquivos paralelo. O valor pode ser Enabled (sistema de arquivos paralelo). Se esse campo de cabeçalho não for transportado, o bucket não é um sistema de arquivos paralelo. Tipo: string
x-obs-epid	ID do projeto empresarial do bucket atual. Tipo: string
x-obs-az-redundancy	Política de redundância de dados de um bucket, que determina se os dados são armazenados em uma única AZ ou em várias AZ. O valor 3az indica que os dados são armazenados em várias AZ na mesma região. Se este campo de cabeçalho não for transportado, os dados são armazenados em uma única AZ. Tipo: string
Access-Control-Allow-Origin	Indica que a origem é incluída na resposta se a origem na solicitação atender aos requisitos de configuração do CORS quando o CORS é configurado para buckets. Tipo: string
Access-Control-Allow-Headers	Indica que os cabeçalhos serão incluídos na resposta se os cabeçalhos da solicitação atenderem aos requisitos de configuração do CORS quando o CORS for configurado para buckets. Tipo: string
Access-Control-Max-Age	Valor de MaxAgeSeconds na configuração CORS do servidor quando o CORS é configurado para buckets. Tipo: inteiro
Access-Control-Allow-Methods	Indica que os métodos na regra são incluídos na resposta se Access-Control-Request-Method na solicitação atender aos requisitos de configuração do CORS quando o CORS estiver configurado para buckets. Tipo: string Valores válidos: GET, PUT, HEAD, POST, e DELETE.
Access-Control-Expose-Headers	Valor de ExposeHeader na configuração CORS de um servidor quando o CORS é configurado para buckets. Tipo: string

Elementos de Resposta

Esta resposta não envolve elementos.

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

Nenhum campo de cabeçalho para obter a configuração do CORS é transportado.

    
         HEAD / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:30:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:niCQCuGIZpETKIyx1dttxHZyYlk=

Resposta de exemplo 1

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016439C734E0788404623FA8
Content-Type: application/xml
x-obs-storage-class: STANDARD
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSxwLpq9Hzf3OnaXr+pI/OPLKdrtiQAF
Date: WED, 01 Jul 2015 02:30:25 GMT
x-obs-bucket-location: region
x-obs-version: 3.0
Content-Length: 0

Solicitação de exemplo 2

Obtenha metadados de bucket e informações de configuração do CORS depois que o CORS for configurado para o bucket.

    
         HEAD / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:30:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:niCQCuGIZpETKIyx1dttxHZyYlk=
Origin:www.example.com
Access-Control-Request-Headers:AllowedHeader_1

Resposta de exemplo 2

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016439C734E0788404623FA8
Content-Type: application/xml
x-obs-storage-class: STANDARD
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSxwLpq9Hzf3OnaXr+pI/OPLKdrtiQAF
Date: WED, 01 Jul 2015 02:30:25 GMT
x-obs-bucket-location: region
Access-Control-Allow-Origin: www.example.com 
Access-Control-Allow-Methods: POST,GET,HEAD,PUT 
Access-Control-Allow-Headers: AllowedHeader_1 
Access-Control-Max-Age: 100 
Access-Control-Expose-Headers: ExposeHeader_1 
x-obs-version: 3.0
Content-Length: 0