Este documento descreve como proteger instâncias específicas de VM contra exclusão, definindo a propriedade deletionProtection
em um recurso de instância. Para saber mais sobre instâncias de VM, leia a documentação de Instâncias .
Como parte da sua carga de trabalho, pode haver determinadas instâncias de VM que são críticas para a execução do seu aplicativo ou serviços, como uma instância que executa um servidor SQL, um servidor usado como gerenciador de licenças e assim por diante. Essas instâncias de VM podem precisar permanecer em execução indefinidamente, então você precisa de uma maneira de proteger essas VMs contra exclusão.
Ao definir o sinalizador deletionProtection
, uma instância de VM pode ser protegida contra exclusão acidental. Se um usuário tentar excluir uma instância de VM para a qual você definiu o sinalizador deletionProtection
, a solicitação falhará. Somente um usuário que recebeu uma função com permissão compute.instances.create
pode redefinir a sinalização para permitir que o recurso seja excluído.
Antes de começar
- Leia a documentação das instâncias .
- 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
-
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.
- Set a default region and zone.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
A prevenção de exclusão não impede as seguintes ações:
- Encerrar uma instância de dentro da VM (como executar o comando
shutdown
) - Parando uma instância
- Redefinindo uma instância
- Suspender uma instância
- Instâncias sendo removidas devido a fraude e abuso após serem detectadas pelo Google
- Instâncias sendo removidas devido ao encerramento do projeto
- Encerrar uma instância de dentro da VM (como executar o comando
A proteção contra exclusão pode ser aplicada tanto a VMs regulares quanto a VMs preemptivas.
A proteção contra exclusão não pode ser aplicada a VMs que fazem parte de um grupo de instâncias gerenciadas, mas pode ser aplicada a instâncias que fazem parte de grupos de instâncias não gerenciadas.
A prevenção de exclusão não pode ser especificada em modelos de instância.
-
compute.instances.create
-
compute.admin
-
compute.instanceAdmin.v1
No console do Google Cloud, acesse a página Criar uma instância .
Expanda a seção Opções avançadas e faça o seguinte:
- Expanda a seção Gerenciamento .
- Marque a caixa de seleção Ativar proteção contra exclusão .
Continue com o processo de criação da VM.
Acesse a página de instâncias de VM.
Se solicitado, selecione seu projeto e clique em Continuar .
Na página Instâncias de VM , abra o menu Colunas e ative Proteção contra exclusão .
Uma nova coluna aparece com o ícone de proteção contra exclusão. Se uma VM tiver a proteção contra exclusão habilitada, o ícone aparecerá ao lado do nome da instância.
Acesse a página de instâncias de VM.
Se solicitado, selecione seu projeto e clique em Continuar .
Clique no nome da instância para a qual você deseja alternar a proteção contra exclusão. A página de detalhes da instância é exibida.
Na página de detalhes da instância, conclua as etapas a seguir:
- Clique no botão Editar na parte superior da página.
Em Proteção contra exclusão , marque a caixa para ativar ou desmarque a caixa para desativar a proteção contra exclusão.
Salve suas alterações.
- Saiba como interromper uma instância .
- Exclua suas instâncias se não precisar mais delas.
Go
Para usar os exemplos Go desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Java
Para usar os exemplos Java desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Node.js
Para usar os exemplos Node.js desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
PHP
Para usar os exemplos PHP desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
Python
Para usar os exemplos Python desta página em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e e configure o Application Default Credentials com suas credenciais de usuário.
Confira mais informações em Set up authentication for a local development environment.
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.
Especificações
Permissões
Para executar esta tarefa, você deve ter recebido as seguintes permissões OU uma das seguintes funções do IAM no recurso.
Permissões
Funções
Configurando a proteção contra exclusão durante a criação da instância
Por padrão, a proteção contra exclusão está desabilitada para sua instância. Ative a proteção contra exclusão usando as instruções abaixo.
Console
gcloud
Ao criar uma instância de VM , inclua os sinalizadores
--deletion-protection
ouno-deletion-protection
. A proteção contra exclusão está desabilitada por padrão para ativar a proteção contra exclusão:gcloud compute instances create [INSTANCE_NAME] --deletion-protection
onde
[INSTANCE_NAME]
é o nome da instância desejada.Para desativar a proteção contra exclusão durante a criação:
gcloud compute instances create [INSTANCE_NAME] --no-deletion-protection
Ir
Java
Node.js
Pitão
DESCANSAR
Na API, ao criar uma instância de VM , inclua a propriedade
deletionProtection
no corpo da sua solicitação. Por exemplo:POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances { "name": "[INSTANCE_NAME]", "deletionProtection": "true", ... }
Para desativar a proteção contra exclusão, defina
deletionProtection
comofalse
.Determinar se uma instância tem proteção contra exclusão habilitada
Você pode determinar se uma instância tem a proteção contra exclusão ativada na
gcloud tool
ou na API.Console
gcloud
Na CLI gcloud, execute o comando
instances describe
e procure o campo de proteção contra exclusão. Por exemplo:gcloud compute instances describe example-instance | grep "deletionProtection"
A ferramenta retorna o valor da propriedade
deletionProtection
, definida comotrue
oufalse
:deletionProtection: false
Ir
Java
Node.js
Pitão
DESCANSAR
Na API, faça uma solicitação
GET
e procure pelo campodeletionProtection
:GET https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]
Alternando a proteção contra exclusão para instâncias existentes
Você pode alternar a proteção contra exclusão para uma instância existente, independentemente do status atual da instância. Especificamente, você não precisa interromper a instância antes de ativar ou desativar a proteção contra exclusão.
Console
gcloud
Usando a CLI gcloud, execute o comando
update
com o sinalizador--deletion-protection
ou--no-deletion-protection
:gcloud compute instances update [INSTANCE_NAME] \ [--deletion-protection | --no-deletion-protection]
Por exemplo, para ativar a proteção contra exclusão para uma instância chamada
example-vm
:gcloud compute instances update example-vm --deletion-protection
Ir
Java
Node.js
Pitão
DESCANSAR
Na API, faça uma solicitação
POST
para o métodosetDeletionProtection
com o parâmetro de consultadeletionProtection
. Por exemplo:POST https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]/setDeletionProtection?deletionProtection=true
Para desativar a proteção contra exclusão, defina
deletionProtection
comofalse
. Não forneça um corpo de solicitação com a solicitação.O que vem a seguir
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-04-21 UTC.
-