Definir o local de armazenamento padrão usando as configurações de snapshot

Ao criar snapshots, o Google Cloud usa valores padrão predefinidos para opções de configuração, a menos que você forneça explicitamente valores diferentes. As configurações de snapshots são parâmetros de configuração centralizadas no nível do projeto que permitem personalizar o local padrão em que o Google Cloud armazena os snapshots. Ao usar as configurações de snapshot para definir um padrão personalizado, não é necessário especificar manualmente um local durante cada criação de snapshot.

Neste documento, fornecemos informações sobre as configurações de snapshots e como usá-las para personalizar o local de armazenamento padrão dos snapshots do projeto.

Antes de começar

Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

Select the tab for how you plan to use the samples on this page:
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Limitações

Só é possível visualizar e atualizar as configurações de snapshot usando a CLI gcloud ou a REST.
Não é possível personalizar o local de armazenamento padrão dos snapshots instantâneos. Só é possível fazer isso para snapshots padrão e de arquivamento.
A modificação da política de local nas configurações de snapshot do projeto afeta apenas os snapshots criados após essa modificação. Atualizar as configurações de snapshot do projeto não altera o local de nenhum snapshot atual.
Se você especificar manualmente um local durante a criação do snapshot, o Google Cloud vai modificar as configurações e criar o snapshot no local recém-especificado. No entanto, a política de local de armazenamento nas configurações de snapshot permanece inalterada.

Como funcionam as configurações de snapshot

A política de local de armazenamento das configurações de snapshot de um projeto define onde o Google Cloud armazena automaticamente os snapshots desse projeto. O Google Cloud mantém um valor predefinido para essa política de local de armazenamento até que você atualize as configurações do snapshot e defina um novo padrão. Depois de atualizar as configurações de snapshot e definir um novo local de armazenamento padrão, o Google Cloud usará esse local para armazenar todos os novos snapshots criados nesse projeto.

É possível atualizar as configurações de snapshot para modificar a política de local de armazenamento quantas vezes quiser. No entanto, modificar as configurações de snapshot do projeto afeta apenas os locais dos snapshots criados após essa modificação. Atualizar as configurações de snapshot do projeto não altera o local de nenhum snapshot existente.

Para garantir que o Google Cloud use o local de armazenamento definido pelas configurações do snapshot, não especifique um manualmente durante a criação do snapshot. Se você especificar manualmente um local durante a criação do snapshot, o Google Cloud vai substituir as configurações do snapshot e criar o snapshot no local recém-especificado. No entanto, a política de local de armazenamento nas configurações de snapshot permanece inalterada.

Use as configurações de snapshots para personalizar o local de armazenamento padrão dos snapshots padrão e de arquivo. Não é possível personalizar o local de armazenamento padrão de snapshots instantâneos.

Opções de local de armazenamento

Ao definir as configurações de snapshot do projeto e especificar um novo local de armazenamento padrão, é possível escolher regiões específicas ou usar configurações de localização baseadas em disco. Mais especificamente, você pode escolher uma das seguintes opções de local para a política de local de armazenamento:

A multirregião mais próxima do disco de origem
Mesma região local do disco de origem
Regiões específicas de sua escolha

Política de local de armazenamento predefinida do Google Cloud

Até você atualizar as configurações de snapshot pela primeira vez, o Google Cloud mantém um valor predefinido para a política de local de armazenamento. Essa política predefinida fornece o local de armazenamento padrão para snapshots até que você defina o local de armazenamento padrão atualizando as configurações de snapshots do projeto. A política de local de armazenamento predefinida é definida como a multirregião geograficamente mais próxima do local do disco de origem.

Se o disco de origem estiver em um local que faça parte de uma multirregião, a política de local de armazenamento das configurações de snapshots será definida para essa multirregião. Por exemplo, se o disco estiver em um local como us-central1, o local de armazenamento padrão será a multirregião us.
Para um local fora de uma multirregião, o local de armazenamento padrão é a multirregião geograficamente mais próxima fora dessa região. Para um local como australia-southeast1, o local padrão se torna a multirregião asia.

Implicações nos preços

Você não precisa pagar nenhum valor extra para usar as configurações de snapshot nos seus projetos. No entanto, os valores de local especificados usando as configurações de snapshot afetam outras operações, o que, por sua vez, pode afetar esses custos operacionais.

Definir o local de armazenamento padrão de um projeto usando as configurações de snapshot

É possível atualizar as configurações de snapshot do projeto e definir um novo local de armazenamento padrão usando REST e a CLI gcloud.

Se você não definir uma política de local de armazenamento nas configurações de snapshots, eles serão criados usando a política de local de armazenamento predefinida do Google Cloud.

Permissões exigidas para a tarefa

Para executar essa tarefa, é necessário ter permissões:

compute.snapshotSettings.update no projeto

gcloud

Para adicionar as configurações de snapshot ou atualizar as configurações de snapshot do projeto, use o comando gcloud compute snapshot-settings update:

  gcloud compute snapshot-settings update \
      --project=PROJECT_ID \
      --storage-location-policy=STORAGE_LOCATION
      --storage-location-names=REGION_NAME_1,REGION_NAME_2,...

Substitua:

PROJECT_ID: o ID do projeto
STORAGE_LOCATION: a política de local de armazenamento de snapshots do projeto. O papel pode ser um dos seguintes:
- NEAREST_MULTI_REGION: especifica a política de local como a multirregião do Cloud Storage mais próxima do local do disco.
- LOCAL_REGION: especifica a política de localização como a mesma região do Cloud Storage em que o disco está localizado.
- SPECIFIC_LOCATIONS: especifica a política de local como os locais personalizados da região do Cloud Storage de sua escolha. Use a flag --storage-location-names para especificar a lista dos locais escolhidos.
REGION_NAME_1, REGION_NAME_2, ...: os locais específicos que você quer adicionar à política de local de armazenamento. Use a sinalização --storage-location-names e especifique esses locais somente quando especificar SPECIFIC_LOCATIONS como o valor da flag --storage-location-policy.

Exemplos de como definir a política de local de armazenamento usando configurações de snapshot

Considere um exemplo de projeto my-project na região us-central1. Para definir a política de local de armazenamento das configurações de snapshot do projeto como a multirregião do Cloud Storage mais próxima do disco, execute o seguinte comando:

  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=NEAREST_MULTI_REGION

Para o mesmo projeto de exemplo, para definir a política de local de armazenamento das configurações de snapshot do projeto como a mesma região do Cloud Storage que seu disco, execute o seguinte comando:

  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=LOCAL_REGION

No mesmo projeto de exemplo, para definir como a política de local de armazenamento das configurações de snapshot do projeto como locais específicos de sua escolha (como us-central1), use a flag --storage-location-names e execute o seguinte comando:

  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=SPECIFIC_LOCATIONS \
      --storage-location-names=us-central1

REST

Para adicionar as configurações de snapshot ou atualizar as configurações de snapshot do projeto, faça uma solicitação PATCH para o método snapshotSettings.update:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

  {
    "storageLocation": {
      "policy": "STORAGE_LOCATION",
      "locations": {
            "REGION_NAME_1": { "region": "REGION_NAME_1" },
            "REGION_NAME_2": { "region": "REGION_NAME_2" },
            ...
            },
      }
  }

Substitua:

PROJECT_ID: o ID do projeto
STORAGE_LOCATION: a política de local de armazenamento de snapshots do projeto. O papel pode ser um dos seguintes:
- NEAREST_MULTI_REGION: especifica a política de local como a multirregião do Cloud Storage mais próxima do local do disco.
- LOCAL_REGION: especifica a política de localização como a mesma região do Cloud Storage em que o disco está localizado.
- SPECIFIC_LOCATIONS: especifica a política de local como os locais personalizados da região do Cloud Storage de sua escolha. Se você especificar essa opção, também precisará especificar a lista de locais escolhidos usando o parâmetro locations na solicitação.
REGION_NAME_1, REGION_NAME_2, ...: os locais específicos que você quer adicionar à política de local de armazenamento. Use o parâmetro locations e especifique esses locais somente quando definir SPECIFIC_LOCATIONS como o valor do parâmetro policy.

Exemplos de como definir a política de local de armazenamento usando configurações de snapshot

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

  {
    "storageLocation": {
      "policy": "NEAREST_MULTI_REGION",
    }
  }

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

  {
    "storageLocation": {
      "policy": "LOCAL_REGION",
    }
  }

No mesmo projeto de exemplo, para definir como a política de local de armazenamento das configurações de snapshot do projeto como um local específico (como us-central1), execute a seguinte solicitação PATCH:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

  {
    "storageLocation": {
      "policy": "SPECIFIC_LOCATIONS",
      "locations": {
        "us-central1": { "region": "us-central1"},
        }
      }
  }

Conferir o local de armazenamento padrão definido pelas configurações de snapshots de um projeto

É possível visualizar as configurações de snapshot do projeto usando a API Compute Engine e a gcloud CLI.

Permissões exigidas para a tarefa

Para executar essa tarefa, é necessário ter permissões:

compute.snapshotSettings.get no projeto

gcloud

Para acessar as configurações de snapshot do seu projeto, use o comando gcloud compute snapshot-settings describe:

  gcloud compute snapshot-settings describe \
      --project=PROJECT_ID

Substitua PROJECT_ID pelo código do projeto.

REST

Para acessar as configurações de snapshot do projeto, faça uma solicitação GET para o método snapshotSettings.get:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

Substitua PROJECT_ID pelo código do projeto.

A seguir

Saiba como visualizar, excluir e compartilhar snapshots de disco.
Saiba como criar snapshots programados para discos.
Saiba como criar uma imagem de disco com base no snapshot.