Nesta página, mostramos como alterar a classe de armazenamento padrão de um bucket. Ao carregar um objeto para o bucket, o objeto receberá a classe de armazenamento padrão do bucket se você não especificar uma classe de armazenamento para ele. Para saber mais sobre as classes de armazenamento, consulte Classes de armazenamento.
Funções exigidas
Para receber as permissões necessárias para alterar a classe de armazenamento de um bucket, peça ao administrador para conceder a você o papel do IAM de Administrador do Storage (roles/storage.admin
) no bucket.
Esse papel predefinido contém as permissões necessárias para alterar a classe de armazenamento de um bucket. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.get
- Essa permissão só é necessária ao usar o console doTrusted Cloud para executar as instruções nesta página.
storage.buckets.list
- Essa permissão só é necessária ao usar o console doTrusted Cloud para executar as instruções nesta página.
storage.buckets.update
Talvez você também consiga receber essas permissões com papéis personalizados.
Para instruções sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.
Alterar a classe de armazenamento padrão de um bucket.
Console
- No console Trusted Cloud , acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket cuja classe de armazenamento você quer alterar.
Na página Detalhes do bucket, clique na guia Configuração.
Clique no ícone Editar (edit) de Classe de armazenamento padrão.
Na janela de sobreposição, selecione a nova classe de armazenamento padrão que você quer para seu bucket.
Clique em Salvar.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console Trusted Cloud , consulte Solução de problemas.
Linha de comando
Use o comando gcloud storage buckets update
com a flag --default-storage-class
:
gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=STORAGE_CLASS
Em que:
BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.STORAGE_CLASS
é a nova classe de armazenamento escolhida para o bucket. Por exemplo,nearline
.
A resposta terá esta aparência:
Setting default storage class to "nearline" for bucket gs://my-bucket
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
C#
Saiba mais na documentação de referência C# da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Go
Saiba mais na documentação de referência Go da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Java
Saiba mais na documentação de referência Java da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Node.js
Saiba mais na documentação de referência Node.js da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
PHP
Saiba mais na documentação de referência PHP da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Python
Saiba mais na documentação de referência Python da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Ruby
Saiba mais na documentação de referência Ruby da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
APIs REST
API JSON
Ter CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um arquivo JSON com as informações a seguir:
{ "storageClass": "STORAGE_CLASS" }
Em que
STORAGE_CLASS
é a nova classe de armazenamento escolhida para o bucket. Por exemplo,nearline
.Use
cURL
para chamar a API JSON com uma solicitaçãoPATCH
bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=storageClass"
Em que:
JSON_FILE_NAME
é o caminho para o arquivo JSON criado na Etapa 2.BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
API XML
Ter CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um arquivo XML que contenha as seguintes informações:
<StorageClass>STORAGE_CLASS</StorageClass>
Em que
STORAGE_CLASS
é o nome da nova classe de armazenamento escolhida para o bucket. Por exemplo,nearline
.Use
cURL
para chamar a API XML com uma solicitação do bucketPUT
com o escopo definido como?storageClass
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?storageClass"
Em que:
XML_FILE_NAME
é o caminho para o arquivo XML criado na Etapa 2.BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
A seguir
- Mova ou renomeie um bucket.
- Faça o upload de um objeto.
- Altere a classe de armazenamento de um objeto.
- Gerencie os ciclos de vida dos objetos.
- Saiba mais sobre o gerenciamento automático de classes de armazenamento usando a Classe automática.