Vista geral Exemplos de configuração
Esta página descreve como definir a gestão do ciclo de vida de objetos num contentor e como ver a configuração atual do ciclo de vida de um contentor. As configurações do ciclo de vida aplicam-se a todos os objetos atuais e futuros no contentor.
Funções necessárias
Para receber as autorizações necessárias para definir e gerir a gestão do ciclo de vida dos objetos para um contentor, peça ao seu administrador para lhe conceder a função de administrador do armazenamento (roles/storage.admin
) no contentor. Esta função predefinida contém as autorizações necessárias para definir e gerir a gestão do ciclo de vida de objetos para um contentor. Para ver as autorizações exatas necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
storage.buckets.get
storage.buckets.list
- Esta autorização só é necessária se planear usar a Google Cloud consola para executar as instruções nesta página.
storage.buckets.update
Também pode conseguir estas autorizações com funções personalizadas.
Para ver informações sobre a concessão de funções em contentores, consulte o artigo Use o IAM com contentores.
Defina a configuração do ciclo de vida para um contentor
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, encontre o contentor que quer ativar e clique no nome do contentor.
Clique no separador Ciclo de vida.
É apresentada a página de regras do ciclo de vida. Aqui, pode editar ou eliminar regras existentes. Para adicionar uma nova regra:
Clique em Adicionar regra.
Na página apresentada, especifique uma configuração.
Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Google Cloud consola, consulte a secção Resolução de problemas.
Linha de comandos
Crie um ficheiro JSON com as regras de configuração do ciclo de vida que quer aplicar. Consulte exemplos de configuração para ver exemplos de ficheiros JSON.
Use o comando
gcloud storage buckets update
com a flag--lifecycle-file
:gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
Onde:
BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.LIFECYCLE_CONFIG_FILE
é o caminho para o ficheiro JSON que criou no passo 1.
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
O exemplo seguinte define uma configuração do ciclo de vida num contentor:
O exemplo seguinte remove qualquer configuração do ciclo de vida existente de um contentor:
Terraform
Pode usar um recurso do Terraform para definir uma configuração do ciclo de vida para um contentor gerido pelo Terraform. Para definir uma configuração do ciclo de vida num contentor existente que ainda não seja gerido pelo Terraform, tem de importar primeiro o contentor existente.
Para saber se uma condição do ciclo de vida é suportada pelo Terraform, consulte a
documentação do Terraform para o bloco condition
.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um ficheiro JSON com as regras de configuração do ciclo de vida que quer aplicar. Consulte exemplos de configuração para ver exemplos de ficheiros JSON.
Use
cURL
para chamar a API JSON com um pedido dePATCH
contentor:curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Onde:
LIFECYCLE_CONFIG_FILE
é o caminho para o ficheiro JSON que criou no passo 2.BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.
API XML
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um ficheiro XML com as regras de configuração do ciclo de vida que quer aplicar. Consulte exemplos de configuração para ver ficheiros XML de exemplo.
Use
cURL
para chamar a API XML com um pedido dePUT
contentor e o parâmetro de string de consultalifecycle
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Onde:
XML_FILE_NAME
é o caminho para o ficheiro XML que criou no passo 2.BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.
Verifique a configuração do ciclo de vida de um contentor
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de segmentos, o estado do ciclo de vida de cada segmento encontra-se na coluna Ciclo de vida.
Pode clicar neste estado para adicionar, ver, editar e eliminar regras.
Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Google Cloud consola, consulte a secção Resolução de problemas.
Linha de comandos
Use o comando gcloud storage buckets describe
com a flag
--format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
Onde BUCKET_NAME
é o nome do contentor
cuja configuração do ciclo de vida quer ver. Por exemplo,
my-bucket
.
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Para ver as políticas de ciclo de vida do contentor, siga as instruções para apresentar os metadados de um contentor 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 Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Para ver as políticas de ciclo de vida do contentor, siga as instruções para apresentar os metadados de um contentor 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 Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Para ver as políticas de ciclo de vida do contentor, siga as instruções para apresentar os metadados de um contentor 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 Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Para ver as políticas de ciclo de vida do contentor, siga as instruções para apresentar os metadados de um contentor 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 PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Para ver as políticas de ciclo de vida do contentor, siga as instruções para apresentar os metadados de um contentor 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 Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Para ver as políticas de ciclo de vida do contentor, siga as instruções para apresentar os metadados de um contentor 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 Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Para ver as políticas de ciclo de vida do contentor, siga as instruções para apresentar os metadados de um contentor e procure os campos da política de ciclo de vida na resposta.APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedido deGET
contentor:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que
BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.
API XML
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API XML com um pedido deGET
Bucket e um parâmetro de string de consultalifecycle
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
Em que
BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.
O que se segue?
- Saiba mais sobre a gestão do ciclo de vida de objetos, incluindo as ações e as condições do ciclo de vida disponíveis.
- Explore exemplos de configuração do ciclo de vida.