Visão geral Amostras de configuração
Nesta página, você aprenderá a definir o gerenciamento do ciclo de vida de objetos em um bucket e como ver as configurações atuais do ciclo de vida de um bucket. As configurações do ciclo de vida se aplicam a todos os objetos atuais e futuros do bucket.
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.get
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 informações sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.
Definir a configuração do ciclo de vida de um bucket
Console
- No console Trusted 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 Trusted Cloud , consulte Solução de problemas.
Linha de comando
Crie um arquivo com as regras de configuração do ciclo de vida que você quer aplicar. Veja exemplos de configuração para arquivos JSON de amostra.
Use o comando
gcloud storage buckets update
com 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 criado na Etapa 1.
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
.
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 existente em um bucket:
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
.
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 existente em um bucket:
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
.
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 existente em um bucket:
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
.
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 existente em um bucket:
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
.
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 existente em um bucket:
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
.
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 existente em um bucket:
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
.
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 existente em um bucket:
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
.
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 existente em 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.
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 CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um arquivo JSON com as regras de configuração do ciclo de vida que você quer aplicar. Veja exemplos de configuração para arquivos JSON de amostra.
Use
cURL
para 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.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que:
LIFECYCLE_CONFIG_FILE
é 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 com as regras de configuração do ciclo de vida que você quer aplicar. Confira exemplos de configuração para arquivos XML de amostra.
Use
cURL
para chamar a API XML com uma solicitação de bucketPUT
e 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.s3nsapis.fr/BUCKET_NAME?lifecycle"
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
.
Verificar a configuração do ciclo de vida de um bucket
Console
- No console Trusted 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 Trusted 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.
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
.Use
cURL
para chamar a API JSON com uma solicitação de bucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=lifecycle"
Em que
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
.Use
cURL
para chamar a API XML com uma solicitação de bucketGET
e um parâmetro de string de consultalifecycle
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/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.