Defina localizações de armazenamento predefinidas para resumos com âmbito global

Quando cria instantâneos, estes são criados como instantâneos com âmbito global por predefinição. Para um determinado projeto, pode personalizar a localização predefinida onde Google Cloud armazena as capturas de ecrã com âmbito global configurando as definições de captura de ecrã. A utilização de definições de instantâneos para definir a sua própria predefinição personalizada elimina a necessidade de especificar manualmente uma localização sempre que cria um instantâneo.

Este documento fornece informações sobre as definições de instantâneos e como as usar para personalizar a localização de armazenamento predefinida dos instantâneos com âmbito global do seu projeto.

Para gerir as definições de localização de instantâneos com âmbito regional, consulte o artigo Defina a criação de instantâneos e restaure localizações para instantâneos com âmbito regional (Pré-visualização).

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Limitações

  • Só pode ver e atualizar as definições de instantâneo através da CLI gcloud ou da API REST.
  • Não pode personalizar a localização de armazenamento predefinida das capturas instantâneas. Só o pode fazer para instantâneos padrão e de arquivo.
  • A modificação da política de localização nas definições de instantâneo do seu projeto afeta apenas os instantâneos criados após essa modificação. A atualização das definições do Snapshot do seu projeto não altera a localização de nenhum Snapshot existente.
  • Se especificar manualmente uma localização durante a criação do instantâneo, Google Cloudsubstitui as definições do instantâneo e cria o instantâneo nessa localização especificada recentemente. No entanto, a política de localização de armazenamento nas definições da captura de ecrã permanece inalterada.
  • As localizações de armazenamento predefinidas aplicam-se apenas a capturas de ecrã com âmbito global. Para controlar as localizações de armazenamento de capturas instantâneas com âmbito regional, tem de definir localizações de criação de capturas instantâneas permitidas.
  • A definição de uma localização de armazenamento predefinida controla apenas onde o instantâneo é armazenado. Com as cópias instantâneas com âmbito global, não pode definir onde os dados das cópias instantâneas podem ser restaurados. Para definir localizações permitidas para o restauro de instantâneos, tem de criar um instantâneo regional e definir localizações de restauro permitidas.

Como funcionam as definições de instantâneo

A política de localização de armazenamento das definições de instantâneo de um projeto define onde oGoogle Cloud armazena automaticamente os instantâneos desse projeto Google Cloud.O mantém um valor predefinido para esta política de localização de armazenamento até atualizar as definições de instantâneo e configurar uma nova predefinição. Depois de atualizar as definições de instantâneo e definir uma nova localização de armazenamento predefinida, o Google Cloud StorageGoogle Cloud usa esta localização para armazenar todos os novos instantâneos criados nesse projeto.

Pode atualizar as definições de instantâneo para modificar a política de localização de armazenamento em qualquer altura. No entanto, a modificação das definições de instantâneos do projeto afeta apenas as localizações dos instantâneos criados após essa modificação. A atualização das definições do Snapshot do seu projeto não altera a localização de nenhum dos snapshots existentes.

Para garantir que Google Cloud usa a localização de armazenamento definida nas definições do instantâneo, não especifique manualmente uma localização durante a criação do instantâneo. Se especificar manualmente uma localização durante a criação do instantâneo, Google Cloudsubstitui as definições do instantâneo e cria o instantâneo nessa localização especificada recentemente. No entanto, a política de localização de armazenamento nas definições da captura de ecrã permanece inalterada.

Pode usar as definições de capturas de ecrã para personalizar a localização de armazenamento predefinida das suas capturas de ecrã padrão e de arquivo. Não pode personalizar a localização de armazenamento predefinida das capturas instantâneas.

Opções de localização de armazenamento

Quando configura as definições de instantâneo do projeto e especifica uma nova localização de armazenamento predefinida, pode escolher regiões específicas ou usar definições de localização baseadas em disco. Mais especificamente, pode escolher uma das seguintes opções de localização para a sua política de localização de armazenamento:

  • A região múltipla mais próxima do disco de origem
  • A mesma região local que o disco de origem
  • Regiões específicas à sua escolha

Google Cloud política de localização de armazenamento predefinida

Até atualizar as definições de instantâneo pela primeira vez, Google Cloud mantém um valor predefinido para a política de localização de armazenamento. Esta política predefinida fornece a localização de armazenamento predefinida para as capturas de ecrã até configurar a sua própria localização de armazenamento predefinida atualizando as definições de captura de ecrã do projeto. A política de localização de armazenamento predefinida está definida para a multirregião geograficamente mais próxima da localização do disco de origem.

  • Se o disco de origem estiver numa localização que faça parte de uma multirregião, a política de localização de armazenamento das definições de instantâneos é definida para essa multirregião. Por exemplo, se o seu disco estiver numa localização como us-central1, a localização de armazenamento predefinida é a multirregião us.
  • Para uma localização fora de uma região múltipla, a localização de armazenamento predefinida é a região múltipla geograficamente mais próxima fora dessa região. Para uma localização como australia-southeast1, a localização predefinida torna-se a região múltipla asia.

Implicações de preços

Não tem de pagar nenhum valor adicional para usar as definições de instantâneo para os seus projetos. No entanto, os valores de localização que especificar através das definições de instantâneo afetam outras operações, o que pode, por sua vez, afetar esses custos operacionais.

Defina a localização de armazenamento predefinida para um projeto através das definições de instantâneo

Pode atualizar as definições de instantâneo do projeto e definir uma nova localização de armazenamento predefinida através do REST e da CLI gcloud.

Se não definir uma política de localização de armazenamento nas definições de instantâneo, os instantâneos são criados com a Google Cloud política de localização de armazenamento predefinida.

gcloud

Para adicionar as definições de instantâneo ou atualizar as definições de instantâneo existentes para o 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 localização de armazenamento de instantâneos para o 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 da localização do seu disco.
    • local-region: especifica a política de localização como a mesma região do Cloud Storage onde o disco está localizado.
    • specific-locations: especifica a política de localização como uma região do Cloud Storage personalizada à sua escolha. Se especificar esta opção, também tem de especificar a localização pretendida através da flag --storage-location-names.

  • REGION_NAME: opcional: se incluir a flag --storage-location-policy com um valor de specific-locations, tem de especificar uma região do Cloud Storage. Só pode especificar uma região e esta não pode ser uma multirregião do Cloud Storage. Defina este valor como o nome da região que quer especificar como a sua política de localização de armazenamento.

Exemplos para definir a política de localização de armazenamento através das definições de instantâneo

Considere um projeto de exemplo my-project na região us-central1.

  • Para configurar a política de localização de armazenamento das definições de instantâneo 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 configurar a política de localização de armazenamento das definições de instantâneo do seu projeto como a mesma região do Cloud Storage que o seu disco, execute o seguinte comando:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region
  • Para configurar as definições de instantâneo do seu projeto como uma localização específica à 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 definições de instantâneo ou atualizar as definições de instantâneo existentes para o seu projeto, faça um pedido 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 localização do armazenamento de instantâneos para o 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 da localização do seu disco.
    • LOCAL_REGION: especifica a política de localização como a mesma região do Cloud Storage onde o disco está localizado.
    • SPECIFIC_LOCATIONS: especifica a política de localização como uma região do Cloud Storage personalizada à sua escolha. Se especificar esta opção, também tem de especificar a localização pretendida através do parâmetro locations no seu pedido.

  • REGION_NAME: opcional: se incluir o parâmetro policy com um valor de SPECIFIC_LOCATIONS, tem de especificar uma região do Cloud Storage. Só pode especificar uma região e esta não pode ser uma multirregião do Cloud Storage. Defina este valor como o nome da região que quer especificar como a sua política de localização de armazenamento.

Exemplos para definir a política de localização de armazenamento através das definições de instantâneo

Considere um projeto de exemplo my-project na região us-central1.

  • Para configurar a política de localização de armazenamento das definições de instantâneo do seu projeto como a multirregião do Cloud Storage mais próxima do seu disco, faça o seguinte pedido PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "NEAREST_MULTI_REGION"
      }
    }
  • Para configurar a política de localização de armazenamento das definições de instantâneo do seu projeto como a mesma região do Cloud Storage que o seu disco, faça o seguinte pedido PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Para configurar as definições de instantâneo do seu projeto como a política de localização de armazenamento como uma localização específica (como us-central1), faça o seguinte pedido PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

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

Veja a localização de armazenamento predefinida definida pelas definições de instantâneo de um projeto

Pode ver as definições de instantâneo do seu projeto através da API Compute Engine e da CLI gcloud.

gcloud

Para ver as definições de instantâneo 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.

REST

Para ver as definições de instantâneo do seu projeto, faça um pedido GET ao 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 se segue?