Definir locais de criação e restauração para snapshots com escopo regional

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Por padrão, os snapshots são criados com escopo global. Os instantâneos com escopo global são armazenados em um local de armazenamento específico e podem ser restaurados (usados ​​para criar um novo disco) em qualquer região ou zona. Para controle adicional de isolamento baseado em localização, você pode criar instantâneos com escopo regional. Os instantâneos com escopo regional armazenam todos os dados e metadados do instantâneo juntos na região com escopo definido. Com instantâneos com escopo regional, você também pode restringir as regiões onde pode criar e restaurar instantâneos.

Este documento explica como definir locais permitidos para criação e restauração de snapshots regionais.

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:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  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.

  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

• A definição de um escopo regional substitui todas as configurações de local de armazenamento padrão do projeto.
• A definição de um escopo regional aplica-se somente a novos instantâneos regionais.
• Não é possível converter um instantâneo com escopo global em um instantâneo com escopo regional. Você deve criar uma nova captura instantânea com o escopo apropriado.

Funções e permissões necessárias

Para obter as permissões necessárias para definir locais de armazenamento e restauração para snapshots com escopo regional, peça ao administrador para conceder a você as seguintes funções do IAM no projeto:

• Administrador de instância do Compute (v1) ( roles/compute.instanceAdmin.v1 )
• Para se conectar a uma VM que pode ser executada como uma conta de serviço: Usuário da conta de serviço (v1) ( roles/iam.serviceAccountUser )

Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Essas funções predefinidas contêm as permissões necessárias para definir locais de criação e restauração de snapshots. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

Definir locais permitidos para criação de snapshots

Por padrão, você pode criar snapshots em todas as regiões. Para restringir onde você pode criar instantâneos com escopo regional, defina locais de acesso permitidos no nível do projeto. Depois de definir os locais de acesso, você poderá criar instantâneos com escopo regional para o projeto somente nesses locais.

  gcloud beta compute disk-settings update \
      --zone=ZONE_A \
      --access-location-policy=all-regions \

  gcloud beta compute disk-settings update \
      --region=REGION_A \
      --access-location-policy=all-regions

  gcloud beta compute disk-settings update \
      --access-location-policy=specific-regions \
      --region=REGION_A \
      --add-access-locations=REGION_B

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE_A/diskSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"ALL_REGIONS"
    }
  }

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION_A/diskSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"SPECIFIC_REGIONS",
      "locations":
      {
        "REGION_B":{"region":"REGION_B"}
      }
    }
  }

Definir locais permitidos para restauração de snapshots

Por padrão, você pode restaurar snapshots com escopo regional e global para qualquer região. Para configurar locais de restauração para seus instantâneos com escopo regional, defina locais de acesso permitidos no nível do projeto. Você deve definir locais de acesso permitidos para cada projeto individualmente. Depois de definir os locais de acesso, você poderá restaurar snapshots com escopo regional para o projeto somente nesses locais.

  gcloud beta compute snapshot-settings update \
      --project=PROJECT_ID \
      --region=REGION_A \
      --access-location-policy=all-regions

  gcloud beta compute snapshot-settings update \
      --project=PROJECT_ID \
      --access-location-policy=specific-regions \
      --region=REGION_A \
      --add-access-locations=REGION_B

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/snapshotSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"ALL_REGIONS"
    }
  }

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/snapshotSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"SPECIFIC_REGIONS",
      "locations":
        {"REGION_B":
          {"region":"REGION_B"}
        }
    }
  }

Editar locais permitidos para restauração de snapshots

  gcloud beta compute snapshot-settings describe \
      --project=PROJECT_ID \
      --region=REGION_A

  gcloud beta compute snapshot-settings update \
      --project=PROJECT_ID \
      --access-location-policy=specific-regions \
      --remove-access-locations=REGION_B \
      --region=REGION_A

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

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/snapshotSettings?updateMask=accessLocation

  {
    "accessLocation":
    {
      "policy":"SPECIFIC_REGIONS",
      "locations":
        {"REGION_B":{}}
    }
  }