Nesta página, você aprenderá a ativar o Gerenciamento do ciclo de vida de objetos e verá exemplos de políticas do ciclo de vida. As configurações do ciclo de vida são gerenciadas no nível do bucket e valem para todos os objetos atuais e futuros do bucket.
Como configurar o gerenciamento do ciclo de vida em um bucket
Como ativar o gerenciamento do ciclo de vida
Para ativar o gerenciamento do ciclo de vida de um bucket, siga estas etapas:
Console
- Abra o navegador do Cloud Storage no Console do Google Cloud.
Abrir o navegador do Cloud Storage Na lista de buckets, encontre o bucket que você quer ativar e clique no nome do bucket.
Clique na guia Ciclo de vida.
A página de regras do ciclo de vida aparecerá.
Clique em Adicionar uma regra.
Na página que aparecerá, especifique uma configuração.
Consulte a Solução de problemas para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage.
gsutil
Crie um arquivo
.json
com as regras de configuração do ciclo de vida que você quer aplicar. Veja exemplos de arquivos.json
nos exemplos de configuração.Use o comando
lifecycle set
para aplicar a seguinte configuração:gsutil lifecycle set LIFECYCLE_CONFIG_FILE gs://BUCKET_NAME
Em que:
LIFECYCLE_CONFIG_FILE
é o nome do arquivo que você criou na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Amostras de código
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage para C++.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.
APIs REST
API JSON
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Crie um arquivo
.json
com as regras de configuração do ciclo de vida que você quer aplicar. Veja exemplos de arquivos.json
nos exemplos de configuração.Use
cURL
(em inglês) para chamar a API JSON com uma solicitação de bucketPATCH
:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que:
LIFECYCLE_CONFIG_FILE
é o nome do arquivo que você criou na etapa 2;OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
API XML
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Crie um arquivo
.xml
com as regras de configuração do ciclo de vida que você quer aplicar. Veja exemplos de arquivos.xml
nos exemplos de configuração.Use
cURL
(em inglês) para chamar a API XML com uma solicitação de bucketPUT
:curl -X PUT --data-binary @XML_FILE.xml \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Em que:
XML_FILE
é o nome do arquivo que você criou na etapa 2.OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Como desativar o gerenciamento do ciclo de vida
Para desativar o gerenciamento do ciclo de vida de um bucket, siga estas etapas:
Console
- Abra o navegador do Cloud Storage no Console do Google Cloud.
Abrir o navegador do Cloud Storage Na lista de buckets, encontre o bucket que você quer desativar e clique na entrada na coluna Regras do ciclo de vida.
A página de regras do ciclo de vida aparecerá.
Clique em Excluir tudo.
Na janela de confirmação exibida, clique em Confirmar.
Consulte a Solução de problemas para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage.
gsutil
Crie um arquivo
.json
com uma configuração de ciclo de vida vazia:{ "lifecycle": { "rule": [] } }
Use o comando
lifecycle set
:gsutil lifecycle set LIFECYCLE_CONFIG_FILE gs://BUCKET_NAME
Em que:
LIFECYCLE_CONFIG_FILE
é o nome do arquivo que você criou na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Amostras de código
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage para C++.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.
APIs REST
API JSON
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Crie um arquivo
.json
com uma configuração de ciclo de vida vazia:{ "lifecycle": { "rule": [] } }
Use
cURL
(em inglês) para chamar a API JSON com uma solicitação de bucketPATCH
:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que:
LIFECYCLE_CONFIG_FILE
é o nome do arquivo que você criou na etapa 2;OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
API XML
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Crie um arquivo
.xml
com uma configuração de ciclo de vida vazia:<LifecycleConfiguration/>
Use
cURL
(em inglês) para chamar a API XML com uma solicitação de bucketPUT
:curl -X PUT --data-binary @XML_FILE.xml \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Em que:
XML_FILE
é o nome do arquivo que você criou na etapa 2.OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Como verificar a configuração do ciclo de vida
Para verificar a configuração do ciclo de vida definida em um bucket, siga estas etapas:
Console
- Abra o navegador do Cloud Storage no Console do Google Cloud.
Abrir o navegador 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.
Consulte a Solução de problemas para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage.
gsutil
Use o comando
lifecycle get
:gsutil lifecycle get gs://BUCKET_NAME
em que
BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
APIs REST
API JSON
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Use
cURL
(em inglês) para chamar a API JSON com uma solicitação de bucketGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que:
OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
API XML
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Use
cURL
(em inglês) para chamar a API XML com uma solicitação bucketGET
:curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Em que:
OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;BUCKET_NAME
é o nome do bucket pertinente. Por exemplo,my-bucket
.
Exemplos de configuração do ciclo de vida do objeto
Os exemplos a seguir mostram configurações específicas do ciclo de vida que executam ações de ciclo de vida quando condições comuns do ciclo de vida são atendidas. Essas configurações valem para todos os objetos atuais e futuros no bucket configurado.
Excluir um objeto
A seguinte configuração do ciclo de vida define três regras. Observe que a segunda e a terceira regras são aplicáveis somente quando o Controle de versão de objeto no bucket:
Excluir versões ativas de objetos com mais de 30 dias.
Se o bucket usar o controle de versão de objeto, esses objetos ficarão inativos e estarão sujeitos às outras duas regras.
Se o bucket não usar o controle de versão de objeto, esses objetos serão excluídos permanentemente e não poderão ser recuperados.
Excluir versões de objetos não atuais se houver duas versões mais recentes do objeto no bucket. Objetos sujeitos a essa regra são excluídos permanentemente e não podem ser recuperados.
Excluir versões inativas de objetos com mais de 35 dias. Objetos sujeitos a essa regra são excluídos permanentemente e não podem ser recuperados.
O efeito combinado dessas três regras é que os objetos estão sujeitos à exclusão permanente após no máximo 35 dias no bucket: 30 dias como uma versão ativa e 5 dias como uma versão inativa. Para versões ativas de objetos substituídas ou excluídas fora do escopo dessa configuração, elas ficam sujeitas à exclusão permanente antes: cinco dias a partir do momento em que se tornam não atuais ou sempre que houver mais de uma versão mais recente do objeto no bucket.
Console
Essas configurações usam as instruções da seção de ativação.
Para excluir versões ativas de objetos com mais de 30 dias:
- Selecione a ação Excluir objeto.
- Selecione a condição Idade e insira um valor 30.
- Selecione a condição Estado atual e escolha a opção Ativo.
Para excluir versões inativas de objetos, caso haja duas versões mais recentes:
- Selecione a ação Excluir objeto.
- Selecione a condição Número de versões mais recentes e insira um valor 2.
Para excluir versões inativas de objetos com mais de 35 dias:
- Selecione a ação Excluir objeto.
- Selecione a condição Idade e insira um valor 35.
- Selecione a condição Estado atual e escolha a opção Inativo.
gsutil
Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um bucket:
{ "lifecycle": { "rule": [ { "action": {"type": "Delete"}, "condition": { "age": 30, "isLive": true } }, { "action": {"type": "Delete"}, "condition": { "numNewerVersions": 2 } }, { "action": {"type": "Delete"}, "condition": { "age": 35, "isLive": false } } ] } }
Para ver o formato geral de um arquivo de configuração de ciclo de vida, consulte a representação do recurso de intervalos para JSON.
APIs REST
API JSON
Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um bucket:
{ "lifecycle": { "rule": [ { "action": {"type": "Delete"}, "condition": { "age": 30, "isLive": true } }, { "action": {"type": "Delete"}, "condition": { "numNewerVersions": 2 } }, { "action": {"type": "Delete"}, "condition": { "age": 35, "isLive": false } } ] } }
Para ver o formato geral de um arquivo de configuração de ciclo de vida, consulte a representação do recurso de intervalos para JSON.
API XML
Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um bucket:
<?xml version="1.0" encoding="UTF-8" ?> <LifecycleConfiguration> <Rule> <Action> <Delete/> </Action> <Condition> <IsLive>true</IsLive> <Age>30</Age> </Condition> </Rule> <Rule> <Action> <Delete/> </Action> <Condition> <NumberOfNewerVersions>2</Age> </Condition> </Rule> <Rule> <Action> <Delete/> </Action> <Condition> <IsLive>false</IsLive> <Age>35</Age> </Condition> </Rule> </LifecycleConfiguration>
Para ver o formato geral de um arquivo de configuração de ciclo de vida, consulte o formato de configuração de ciclo de vida para XML.
Alterar a classe de armazenamento de um objeto
A seguinte configuração do ciclo de vida define duas regras:
- Altere a classe de armazenamento de um objeto para Nearline Storage caso a existência dele seja maior que 365 dias (um ano) e a classe de armazenamento atual seja Standard Storage, Multi-Regional Storage ou disponibilidade durável reduzida (DRA, na sigla em inglês).
- Altere a classe de armazenamento de um objeto para Coldline Storage caso a existência dele seja maior que 1.095 dias (três anos) e a classe de armazenamento atual seja Nearline Storage.
Console
Essas configurações usam as instruções da seção de ativação.
Para mover objetos para o Cloud Storage Nearline 365 dias depois de sua criação:
- Selecione a ação Definir classe de armazenamento para Nearline.
- Selecione a condição Idade e insira o valor 365.
- Selecione a tecla Correspondências da classe de armazenamento e escolha o Padrão, Multirregional e Disponibilidade durável reduzida.
Para mover objetos para o Cloud Storage Coldline 1095 dias após a criação:
- Selecione a ação Definir classe de armazenamento para Coldline.
- Selecione a condição Idade e insira o valor 1095.
- Selecione a condição Correspondências da classe de armazenamento e escolha a opção Nearline.
gsutil
Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um bucket:
{ "lifecycle": { "rule": [ { "action": { "type": "SetStorageClass", "storageClass": "NEARLINE" }, "condition": { "age": 365, "matchesStorageClass": ["MULTI_REGIONAL", "STANDARD", "DURABLE_REDUCED_AVAILABILITY"] } }, { "action": { "type": "SetStorageClass", "storageClass": "COLDLINE" }, "condition": { "age": 1095, "matchesStorageClass": ["NEARLINE"] } } ] } }
Para ver o formato geral de um arquivo de configuração de ciclo de vida, consulte a representação do recurso de intervalos para JSON.
APIs REST
API JSON
Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um bucket:
{ "lifecycle": { "rule": [ { "action": { "type": "SetStorageClass", "storageClass": "NEARLINE" }, "condition": { "age": 365, "matchesStorageClass": ["MULTI_REGIONAL", "STANDARD", "DURABLE_REDUCED_AVAILABILITY"] } }, { "action": { "type": "SetStorageClass", "storageClass": "COLDLINE" }, "condition": { "age": 1095, "matchesStorageClass": ["NEARLINE"] } } ] } }
Para ver o formato geral de um arquivo de configuração de ciclo de vida, consulte a representação do recurso de intervalos para JSON.
API XML
Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um bucket:
<?xml version="1.0" encoding="UTF-8" ?> <LifecycleConfiguration> <Rule> <Action> <SetStorageClass>NEARLINE</SetStorageClass> </Action> <Condition> <Age>365</Age> <MatchesStorageClass>MULTI_REGIONAL</MatchesStorageClass> <MatchesStorageClass>STANDARD</MatchesStorageClass> <MatchesStorageClass>DURABLE_REDUCED_AVAILABILITY</MatchesStorageClass> </Condition> </Rule> <Rule> <Action> <SetStorageClass>COLDLINE</SetStorageClass> </Action> <Condition> <Age>1095</Age> <MatchesStorageClass>NEARLINE</MatchesStorageClass> </Condition> </Rule> </LifecycleConfiguration>
Para ver o formato geral de um arquivo de configuração de ciclo de vida, consulte o formato de configuração de ciclo de vida para XML.
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.