Esta página foi traduzida pela API Cloud Translation.

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 selecionando uma das seguintes opções:

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

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 um local personalizado da região do Cloud Storage de sua escolha. Se você especificar essa opção, também precisará especificar o local desejado usando a flag --storage-location-names.
REGION_NAME: opcional: se você incluir a flag --storage-location-policy com um valor de specific-locations, será necessário especificar uma região do Cloud Storage. Só é possível especificar uma região, e ela não pode ser uma região multirregional do Cloud Storage. Defina esse valor como o nome da região que você quer especificar como sua política de local de armazenamento.

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

Para definir como a política de local de armazenamento das configurações de snapshot do projeto como um local específico 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": { "name": "REGION_NAME" }
      }
    }
  }

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 um local personalizado da região do Cloud Storage de sua escolha. Se você especificar essa opção, também precisará especificar o local desejado usando o parâmetro locations na solicitação.
REGION_NAME: opcional: se você incluir o parâmetro policy com um valor de SPECIFIC_LOCATIONS, será necessário especificar uma região do Cloud Storage. Só é possível especificar uma região, e ela não pode ser uma região multirregional do Cloud Storage. Defina esse valor como o nome da região que você quer especificar como sua política de local de armazenamento.

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 a seguinte solicitação PATCH:

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

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

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 a seguinte solicitação PATCH:

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

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

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": { "name": "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.