Como gerenciar ciclos de vida de objetos

Acessar conceitos

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

Aviso: quando a configuração do ciclo de vida é alterada, o gerenciamento do ciclo de vida de objetos poderá continuar realizando ações com base na configuração anterior por até 24 horas. Se você alterar uma condição Age de 10 para 20 dias, por exemplo, um objeto com 11 dias de idade pode ser excluído pelo gerenciamento do ciclo de vida de objetos até 24 horas depois, com base na configuração anterior.

Observação: no momento, o suporte para esse recurso por meio da biblioteca de cliente Java do Google Cloud está limitado a DeleteRules. Mas não se preocupe, é possível encontrar o suporte completo do Java na biblioteca de cliente de API do Google para Java.

Como ativar o gerenciamento do ciclo de vida

Para ativar o gerenciamento do ciclo de vida de um bucket, siga estas etapas:

Console

1. Abra o navegador do Cloud Storage no Console do Google Cloud.
   Abrir o navegador do Cloud Storage

2. Na lista de buckets, encontre o bucket que você quer ativar e clique no nome do bucket.

3. Clique na guia Ciclo de vida.

   A página de regras do ciclo de vida aparecerá.

4. Clique em Adicionar uma regra.

5. Na página que aparecerá, especifique uma configuração.

   1. Selecione a ação a ser realizada quando um objeto atende às condições.

   2. Clique em Continuar.

   3. Selecione as condições em que uma ação é realizada.

   4. Clique em Continuar.

   5. Clique em Criar.

Consulte a Solução de problemas para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage.

gsutil

1. 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.

2. 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++.

Veja no GitHub Feedback

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name) {
  gcs::BucketLifecycle bucket_lifecycle_rules = gcs::BucketLifecycle{
      {gcs::LifecycleRule(gcs::LifecycleRule::ConditionConjunction(
                              gcs::LifecycleRule::MaxAge(30),
                              gcs::LifecycleRule::IsLive(true)),
                          gcs::LifecycleRule::Delete())}};

  StatusOr<gcs::BucketMetadata> updated_metadata = client.PatchBucket(
      bucket_name,
      gcs::BucketMetadataPatchBuilder().SetLifecycle(bucket_lifecycle_rules));

  if (!updated_metadata) {
    throw std::runtime_error(updated_metadata.status().message());
  }

  if (!updated_metadata->has_lifecycle() ||
      updated_metadata->lifecycle().rule.empty()) {
    std::cout << "Bucket lifecycle management is not enabled for bucket "
              << updated_metadata->name() << ".\n";
    return;
  }
  std::cout << "Successfully enabled bucket lifecycle management for bucket "
            << updated_metadata->name() << ".\n";
  std::cout << "The bucket lifecycle rules are";
  for (auto const& kv : updated_metadata->lifecycle().rule) {
    std::cout << "\n " << kv.condition() << ", " << kv.action();
  }
  std::cout << "\n";
}

C#

Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.

Veja no GitHub Feedback

using Google.Apis.Storage.v1.Data;
using Google.Cloud.Storage.V1;
using System;
using System.Collections.Generic;

public class EnableBucketLifecycleManagementSample
{
    public Bucket EnableBucketLifecycleManagement(string bucketName = "your-unique-bucket-name")
    {
        var storage = StorageClient.Create();
        var bucket = storage.GetBucket(bucketName);
        bucket.Lifecycle = new Bucket.LifecycleData
        {
            Rule = new List<Bucket.LifecycleData.RuleData>
            {
                new Bucket.LifecycleData.RuleData
                {
                    Condition = new Bucket.LifecycleData.RuleData.ConditionData { Age = 100 },
                    Action = new Bucket.LifecycleData.RuleData.ActionData { Type = "Delete" }
                }
            }
        };
        bucket = storage.UpdateBucket(bucket);

        Console.WriteLine($"Lifecycle management is enabled for bucket {bucketName} and the rules are:");
        foreach (var rule in bucket.Lifecycle.Rule)
        {
            Console.WriteLine("Action:");
            Console.WriteLine($"Type: {rule.Action.Type}");
            Console.WriteLine($"Storage Class: {rule.Action.StorageClass}");

            Console.WriteLine("Condition:");
            Console.WriteLine($"Age: \t{rule.Condition.Age}");
            Console.WriteLine($"Created Before: \t{rule.Condition.CreatedBefore}");
            Console.WriteLine($"Time Before: \t{rule.Condition.CustomTimeBefore}");
            Console.WriteLine($"Time Before Raw: \t{rule.Condition.CustomTimeBeforeRaw}");
            Console.WriteLine($"Days Since Custom Time: \t{rule.Condition.DaysSinceCustomTime}");
            Console.WriteLine($"Days Since Non-current Time: \t{rule.Condition.DaysSinceNoncurrentTime}");
            Console.WriteLine($"IsLive: \t{rule.Condition.IsLive}");
            Console.WriteLine($"Pattern: \t{rule.Condition.MatchesPattern}");
            Console.WriteLine($"Storage Class: \t{rule.Condition.MatchesStorageClass}");
            Console.WriteLine($"Noncurrent Time Before: \t{rule.Condition.NoncurrentTimeBefore}");
            Console.WriteLine($"Noncurrent Time Before Raw: \t{rule.Condition.NoncurrentTimeBeforeRaw}");
            Console.WriteLine($"Newer Versions: \t{rule.Condition.NumNewerVersions}");
        }
        return bucket;
    }
}

Go

Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.

Veja no GitHub Feedback

import (
	"context"
	"fmt"
	"io"
	"time"

	"cloud.google.com/go/storage"
)

// enableBucketLifecycleManagement adds a lifecycle delete rule with the
// condition that the object is 100 days old.
func enableBucketLifecycleManagement(w io.Writer, bucketName string) error {
	// bucketName := "bucket-name"
	ctx := context.Background()
	client, err := storage.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("storage.NewClient: %v", err)
	}
	defer client.Close()

	ctx, cancel := context.WithTimeout(ctx, time.Second*10)
	defer cancel()

	bucket := client.Bucket(bucketName)
	bucketAttrsToUpdate := storage.BucketAttrsToUpdate{
		Lifecycle: &storage.Lifecycle{
			Rules: []storage.LifecycleRule{
				{
					Action: storage.LifecycleAction{Type: "Delete"},
					Condition: storage.LifecycleCondition{
						AgeInDays: 100,
					},
				},
			},
		},
	}

	attrs, err := bucket.Update(ctx, bucketAttrsToUpdate)
	if err != nil {
		return fmt.Errorf("Bucket(%q).Update: %v", bucketName, err)
	}
	fmt.Fprintf(w, "Lifecycle management is enabled for bucket %v\n and the rules are:\n", bucketName)
	for _, rule := range attrs.Lifecycle.Rules {
		fmt.Fprintf(w, "Action: %v\n", rule.Action)
		fmt.Fprintf(w, "Condition: %v\n", rule.Condition)
	}

	return nil
}

Java

Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.

Veja no GitHub Feedback

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.BucketInfo.LifecycleRule;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;
import com.google.common.collect.ImmutableList;

public class EnableLifecycleManagement {
  public static void enableLifecycleManagement(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);

    // See the LifecycleRule documentation for additional info on what you can do with lifecycle
    // management rules. This one deletes objects that are over 100 days old.
    // https://googleapis.dev/java/google-cloud-clients/latest/com/google/cloud/storage/BucketInfo.LifecycleRule.html
    bucket
        .toBuilder()
        .setLifecycleRules(
            ImmutableList.of(
                new LifecycleRule(
                    LifecycleRule.LifecycleAction.newDeleteAction(),
                    LifecycleRule.LifecycleCondition.newBuilder().setAge(100).build())))
        .build()
        .update();

    System.out.println("Lifecycle management was enabled and configured for bucket " + bucketName);
  }
}

Node.js

Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.

Veja no GitHub Feedback

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

async function enableBucketLifecycleManagement() {
  const [metadata] = await storage.bucket(bucketName).addLifecycleRule({
    action: 'delete',
    condition: {age: 100},
  });

  console.log(
    `Lifecycle management is enabled for bucket ${bucketName} and the rules are:`
  );

  console.log(metadata.lifecycle.rule);
}

enableBucketLifecycleManagement().catch(console.error);

PHP

Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.

Veja no GitHub Feedback

use Google\Cloud\Storage\StorageClient;
use Google\Cloud\Storage\Bucket;

/**
 * Enable bucket lifecycle management.
 *
 * @param string $bucketName the name of your Cloud Storage bucket.
 */
function enable_bucket_lifecycle_management($bucketName)
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);

    $lifecycle = Bucket::lifecycle()
        ->addDeleteRule([
            'age' => 100
        ]);

    $bucket->update([
        'lifecycle' => $lifecycle
    ]);

    $lifecycle = $bucket->currentLifecycle();

    printf('Lifecycle management is enabled for bucket %s and the rules are:' . PHP_EOL, $bucketName);
    foreach ($lifecycle as $rule) {
        print_r($rule);
        print(PHP_EOL);
    }
}

Python

Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.

Veja no GitHub Feedback

from google.cloud import storage

def enable_bucket_lifecycle_management(bucket_name):
    """Enable lifecycle management for a bucket"""
    # bucket_name = "my-bucket"

    storage_client = storage.Client()

    bucket = storage_client.get_bucket(bucket_name)
    rules = bucket.lifecycle_rules

    print("Lifecycle management rules for bucket {} are {}".format(bucket_name, list(rules)))
    bucket.add_lifecycle_delete_rule(age=2)
    bucket.patch()

    rules = bucket.lifecycle_rules
    print("Lifecycle management is enable for bucket {} and the rules are {}".format(bucket_name, list(rules)))

    return bucket

Ruby

Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.

Veja no GitHub Feedback

def enable_bucket_lifecycle_management bucket_name:
  # Enable lifecycle management for a bucket
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"

  require "google/cloud/storage"

  storage = Google::Cloud::Storage.new
  bucket = storage.bucket bucket_name

  rules = bucket.lifecycle do |l|
    l.add_delete_rule age: 2
  end

  puts "Lifecycle management is enabled for bucket #{bucket_name} and the rules are #{rules}"
end

APIs REST

API JSON

1. 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.

2. 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.

3. Use cURL (em inglês) para chamar a API JSON com uma solicitação de bucket PATCH:

   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

1. 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.

2. 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.

3. Use cURL (em inglês) para chamar a API XML com uma solicitação de bucket PUT:

   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

1. Abra o navegador do Cloud Storage no Console do Google Cloud.
   Abrir o navegador do Cloud Storage

2. 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á.

3. Clique em Excluir tudo.

4. Na janela de confirmação exibida, clique em Confirmar.

Observação: é possível excluir regras individuais ao clicar no ícone da lixeira associado à regra que você quer excluir.

Consulte a Solução de problemas para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage.

gsutil

1. Crie um arquivo .json com uma configuração de ciclo de vida vazia:

   {
     "lifecycle": {
       "rule": []
     }
   }

2. 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++.

Veja no GitHub Feedback

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string const& bucket_name) {
  StatusOr<gcs::BucketMetadata> updated_metadata = client.PatchBucket(
      bucket_name, gcs::BucketMetadataPatchBuilder().ResetLifecycle());

  if (!updated_metadata) {
    throw std::runtime_error(updated_metadata.status().message());
  }

  std::cout << "Successfully disabled bucket lifecycle management for bucket "
            << updated_metadata->name() << ".\n";
}

C#

Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.

Veja no GitHub Feedback

using Google.Apis.Storage.v1.Data;
using Google.Cloud.Storage.V1;
using System;

public class DisableBucketLifecycleManagementSample
{
    public Bucket DisableBucketLifecycleManagement(string bucketName = "your-unique-bucket-name")
    {
        var storage = StorageClient.Create();
        var bucket = storage.GetBucket(bucketName);
        bucket.Lifecycle = null;
        bucket = storage.UpdateBucket(bucket);

        Console.WriteLine($"Lifecycle management is disabled for bucket {bucketName}.");
        return bucket;
    }
}

Go

Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.

Veja no GitHub Feedback

import (
	"context"
	"fmt"
	"io"
	"time"

	"cloud.google.com/go/storage"
)

// disableBucketLifecycleManagement removes all existing lifecycle rules
// from the bucket.
func disableBucketLifecycleManagement(w io.Writer, bucketName string) error {
	// bucketName := "bucket-name"
	ctx := context.Background()
	client, err := storage.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("storage.NewClient: %v", err)
	}
	defer client.Close()

	ctx, cancel := context.WithTimeout(ctx, time.Second*10)
	defer cancel()

	bucket := client.Bucket(bucketName)
	bucketAttrsToUpdate := storage.BucketAttrsToUpdate{
		Lifecycle: &storage.Lifecycle{},
	}

	_, err = bucket.Update(ctx, bucketAttrsToUpdate)
	if err != nil {
		return fmt.Errorf("Bucket(%q).Update: %v", bucketName, err)
	}
	fmt.Fprintf(w, "Lifecycle management is disabled for bucket %v.\n", bucketName)

	return nil
}

Java

Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.

Veja no GitHub Feedback

import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;

public class DisableLifecycleManagement {
  public static void disableLifecycleManagement(String projectId, String bucketName) {
    // The ID of your GCP project
    // String projectId = "your-project-id";

    // The ID of your GCS bucket
    // String bucketName = "your-unique-bucket-name";

    Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService();
    Bucket bucket = storage.get(bucketName);
    bucket.toBuilder().deleteLifecycleRules().build().update();

    System.out.println("Lifecycle management was disabled for bucket " + bucketName);
  }
}

Node.js

Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.

Veja no GitHub Feedback

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

async function disableBucketLifecycleManagement() {
  await storage.bucket(bucketName).setMetadata({lifecycle: null});

  console.log(`Lifecycle management is disabled for bucket ${bucketName}.`);
}

disableBucketLifecycleManagement().catch(console.error);

PHP

Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.

Veja no GitHub Feedback

use Google\Cloud\Storage\StorageClient;
use Google\Cloud\Storage\Bucket;

/**
 * Disable bucket lifecycle management.
 *
 * @param string $bucketName the name of your Cloud Storage bucket.
 */
function disable_bucket_lifecycle_management($bucketName)
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);

    $bucket->update([
        'lifecycle' => null
    ]);

    printf('Lifecycle management is disabled for bucket %s.' . PHP_EOL, $bucketName);
}

Python

Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.

Veja no GitHub Feedback

from google.cloud import storage

def disable_bucket_lifecycle_management(bucket_name):
    """Disable lifecycle management for a bucket"""
    # bucket_name = "my-bucket"

    storage_client = storage.Client()

    bucket = storage_client.get_bucket(bucket_name)
    bucket.clear_lifecyle_rules()
    bucket.patch()
    rules = bucket.lifecycle_rules

    print("Lifecycle management is disable for bucket {} and the rules are {}".format(bucket_name, list(rules)))
    return bucket

Ruby

Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.

Veja no GitHub Feedback

def disable_bucket_lifecycle_management bucket_name:
  # Disable lifecycle management for a bucket
  # The ID of your GCS bucket
  # bucket_name = "your-unique-bucket-name"

  require "google/cloud/storage"

  storage = Google::Cloud::Storage.new
  bucket = storage.bucket bucket_name

  bucket.lifecycle do |l|
    l.clear
  end

  puts "Lifecycle management is disabled for bucket #{bucket_name}"
end

APIs REST

API JSON

1. 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.

2. Crie um arquivo .json com uma configuração de ciclo de vida vazia:

   {
     "lifecycle": {
       "rule": []
     }
   }

3. Use cURL (em inglês) para chamar a API JSON com uma solicitação de bucket PATCH:

   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

1. 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.

2. Crie um arquivo .xml com uma configuração de ciclo de vida vazia:

   <LifecycleConfiguration/>

3. Use cURL (em inglês) para chamar a API XML com uma solicitação de bucket PUT:

   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

1. Abra o navegador do Cloud Storage no Console do Google Cloud.
   Abrir o navegador do Cloud Storage

2. 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

1. 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

1. 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.

2. Use cURL (em inglês) para chamar a API JSON com uma solicitação de bucket GET:

   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

1. 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.

2. Use cURL (em inglês) para chamar a API XML com uma solicitação bucket GET:

   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

Aviso: este exemplo envolve a exclusão de dados. Uma vez excluídos permanentemente, os objetos não podem ser recuperados. Tome cuidado ao configurar suas regras de ciclo de vida para não excluir mais dados do que você pretende. Teste as regras de ciclo de vida nos dados de desenvolvimento antes de aplicá-las à produção para garantir que elas tenham o efeito pretendido.

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:

1. 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.

2. 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.

3. 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.

1. Para excluir versões ativas de objetos com mais de 30 dias:

   1. Selecione a ação Excluir objeto.
   2. Selecione a condição Idade e insira um valor 30.
   3. Selecione a condição Estado atual e escolha a opção Ativo.

2. Para excluir versões inativas de objetos, caso haja duas versões mais recentes:

   1. Selecione a ação Excluir objeto.
   2. Selecione a condição Número de versões mais recentes e insira um valor 2.

3. Para excluir versões inativas de objetos com mais de 35 dias:

   1. Selecione a ação Excluir objeto.
   2. Selecione a condição Idade e insira um valor 35.
   3. 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:

1. 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).
2. 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.

Observação: essa configuração de ciclo de vida se aplica a buckets em locais multirregionais ou birregionais. Para buckets em locais regionais, substitua MULTI_REGIONAL por REGIONAL.

Console

Essas configurações usam as instruções da seção de ativação.

1. Para mover objetos para o Cloud Storage Nearline 365 dias depois de sua criação:

   1. Selecione a ação Definir classe de armazenamento para Nearline.
   2. Selecione a condição Idade e insira o valor 365.
   3. Selecione a tecla Correspondências da classe de armazenamento e escolha o Padrão, Multirregional e Disponibilidade durável reduzida.

2. Para mover objetos para o Cloud Storage Coldline 1095 dias após a criação:

   1. Selecione a ação Definir classe de armazenamento para Coldline.
   2. Selecione a condição Idade e insira o valor 1095.
   3. 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.