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/ Criação de um bucket
Atualizado em 2022-11-14 GMT+08:00
Ver PDF

Criação de um bucket

Funções

Esta operação é usada para criar um bucket com um nome especificado.

  • Por padrão, um usuário pode ter no máximo 100 buckets.
  • O nome de um bucket excluído pode ser reutilizado para outro bucket ou um sistema de arquivos paralelos pelo menos 30 minutos após a exclusão.
  • Ao criar um bucket no OBS, você pode ativar o modo multi-AZ para o bucket ou desativá-lo. Com o modo multi-AZ desativado, os dados em um bucket são armazenados em uma única AZ por padrão. Com o modo multi-AZ ativado, os dados em um bucket são armazenados de forma redundante em várias AZ, melhorando a confiabilidade. No entanto, os buckets criados antes ainda estão no modo AZ único.

Um nome de bucket deve ser exclusivo no OBS. Se um usuário criar um bucket com o mesmo nome de um bucket existente na mesma conta e na mesma região, um código 200 (indicando sucesso) será retornado. Em cenários diferentes do anterior, a solicitação para criar um bucket com o mesmo nome de um existente receberá o código 409 (indicando que já existe um bucket homônimo). Para definir uma política de controle de acesso para o bucket a ser criado, adicione o parâmetro x-obs-acl aos cabeçalhos de solicitação.

Classe de armazenamento

Você pode criar buckets com diferentes classes de armazenamento. O cabeçalho x-obs-storage-class em uma solicitação de criação de bucket especifica a classe de armazenamento padrão para um bucket. A classe de armazenamento dos objetos em um bucket é a mesma que a do bucket. O OBS fornece três classes de armazenamento: Padrão (STANDARD), Acesso Infrequente (WARM) e Arquivo (COLD). Se esse cabeçalho não estiver na solicitação, a classe de armazenamento do bucket criado será Padrão.

Se a classe de armazenamento de um objeto não for especificada quando ele for carregado em um bucket (consulte Carregamento de objetos - PUT), o objeto será armazenado na classe de armazenamento padrão do bucket.

  • O OBS Standard apresenta baixa latência de acesso e alta taxa de transferência. É mais adequado para armazenar arquivos quentes acessados com freqüência (várias vezes por mês). Cenários potenciais de aplicativos incluem big data, aplicativos móveis, vídeos de tendências e imagens de mídia social.
  • O OBS Infrequent Access é mais adequado para armazenar dados acessados semi-frequentemente (menos de 12 vezes por ano) que exigem resposta rápida. Os possíveis cenários de aplicativos incluem sincronização ou compartilhamento de arquivos e backup em nível empresarial. Ele fornece a mesma durabilidade, latência de acesso e taxa de transferência que o padrão, mas a um preço mais baixo. A principal desvantagem, no entanto, é que ele tem menor disponibilidade do que o padrão.
  • O OBS Archive é mais adequado para arquivar dados raramente acessados (em média uma vez por ano). Os possíveis cenários de aplicativos incluem arquivamento de dados e retenção de dados de longo prazo para backup. Ele fornece armazenamento seguro, durável e barato, que pode substituir as bibliotecas de fitas. No entanto, pode levar horas para restaurar dados da classe de armazenamento Archive.

Sintaxe da solicitação

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
 
PUT / HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com
Content-Length: length
Date: date
Authorization: authorization
x-obs-az-redundancy: 3az

<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Location>location</Location> 
</CreateBucketConfiguration>

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-acl

Ao criar um bucket, você pode adicionar esse cabeçalho para definir a política de controle de permissão para o bucket. As políticas comuns predefinidas são as seguintes: private, public-read, public-read-write, public-read-delivered, e public-read-write-delivered Para detalhes sobre as políticas, veja a configuração ACL usando campos do cabeçalho em ACL.

Tipo: string

Não

x-obs-storage-class

Ao criar um bucket, você pode adicionar esse cabeçalho para especificar a classe de armazenamento padrão do bucket. O OBS fornece três classes de armazenamento por padrão: O OBS fornece três classes de armazenamento: Padrão (STANDARD), Acesso Infrequente (WARM) e Arquivo (COLD). Se esse cabeçalho não estiver na solicitação, a classe de armazenamento do bucket criado será Standard.

Tipo: string

Não

x-obs-grant-read

Este cabeçalho concede a permissão de leitura a todos os usuários em uma conta. Ele permite listar objetos em um bucket, listar tarefas de várias partes em um bucket, listar objetos de várias versões em um bucket e obter metadados de bucket.

Tipo: string

Exemplo: x-obs-grant-read:id=Tenant ID.

Não

x-obs-grant-write

Este cabeçalho concede a permissão de gravação a todos os usuários sob uma conta. Portanto, os usuários podem criar, excluir e substituir todos os objetos em um bucket e podem inicializar partes, fazer upload de partes, copiar partes, mesclar partes e cancelar tarefas de carregamento de multiparte.

Tipo: string

Exemplo: x-obs-grant-write:id=Tenant ID.

Não

x-obs-grant-read-acp

Esse cabeçalho concede a permissão de leitura da ACL a todos os usuários em uma conta. Portanto, os usuários podem ler as informações da ACL do bucket.

Tipo: string

Exemplo: x-obs-grant-read-acp:id=Account ID.

Não

x-obs-grant-write-acp

Este cabeçalho concede a permissão de gravação ACL a todos os usuários em uma conta. Portanto, os usuários podem modificar a ACL do bucket.

Tipo: string

Exemplo: x-obs-grant-write-acp:id=Account ID.

Não

x-obs-grant-full-control

Esse cabeçalho concede a permissão de controle total a todos os usuários em uma conta.

Tipo: string

Exemplo: x-obs-grant-full-control:id=Account ID.

Não

x-obs-grant-read-delivered

Este cabeçalho concede a permissão de leitura a todos os usuários em uma conta. Por padrão, a permissão de leitura é aplicada a todos os objetos no bucket.

Tipo: string

Exemplo: x-obs-grant-read-delivered:id=Account ID.

Não

x-obs-grant-full-control-delivered

Esse cabeçalho concede a permissão de controle total a todos os usuários em uma conta. Por padrão, a permissão FULL_CONTROL é aplicada a todos os objetos no bucket.

Tipo: string

Exemplo: x-obs-grant-full-control-delivered:id=Account ID.

Não

x-obs-az-redundancy

Esse cabeçalho é transportado na solicitação ao criar um bucket para ativar o modo multi-AZ para o bucket. Se esse cabeçalho não for transportado, o bucket estará no modo AZ único por padrão. Esse cabeçalho é transportado para especificar que um bucket recém-criado usa armazenamento multi-AZ. Se a região em que o bucket reside não oferecer suporte ao armazenamento multi-AZ, o bucket ainda usará o armazenamento single-AZ.

Tipo: string

Exemplo: x-obs-az-redundancy:3az

Não

x-obs-fs-file-interface

Esse cabeçalho pode ser transportado quando você cria um bucket como um sistema de arquivos paralelo.

Tipo: string

Exemplo: x-obs-fs-file-interface:Enabled

Não

x-obs-epid

ID do projeto empresarial, que pode ser obtido no serviço de projeto empresarial. O valor é um identificador universalmente exclusivo (UUID). O valor de um projeto corporativo padrão é 0 ou não contém esse cabeçalho. Os usuários que não habilitaram o serviço de projeto corporativo também não precisam carregar esse cabeçalho.

Tipo: string

Exemplo: x-obs-epid:9892d768-2d13-450f-aac7-ed0e44c2585f

Não

Elementos de solicitação

Esta solicitação pode usar elementos adicionais. Para obter detalhes sobre elementos adicionais, consulte Tabela 2.

Tabela 2 Elementos adicionais de solicitação

Elemento

Descrição

Obrigatório

Location

Especifica a região em que um bucket será criado.

  • Quando o endpoint da região CN North-Beijing1 é usado para a criação do bucket,
    • Se location não for incluído, o bucket será criado em CN North-Beijing1 (cn-north-1) por padrão.
    • Se outra região, por exemplo, CN-Hong Kong (ap-southeast-1), for especificada para location, o bucket será criado na região CN-Hong Kong.
  • Quando o endpoint de uma região diferente de CN Norte-Beijing1 é usado para a criação do bucket, location deve ser definida como a região à qual o endpoint usado corresponde.

    Por exemplo, se obs.ap-southeast-1.myhuaweicloud.com for usado, você deverá definir location como ap-southeast-1.

Para obter detalhes sobre regiões e endpoints do OBS, consulte Regiões e endpoints.

Tipo: string

Não

Sintaxe da resposta

1
2
3
4
 
HTTP/1.1 status_code
Location: location
Date: date
Content-Length: length

Cabeçalhos de resposta

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

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

Criar um bucket.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
 
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157

<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Location>region</Location>
</CreateBucketConfiguration>

Resposta de exemplo 1

1
2
3
4
5
6
7
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

Solicitação de exemplo 2

Crie um bucket com uma ACL e uma classe de armazenamento especificadas.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
 
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
x-obs-acl:public-read
x-obs-storage-class:STANDARD
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157

<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Location>region</Location> 
</CreateBucketConfiguration>

Resposta de exemplo 2

1
2
3
4
5
6
7
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0

Solicitação de exemplo 3

Selecione multi-AZ ao criar um bucket.

1
2
3
4
5
6
7
8
9
 
PUT / HTTP/1.1 
Host: examplebucket.obs.region.myhuaweicloud.com
Content-Length: length 
Date: date 
Authorization: authorization 
x-obs-az-redundancy:3az 
<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
 <Location>region</Location> 
</CreateBucketConfiguration>

Resposta de exemplo 3

1
2
3
4
5
6
7
8
 
HTTP/1.1 200 OK 
Server: OBS 
x-obs-request-id: BF260000016435CE298386946AE4C482 
Location: /examplebucket 
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz 
Date: WED, 01 Jul 2015 02:25:06 GMT 
x-obs-az-redundancy:3az
Content-Length: 0

Solicitação de exemplo 4

Crie um sistema de arquivos paralelos.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 
PUT / HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:25:05 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:75/Y4Ng1izvzc1nTGxpMXTE6ynw=
Content-Length: 157
x-obs-fs-file-interface: Enabled

<CreateBucketConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
<Location>region</Location> 
</CreateBucketConfiguration>

Resposta de exemplo 4

1
2
3
4
5
6
7
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016435CE298386946AE4C482
Location: /examplebucket
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
Date: WED, 01 Jul 2015 02:25:06 GMT
Content-Length: 0
Tópico principal: Operações em buckets