Crie um bucket

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Ao criar um bucket, é possível especificar a localização geográfica do bucket e a classe de armazenamento dele.

Se você tentar criar um bucket com nome inválido, receberá um 400 Solicitação inválida código de status e o corpo da resposta de erro teráInvalidBucketName no Code.

Só é possível criar um bucket em projetos em que você tem permissão para fazer isso. Por exemplo, se você tiver o papel Administrador do Storage em um projeto, terá a permissão necessária (storage.objects.create) para criar buckets.

Além disso, como o namespace do bucket é global, o nome dele precisa ser exclusivo em todo o namespace do Cloud Storage. Se o nome do bucket estiver em uso, você receberá um código de status 409 Conflict e a solicitação de criação de bucket falhará. O corpo da resposta de erro conterá BucketAlreadyExists no elemento Code se o bucket já existir no namespace ou incluir um BucketAlreadyOwnedByYou no elemento Code se o bucket pertencer a você. Para mais informações, consulte as Diretrizes de nomenclatura de bucket e as diretrizes de nomenclatura de objetos.

Parâmetros de string de consulta

Normalmente, essa solicitação não inclui parâmetros de string de consulta.

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Além dos cabeçalhos de solicitação comuns, os itens a seguir podem ser usados.

Header Descrição Obrigatório
x-goog-acl A lista de controle de acesso (ACL) predefinida que você deseja aplicar ao bloco. Não use esse parâmetro se você estiver usando o parâmetro de string de consulta acl para aplicar ACLs. Não
x-goog-bucket-retention-period O tempo, em segundos, que os objetos no bucket precisam ser retidos antes de serem substituídos ou excluídos. Não
x-goog-project-id O ID de um projeto. Obrigatório, a menos que você tenha definido o projeto padrão para acesso interoperável. Não

Elementos do corpo da solicitação

Os seguintes elementos do corpo da solicitação são aplicáveis ao criar um bucket. Se você não especificar um corpo de solicitação, o Cloud Storage criará um bucket no local US com uma classe de armazenamento STANDARD.

Element Descrição
CreateBucketConfiguration Contêiner para solicitação de criação de corpo.
LocationConstraint Um local para o bucket.
StorageClass A classe de armazenamento do bucket, como STANDARD, NEARLINE, COLDLINE ou ARCHIVE.

Sintaxe da solicitação

PUT / HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING
x-goog-project-id: PROJECT_ID
x-goog-acl: PREDEFINED_ACL
x-goog-bucket-retention-period: TIME_IN_SECONDS

<CreateBucketConfiguration>
  <LocationConstraint>LOCATION</LocationConstraint>
  <StorageClass>STORAGE_CLASS</StorageClass>
</CreateBucketConfiguration>

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados.

Elementos do corpo da resposta

A resposta não inclui um documento XML no corpo da resposta.

Exemplo

A amostra a seguir cria um bucket de Armazenamento padrão chamado acme-pets no local dos EUA e no projeto especificado (nenhum corpo da solicitação especificado).

Solicitação

PUT / HTTP/1.1
Host: acme-pets.storage.googleapis.com
Date: Mon, 15 Feb  2008 21:30:39 GMT
Content-Length: 0
x-goog-project-id: 123456789123
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
 
<CreateBucketConfiguration>
  <StorageClass>STANDARD</StorageClass>
</CreateBucketConfiguration>

Resposta

HTTP/1.1 200 OK
Date: Mon, 15 Feb 2010 12:30:40 GMT
Content-Length: 0