O Gerenciamento do ciclo de vida de objetos ajuda a otimizar os custos de armazenamento e automatizar a retenção de dados definindo regras de ciclo de vida em um bucket. Por exemplo, é possível fazer a transição de objetos para classes de armazenamento mais frias ou excluir dados expirados.
É possível configurar e visualizar regras de ciclo de vida em um bucket. Essas regras se aplicam a todos os objetos atuais e futuros do bucket.
Para mais informações, consulte Gerenciamento do ciclo de vida de objetos.
Funções exigidas
Para receber as permissões necessárias para definir e gerenciar o Gerenciamento do ciclo de vida de objetos de um bucket, peça ao administrador para conceder a você o papel de Administrador do Storage (roles/storage.admin) no bucket. Esse papel predefinido contém as permissões necessárias para definir e gerenciar o Gerenciamento do ciclo de vida de objetos de um bucket. Para ver as permissões necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.getstorage.buckets.list- Essa permissão só é necessária se você usar o console do Google Cloud para executar as instruções desta página.
storage.buckets.update
Talvez você também consiga receber essas permissões com papéis personalizados.
Para informações sobre como conceder papéis em buckets, consulte Definir e gerenciar políticas do Identity and Access Management em buckets.
Definir a configuração do ciclo de vida de um bucket
Quando você altera a configuração do ciclo de vida, o Gerenciamento do ciclo de vida de objetos pode
continuar realizando ações com base na configuração anterior por até 24
horas. Por exemplo, se você alterar uma condição age de 10 para 20 dias,
o Gerenciamento do ciclo de vida de objetos ainda poderá excluir um objeto de 11 dias por até 24
horas com base na configuração anterior.
Console
- No console do Google Cloud , acesse a página Buckets do Cloud Storage.
Na lista de buckets, encontre o bucket que você quer ativar e clique no nome dele.
Clique na guia Ciclo de vida.
A página de regras do ciclo de vida aparecerá. Aqui você pode editar ou excluir regras. Para adicionar uma nova regra:
Clique em Adicionar uma regra.
Na página que aparecerá, especifique uma configuração.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console do Google Cloud , consulte Solução de problemas.
Linha de comando
Se você quiser manter as regras de ciclo de vida atuais no bucket, consulte a configuração atual do ciclo de vida e salve-a em um arquivo JSON. Caso contrário, crie um novo arquivo JSON.
Atualize o arquivo JSON para incluir todas as regras de configuração do ciclo de vida que você quer aplicar ao bucket. A aplicação de um arquivo de configuração substitui todas as regras de ciclo de vida atuais no bucket. Para ver exemplos de arquivos JSON, consulte Exemplos de configuração.
Use o comando
gcloud storage buckets updatecom a flag--lifecycle-file:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
Em que:
BUCKET_NAMEé o nome do bucket pertinente. Por exemplo,my-bucket.LIFECYCLE_CONFIG_FILEé o caminho para o arquivo JSON atualizado na Etapa 2.
Bibliotecas de cliente
Definir uma configuração de ciclo de vida usando as bibliotecas de cliente substitui todas as regras de ciclo de vida existentes no bucket. Se você quiser manter as regras atuais, primeiro consiga a configuração do ciclo de vida atual e inclua todas as regras que quer aplicar na solicitação.
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.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
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.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
Rust
Veja na amostra a seguir como definir uma configuração de ciclo de vida em um bucket:
O exemplo a seguir remove qualquer configuração de ciclo de vida de um bucket:
Terraform
É possível usar um recurso do Terraform para definir uma configuração
de ciclo de vida para um bucket gerenciado pelo Terraform. Para definir uma configuração
de ciclo de vida em um bucket atual que ainda não é gerenciado pelo Terraform,
primeiro você precisa importar o bucket atual. A aplicação de uma configuração do Terraform
substitui todas as regras de ciclo de vida atuais no bucket. Se você
quiser manter as regras atuais, inclua todos os blocos lifecycle_rule que
quer aplicar no recurso google_storage_bucket.
Para saber se uma condição de ciclo de vida é compatível com o Terraform, consulte a
documentação do Terraform do bloco condition.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization.Se você quiser manter as regras de ciclo de vida atuais no bucket, consulte a configuração atual e salve-a em um arquivo JSON. Caso contrário, crie um novo arquivo JSON.
Atualize o arquivo JSON para incluir todas as regras de configuração do ciclo de vida que você quer aplicar ao bucket. A aplicação de um arquivo de configuração substitui todas as regras de ciclo de vida existentes no bucket. Para ver exemplos de arquivos JSON, consulte Exemplos de configuração.
Use
cURLpara chamar a API JSON com uma solicitação bucketPATCH:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage./storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que:
LIFECYCLE_CONFIG_FILEé o caminho para o arquivo JSON atualizado na Etapa 3.BUCKET_NAMEé o nome do bucket pertinente. Por exemplo,my-bucket.
API XML
Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization.Se você quiser manter as regras de ciclo de vida atuais no bucket, consiga a configuração de ciclo de vida atual e salve-a em um arquivo XML. Caso contrário, crie um novo arquivo XML.
Atualize o arquivo XML para incluir todas as regras de configuração do ciclo de vida que você quer aplicar ao bucket. A aplicação de um arquivo de configuração substitui todas as regras de ciclo de vida existentes no bucket. Para ver exemplos de arquivos XML, consulte Exemplos de configuração.
Use
cURLpara chamar a API XML com uma solicitação de bucketPUTe um parâmetro de string de consultalifecycle:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./BUCKET_NAME?lifecycle"
Em que:
XML_FILE_NAMEé o caminho para o arquivo XML atualizado na Etapa 3.BUCKET_NAMEé o nome do bucket pertinente. Por exemplo,my-bucket.
Acessar a configuração do ciclo de vida de um bucket
Console
- No console do Google Cloud , acesse a página Buckets do Cloud Storage.
Na lista de buckets, localize o status do ciclo de vida de cada bucket na coluna Ciclo de vida.
Clique nesse status para adicionar, visualizar, editar e excluir regras.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console do Google Cloud , consulte Solução de problemas.
Linha de comando
Use o comando gcloud storage buckets describe com a flag --format:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
Em que BUCKET_NAME é o nome do bucket com a configuração de ciclo de vida que você quer visualizar. Por exemplo, 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.
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.
Para visualizar as políticas de ciclo de vida do intervalo, siga as instruções para exibir os metadados de um bucket e procure os campos da política de ciclo de vida na resposta.Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Para visualizar as políticas de ciclo de vida do intervalo, siga as instruções para exibir os metadados de um bucket e procure os campos da política de ciclo de vida na resposta.Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Para visualizar as políticas de ciclo de vida do intervalo, siga as instruções para exibir os metadados de um bucket e procure os campos da política de ciclo de vida na resposta.Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Para visualizar as políticas de ciclo de vida do intervalo, siga as instruções para exibir os metadados de um bucket e procure os campos da política de ciclo de vida na resposta.PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Para visualizar as políticas de ciclo de vida do intervalo, siga as instruções para exibir os metadados de um bucket e procure os campos da política de ciclo de vida na resposta.Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Para visualizar as políticas de ciclo de vida do intervalo, siga as instruções para exibir os metadados de um bucket e procure os campos da política de ciclo de vida na resposta.Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Para visualizar as políticas de ciclo de vida do intervalo, siga as instruções para exibir os metadados de um bucket e procure os campos da política de ciclo de vida na resposta.Rust
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization.Use
cURLpara chamar a API JSON com uma solicitação bucketGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que
BUCKET_NAMEé o nome do bucket pertinente. Por exemplo,my-bucket.
API XML
Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization.Use
cURLpara chamar a API XML com uma solicitação do bucketGETe o parâmetro de string de consultalifecycle:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./BUCKET_NAME?lifecycle"
Em que
BUCKET_NAMEé o nome do bucket pertinente. Por exemplo,my-bucket.
A seguir
- Saiba mais sobre o Gerenciamento do ciclo de vida de objetos, incluindo as ações e condições de ciclo de vida disponíveis.
- Veja os exemplos de configuração do ciclo de vida.