Por padrão, os snapshots são criados como snapshots de escopo global. Para um determinado projeto, é possível personalizar o local padrão em que oTrusted Cloud by S3NS armazena os snapshots com escopo global configurando as configurações de snapshot. Ao usar as configurações de snapshot para definir um padrão personalizado, não é necessário especificar manualmente um local sempre que você cria um 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 com escopo global do projeto.
Para gerenciar as configurações de local dos snapshots com escopo regional, consulte Definir locais de criação e restauração de snapshots com escopo regional (Prévia).
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 Trusted Cloud by S3NS .
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
-
Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
- 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 a CLI gcloud.
Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted Cloud .
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 Trusted Cloud by S3NS vai substituir 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.
- Os locais de armazenamento padrão se aplicam apenas a snapshots com escopo global. Para controlar locais de armazenamento de snapshots regionais, você precisa Definir locais permitidos para criação de snapshots.
- A definição de um local de armazenamento padrão controla apenas onde o snapshot é armazenado. Com snapshots de escopo global, não é possível definir onde os dados de snapshot podem ser restaurados. Para definir locais permitidos para a restauração de snapshots, é necessário 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 onde oTrusted Cloud by S3NS armazena automaticamente os snapshots desse projeto. Trusted Cloud by S3NS mantém um valor predefinido para essa política de local de armazenamento até que você atualize as configurações de snapshot e defina um novo padrão. Depois de atualizar as configurações de snapshot e definir um novo local de armazenamento padrão, oTrusted Cloud by S3NS 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 Trusted Cloud by S3NS 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 Trusted Cloud by S3NS 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
Trusted Cloud by S3NS Política de local de armazenamento predefinida
Até você atualizar as configurações de snapshot pela primeira vez, Trusted Cloud by S3NS 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ãous
. - 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ãoasia
.
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 doTrusted Cloud by S3NS .
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 projetoSTORAGE_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 despecific-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ãous-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étodosnapshotSettings.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 projetoSTORAGE_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âmetrolocations
na solicitação.
REGION_NAME
: opcional: se você incluir o parâmetropolicy
com um valor deSPECIFIC_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ãous-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çãoPATCH
:
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.
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étodosnapshotSettings.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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-08 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-08 UTC."],[[["Snapshot settings allow users to customize the default storage location for their project's snapshots, eliminating the need to specify a location every time a snapshot is created."],["You can customize snapshot storage locations to be the nearest multi-region, the same local region as the source disk, or specific regions of your choice, with the exception that you cannot customize instant snapshots."],["Modifying snapshot settings only affects snapshots created after the change, and manually specifying a location during snapshot creation overrides the project's defined snapshot settings."],["Google Cloud has a predefined storage location policy for snapshots, which defaults to the geographically closest multi-region to the source disk if no custom settings are configured."],["You can use either the `gcloud CLI` or `REST API` to update or view snapshot settings for a project."]]],[]] -