Definir locais de armazenamento padrão para snapshots com escopo global


Quando você cria instantâneos, eles são criados como instantâneos com escopo global por padrão. Para um determinado projeto, você pode personalizar o local padrão ondeGoogle Cloud armazena os snapshots com escopo global definindo as configurações do snapshot. Usar configurações de snapshot para definir seu próprio padrão personalizado elimina a necessidade de especificar manualmente um local sempre que você cria um snapshot.

Este documento fornece informações sobre configurações de snapshot e como usá-las para personalizar o local de armazenamento padrão para os snapshots com escopo global do seu projeto.

Para gerenciar configurações de localização para snapshots com escopo regional, consulte Definir locais de criação e restauração de snapshots para snapshots com escopo regional ( Visualização ).

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command:

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.
    3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Limitações

  • Você pode visualizar e atualizar as configurações de snapshot somente usando a CLI gcloud ou REST.
  • Não é possível personalizar o local de armazenamento padrão de instantâneos. Você só pode fazer isso para snapshots padrão e de arquivo.
  • A modificação da política de localização nas configurações de snapshot do seu projeto afeta apenas os snapshots criados após essa modificação. Atualizar as configurações de snapshot do seu projeto não altera a localização de nenhum snapshot existente.
  • Se você especificar manualmente um local durante a criação do snapshot, então Google Cloudsubstitui as configurações do snapshot e cria seu snapshot naquele local recém-especificado. No entanto, a política de local de armazenamento nas configurações do snapshot permanece inalterada.
  • Os locais de armazenamento padrão aplicam-se apenas a instantâneos com escopo global. Para controlar locais de armazenamento para snapshots com escopo regional, você deve definir locais permitidos para criação de snapshots .
  • A definição de um local de armazenamento padrão controla apenas onde o instantâneo é armazenado. Com instantâneos com escopo global, não é possível definir onde os dados do instantâneo podem ser restaurados. Para definir locais permitidos para restauração de snapshots, você precisa criar um snapshot regional e definir locais de restauração permitidos .

Como funcionam as configurações de snapshot

A política de local de armazenamento das configurações de snapshot de um projeto define ondeGoogle Cloud armazena automaticamente os instantâneos desse projeto. Google Cloudmantém um valor predefinido para esta política de local de armazenamento até que você atualize as configurações de snapshot e configure um novo padrão. Depois de atualizar as configurações do snapshot e definir um novo local de armazenamento padrão,Google Cloud usa esse local para armazenar cada novo instantâneo criado nesse projeto.

Você pode atualizar suas configurações de snapshot para modificar a política de local de armazenamento quantas vezes quiser. No entanto, a modificação das configurações de instantâneo do seu projeto afeta apenas os locais dos instantâneos criados após essa modificação. Atualizar as configurações de snapshot do seu projeto não altera a localização de nenhum snapshot existente.

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

Você pode usar configurações de snapshot para personalizar o local de armazenamento padrão de seus snapshots padrão e de arquivo. Você não pode personalizar o local de armazenamento padrão de instantâneos .

Opções de local de armazenamento

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

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

Google Cloud política de local de armazenamento predefinida

Até você atualizar as configurações do snapshot pela primeira vez, Google Cloudmantém um valor predefinido para a política de local de armazenamento. Esta política predefinida fornece o local de armazenamento padrão para instantâneos até que você configure seu próprio local de armazenamento padrão atualizando as configurações de instantâneo do seu projeto. A política de local de armazenamento predefinida é definida para a multirregião geograficamente mais próxima do local do seu disco de origem.

  • Se o disco de origem estiver em um local que faz parte de uma multirregião, a política de local de armazenamento das configurações de snapshot será definida para essa multirregião. Por exemplo, se o seu disco estiver em um local como us-central1 , o local de armazenamento padrão será us multirregional.
  • 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 de preços

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

Defina o local de armazenamento padrão para um projeto usando configurações de snapshot

Você pode atualizar as configurações de snapshot do seu 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 snapshot, seus snapshots serão criados usando o método Google Cloud política de local de armazenamento predefinida .

gcloud

Para adicionar as configurações de snapshot ou atualizar as configurações de snapshot existentes para seu 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 o seguinte:

  • PROJECT_ID : o ID do projeto.
  • STORAGE_LOCATION : a política de local de armazenamento de instantâneos do seu projeto. O valor pode ser um dos seguintes:

    • nearest-multi-region : especifica a política de localização como a multirregião do Cloud Storage mais próxima do local do seu disco.
    • local-region : especifica a política de localização como a mesma região do Cloud Storage onde seu disco está localizado.
    • specific-locations : especifica a política de localização como um local personalizado da região do Cloud Storage de sua escolha. Se você especificar esta opção, deverá também especificar o local desejado usando o sinalizador --storage-location-names .
  • REGION_NAME : opcional: se você incluir a sinalização --storage-location-policy com um valor de specific-locations , será necessário especificar uma região do Cloud Storage . Você pode especificar apenas uma região e ela não pode ser uma multirregião do Cloud Storage. Configure esse valor para o nome da região que você deseja especificar como sua política de local de armazenamento.

Exemplos para 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 seu projeto como a multirregião do Cloud Storage mais próxima do seu 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 seu projeto como a mesma região do Cloud Storage do seu disco, execute o seguinte comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region
  • Para configurar a política de local de armazenamento das configurações de snapshot do seu projeto como um local específico de sua escolha (como us-central1 ), use o sinalizador --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

DESCANSAR

Para adicionar as configurações de snapshot ou atualizar as configurações de snapshot existentes para seu projeto, faça uma solicitação PATCH ao 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 o seguinte:

  • PROJECT_ID : o ID do projeto.
  • STORAGE_LOCATION : a política de local de armazenamento de instantâneos do seu projeto. O valor pode ser um dos seguintes:

    • NEAREST_MULTI_REGION : especifica a política de localização como a multirregião do Cloud Storage mais próxima do local do seu disco.
    • LOCAL_REGION : especifica a política de localização como a mesma região do Cloud Storage onde seu disco está localizado.
    • SPECIFIC_LOCATIONS : especifica a política de localização como um local personalizado da região do Cloud Storage de sua escolha. Se você especificar essa opção, deverá também especificar o local desejado usando o parâmetro locations em sua solicitação.
  • REGION_NAME : opcional: se você incluir o parâmetro policy com um valor SPECIFIC_LOCATIONS , será necessário especificar uma região do Cloud Storage . Você pode especificar apenas uma região e ela não pode ser uma multirregião do Cloud Storage. Configure esse valor para o nome da região que você deseja especificar como sua política de local de armazenamento.

Exemplos para 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 seu projeto como a multirregião do Cloud Storage mais próxima do seu disco, faça 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 seu projeto como a mesma região do Cloud Storage que seu disco, faça a seguinte solicitação PATCH :
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Para configurar a política de local de armazenamento das configurações de snapshot do seu projeto como um local específico (como us-central1 ), faça 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"}
        }
      }
    }

Visualize o local de armazenamento padrão definido pelas configurações de snapshot de um projeto

Você pode visualizar as configurações de snapshot do seu projeto usando a API Compute Engine e a CLI gcloud.

gcloud

Para visualizar 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 ID do projeto.

DESCANSAR

Para visualizar as configurações de snapshot do seu 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 ID do projeto.

O que vem a seguir