Como gerenciar ciclos de vida de objetos

Nesta página, você aprenderá como ativar o Gerenciamento do ciclo de vida de objetos, além de ver exemplos de políticas de ciclo de vida. Para ver a descrição desse recurso, incluindo as ações e condições compatíveis, consulte Gerenciamento do ciclo de vida de objetos.

Como configurar o gerenciamento do ciclo de vida em um intervalo

Como ativar o gerenciamento do ciclo de vida

Para ativar o gerenciamento do ciclo de vida de um intervalo:

Console

  1. Abra o navegador do Cloud Storage no Console do Google Cloud Platform.
    Abrir o navegador do Cloud Storage
  2. Na lista de intervalos, encontre o intervalo que você quer ativar e clique em Nenhum na coluna Ciclo de vida.

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

  3. Clique em Adicionar regra.

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

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

    2. Clique em Continuar.

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

    4. Clique em Continuar.

    5. Clique em Salvar.

gsutil

  1. Crie um arquivo .json com as regras de configuração do ciclo de vida que você quer aplicar. Veja os exemplos abaixo.

  2. Use o comando lifecycle set para aplicar a configuração, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:

    gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]

APIs REST

API JSON

  1. Consiga um token de acesso de autorização do OAuth 2.0 Playground. 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 os exemplos abaixo.
  3. Use cURL para chamar a API JSON com uma solicitação PATCH Bucket, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:
    curl -X PATCH --data-binary @[LIFECYCLE_CONFIG_FILE].json \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    -H "Content-Type: application/json" \
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

API XML

  1. Consiga um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth.
  2. Crie um corpo de solicitação com as regras de configuração do ciclo de vida que você quer aplicar. Veja os exemplos abaixo.
  3. Use cURL para chamar a API XML com uma solicitação PUT Bucket, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:
    curl -X PUT --data-binary @[XML_FILE].xml \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

Como desativar o gerenciamento do ciclo de vida

Para desativar o gerenciamento do ciclo de vida de um intervalo:

Console

  1. Abra o navegador do Cloud Storage no Console do Google Cloud Platform.
    Abrir o navegador do Cloud Storage
  2. Na lista de intervalos, encontre o intervalo que você quer desativar e clique em Ativado na coluna Ciclo de vida.

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

  3. Clique em Excluir tudo.

  4. Na janela de confirmação que aparecerá, clique em Excluir.

gsutil

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

    {}
  2. Use o comando lifecycle set, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:

    gsutil lifecycle set [LIFECYCLE_CONFIG_FILE] gs://[BUCKET_NAME]

APIs REST

API JSON

  1. Consiga um token de acesso de autorização do OAuth 2.0 Playground. Configure o playground para usar suas credenciais do OAuth.
  2. Crie um arquivo .json com uma configuração de ciclo de vida vazia:
    {}
  3. Use cURL para chamar a API JSON com uma solicitação PATCH Bucket, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:
    curl -X PATCH --data-binary @[LIFECYCLE_CONFIG_FILE].json \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    -H "Content-Type: application/json" \
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

API XML

  1. Consiga um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth.
  2. Crie um corpo da solicitação com uma configuração de ciclo de vida vazia:
    <?xml version="1.0" encoding="UTF-8" ?>
    <LifecycleConfiguration/>
  3. Use cURL para chamar a API XML com uma solicitação PUT Bucket, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:
    curl -X PUT --data-binary @[XML_FILE].xml \
    -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

Como verificar a configuração do ciclo de vida

Para verificar o ajuste da configuração do ciclo de vida em um intervalo:

Console

  1. Abra o navegador do Cloud Storage no Console do Google Cloud Platform.
    Abrir o navegador do Cloud Storage
  2. Na lista de intervalos, localize o status do ciclo de vida de cada intervalo na coluna Ciclo de vida.

    Clique nesse status para adicionar, visualizar, editar e excluir regras.

gsutil

  1. Use o comando lifecycle get, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:

    gsutil lifecycle get gs://[BUCKET_NAME]

APIs REST

API JSON

  1. Consiga um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth. .
  2. Use cURL para chamar a API JSON com uma solicitação GET Bucket, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:
    curl -X GET -H "Authorization: Bearer [OAUTH2_TOKEN]" \
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]?fields=lifecycle"

API XML

  1. Consiga um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth.
  2. Use cURL para chamar a API XML com uma solicitação GET Bucket, substituindo [VALUES_IN_BRACKETS] pelos valores apropriados:
    curl -X GET \
        -H "Authorization: Bearer [OAUTH2_TOKEN]" \
        "https://[BUCKET_NAME].storage.googleapis.com/?lifecycle"

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 exclusão de objetos e a alteração de suas classes de armazenamento quando os critérios comuns são atendidos. Para mais detalhes sobre as configurações do ciclo de vida, incluindo uma lista de ações e condições disponíveis, consulte Gerenciamento do ciclo de vida de objetos.

Excluir um objeto

A seguinte configuração do ciclo de vida define duas regras:

  1. Excluir objetos ativos existentes que tenham mais de 30 dias.
  2. Excluir objetos arquivados com mais de 10 dias. Observe que essa regra só é atendida para os intervalos em que você tem (ou já teve) versões de objeto ativadas.

Console

A regra a seguir exclui objetos ativos que tenham mais de 30 dias:

Excluir objetos ativos existentes que tenham mais de 30 dias.

A regra a seguir exclui objetos arquivados que tenham mais de 10 dias:

Excluir objetos arquivados com mais de 3 versões mais recentes.

gsutil

Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um intervalo:

{
"lifecycle": {
  "rule": [
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 30,
      "isLive": true
    }
  },
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 10,
      "isLive": false
    }
  }
]
}
}

Para ver o formato generalizado de um arquivo de configuração do ciclo de vida, consulte a representação do recurso de intervalos para JSON.

REST APIs

JSON API

Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um intervalo:

{
"lifecycle": {
  "rule": [
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 30,
      "isLive": true
    }
  },
  {
    "action": {"type": "Delete"},
    "condition": {
      "age": 10,
      "isLive": false
    }
  }
]
}
}

Para ver o formato generalizado de um arquivo de configuração do ciclo de vida, consulte a representação do recurso de intervalos para JSON.

XML API

Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um intervalo:

<?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>
            <IsLive>false</IsLive>
            <Age>10</Age>
        </Condition>
    </Rule>
</LifecycleConfiguration>

Para ver o formato generalizado de um arquivo de configuração do 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 sua existência seja maior que 365 dias (um ano) e a classe de armazenamento atual seja Multi-Regional Storage, Standard Storage ou Disponibilidade durável reduzida.
  2. Altere a classe de armazenamento de um objeto para Coldline Storage caso sua existência seja maior que 1.095 dias (três anos) e sua classe de armazenamento atual seja Nearline Storage.

Console

A regra a seguir move objetos para Nearline após 365 dias:

Definir objetos como Nearline após 365 dias.

A regra a seguir move objetos para Coldline após 1095 dias:

Definir objetos como Coldline após 1095 dias.

gsutil

Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um intervalo:

{
"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 generalizado de um arquivo de configuração do ciclo de vida, consulte a representação do recurso de intervalos para JSON.

REST APIs

JSON API

Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um intervalo:

{
"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 generalizado de um arquivo de configuração do ciclo de vida, consulte a representação do recurso de intervalos para JSON.

XML API

Ative o gerenciamento do ciclo de vida para aplicar a configuração do ciclo de vida a seguir a um intervalo:

<?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 generalizado de um arquivo de configuração do ciclo de vida, consulte o formato de configuração de ciclo de vida para XML.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.