Este documento explica como impedir que as instâncias do Compute Engine consumam reservas. Para saber mais sobre reservas, consulte Reservas para recursos zonais do Compute Engine.
As reservas consumidas automaticamente permitem que instâncias com propriedades correspondentes as consumam automaticamente. Para impedir que as instâncias consumam uma reserva, faça uma das seguintes ações:
Configure as instâncias para não consumir reservas, conforme descrito neste documento.
Crie ou atualize instâncias com propriedades que não correspondem à reserva.
É possível evitar o consumo de reservas quando você quer usar as instâncias para tarefas como testes, depuração ou implantações isoladas.
Limitações
Só é possível atualizar uma instância para que ela não consuma reservas se a instância estiver configurada para consumir automaticamente reservas correspondentes.
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 Google Cloud .
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:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
-
Para criar reservas:
compute.reservations.create
no projeto -
Para criar instâncias:
compute.instances.create
no projeto- Para usar uma imagem personalizada para criar a VM:
compute.images.useReadOnly
na imagem - Usar um snapshot para criar a VM:
compute.snapshots.useReadOnly
no snapshot - Usar um modelo de instância para criar a VM:
compute.instanceTemplates.useReadOnly
no modelo de instância - Atribuir uma rede legada à VM:
compute.networks.use
no projeto - Especificar um endereço IP estático para a VM:
compute.addresses.use
no projeto - Atribuir um endereço IP externo à VM ao usar uma rede legada:
compute.networks.useExternalIp
no projeto - Especificar uma sub-rede para a VM:
compute.subnetworks.use
no projeto ou na sub-rede escolhida - Atribuir um endereço IP externo à VM ao usar uma rede VPC:
compute.subnetworks.useExternalIp
no projeto ou na sub-rede escolhida - Definir os metadados da instância de VM para a VM:
compute.instances.setMetadata
no projeto - Definir tags para a VM:
compute.instances.setTags
na VM - Definir rótulos para a VM:
compute.instances.setLabels
na VM - Definir uma conta de serviço para a VM usar:
compute.instances.setServiceAccount
na VM - Criar um disco para a VM:
compute.disks.create
no projeto - Anexar um disco atual no modo somente leitura ou de leitura e gravação:
compute.disks.use
no disco - Anexar um disco atual no modo somente leitura:
compute.disks.useReadOnly
no disco
-
Para criar modelos de instância:
compute.instanceTemplates.create
no projeto Crie um arquivo YAML vazio.
Para exportar as propriedades de uma instância para o arquivo YAML que você acabou de criar, use o comando
gcloud compute instances export
:gcloud compute instances export INSTANCE_NAME \ --destination=YAML_FILE \ --zone=ZONE
Substitua:
INSTANCE_NAME
: o nome da instância.YAML_FILE
: o caminho para o arquivo YAML vazio que você criou na etapa anterior.ZONE
: a zona em que a instância existe.
No arquivo de configuração YAML, defina
consumeReservationType
comoNO_RESERVATION
:reservationAffinity: consumeReservationType: NO_RESERVATION
Para atualizar e reiniciar a instância, use o comando
gcloud compute instances update-from-file
com a flag--most-disruptive-allowed-action
definida comoRESTART
:gcloud compute instances update-from-file INSTANCE_NAME \ --most-disruptive-allowed-action=RESTART \ --source=YAML_FILE \ --zone=ZONE
Substitua:
INSTANCE_NAME
: o nome da instância.YAML_FILE
: o caminho para o arquivo YAML com os dados de configuração que você modificou na etapa anterior.ZONE
: a zona em que a instância existe.
Para conferir as propriedades de uma instância, faça uma solicitação
GET
para o métodoinstances.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Substitua:
PROJECT_ID
: o ID do projeto em que você criou a instância.ZONE
: a zona em que a instância existe.INSTANCE_NAME
: o nome da instância.
Armazene a saída da solicitação
GET
em um arquivo ou editor de texto. Modifique a saída copiada para mudar o campoconsumeReservationType
paraNO_RESERVATION
:{ ... "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, ... }
Para atualizar e reiniciar a instância, faça uma solicitação
PUT
para o métodoinstances.update
. Na solicitação, faça o seguinte:No URL da solicitação, inclua o parâmetro de consulta
mostDisruptiveAllowedAction
definido comoRESTART
.Para o corpo da solicitação, use a saída da solicitação
GET
que você editou em uma etapa anterior.
A solicitação é semelhante ao exemplo a seguir:
PUT https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central-1/instances/instance-01?mostDisruptiveAllowedAction=RESTART { ... "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, ... }
No console do Google Cloud, acesse a página Criar uma instância.
No campo Nome, insira um nome para a instância.
Nas listas Região e Zona, selecione a região e a zona em que a instância será criada.
Especifique o tipo de máquina a ser usado para a instância.
No menu de navegação, clique em Avançado.
Na seção Reservas, selecione Não usar uma reserva.
Clique em Criar.
INSTANCE_NAME
: o nome da instância.MACHINE_TYPE
: o tipo de máquina a ser usado para a instância.ZONE
: a zona em que a instância será criada.PROJECT_ID
: o ID do projeto em que você quer criar a instância.ZONE
: a zona em que a instância será criada.INSTANCE_NAME
: o nome da instância.MACHINE_TYPE
: o tipo de máquina a ser usado para a instância.IMAGE_PROJECT
: o projeto de imagem que contém a imagem do SO, por exemplo,debian-cloud
. Para mais informações sobre os projetos de imagem com suporte, consulte Imagens públicas.IMAGE
: especifique uma destas opções:Uma versão específica da imagem do SO. Por exemplo,
debian-12-bookworm-v20240617
.Uma família de imagens, que precisa ser formatada como
family/IMAGE_FAMILY
. Especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, a versão mais recente na família de imagens do Debian 12 será usada. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
COUNT
: o número de instâncias a serem criadas.MACHINE_TYPE
: o tipo de máquina a ser usado para as instâncias.NAME_PATTERN
: o padrão de nome das instâncias. Para substituir uma sequência de números no nome de uma instância, use uma sequência de caracteres hash (#
). Por exemplo, usarinstance-#
para o padrão de nome gera instâncias com nomes que começam cominstance-1
,instance-2
e continuam até o número de instâncias especificado porCOUNT
.ZONE
: a zona em que as instâncias serão criadas em massa.PROJECT_ID
: o ID do projeto em que as instâncias serão criadas em massa.ZONE
: a zona em que as instâncias serão criadas em massa.COUNT
: o número de instâncias a serem criadas.NAME_PATTERN
: o padrão de nome das instâncias. Para substituir uma sequência de números no nome de uma instância, use uma sequência de caracteres hash (#
). Por exemplo, usarinstance-#
para o padrão de nome gera instâncias com nomes que começam cominstance-1
,instance-2
e continuam até o número de instâncias especificado porCOUNT
.MACHINE_TYPE
: o tipo de máquina a ser usado para as instâncias.IMAGE_PROJECT
: o projeto de imagem que contém a imagem do SO, por exemplo,debian-cloud
. Para mais informações sobre os projetos de imagem com suporte, consulte Imagens públicas.IMAGE
: especifique uma destas opções:Uma versão específica da imagem do SO. Por exemplo,
debian-12-bookworm-v20240617
.Uma família de imagens, que precisa ser formatada como
family/IMAGE_FAMILY
. Especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, a versão mais recente na família de imagens do Debian 12 será usada. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
Impeça que as instâncias de computação em um grupo gerenciado de instâncias (MIG) consumam reservas ao fazer o seguinte:
No console do Google Cloud, acesse a página Criar um modelo de instância.
No campo Nome, insira um nome para o modelo de instância.
Na seção Local, especifique se você quer criar um modelo de instância regional (padrão) ou global.
Na seção Configuração da máquina, especifique o tipo de máquina a ser usado nas instâncias criadas com o modelo.
Expanda a seção Opções avançadas e depois faça o seguinte:
Expanda a seção Gerenciamento.
Na seção Reservas, selecione Não usar uma reserva.
Clique em Criar.
INSTANCE_TEMPLATE_NAME
: o nome do modelo de instância.REGION
: a região em que o modelo de instância será criado.MACHINE_TYPE
: o tipo de máquina a ser usado para as instâncias criadas usando o modelo de instância.Para criar um modelo de instância global: método
instanceTemplates.insert
.Para criar um modelo de instância regional: método
regionInstanceTemplates.insert
.PROJECT_ID
: o ID do projeto em que o modelo de instância será criado.INSTANCE_TEMPLATE_NAME
: o nome do modelo de instância.MACHINE_TYPE
: o tipo de máquina a ser usado para as instâncias criadas usando o modelo de instância.IMAGE_PROJECT
: o projeto de imagem que contém a imagem do SO, por exemplo,debian-cloud
. Para mais informações sobre os projetos de imagem com suporte, consulte Imagens públicas.IMAGE
: especifique uma destas opções:Uma versão específica da imagem do SO. Por exemplo,
debian-12-bookworm-v20240617
.Uma família de imagens, que precisa ser formatada como
family/IMAGE_FAMILY
. Especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificarfamily/debian-12
, a versão mais recente na família de imagens do Debian 12 será usada. Para mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens.
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.
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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Funções exigidas
Para receber as permissões necessárias a fim de impedir que uma instância de computação consuma reservas, peça ao administrador para conceder a você o papel do IAM de Administrador da instância da computação (v1) (
roles/compute.instanceAdmin.v1
) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.Esse papel predefinido contém as permissões necessárias para impedir que uma instância de computação consuma reservas. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para impedir que uma instância de computação consuma reservas:
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Impedir o consumo de reserva
Para impedir que uma instância de computação consuma reservas, defina a propriedade de afinidade de reserva (
reservationAffinity
) para não consumir reservas. Essa propriedade controla se uma instância pode consumir reservas correspondentes, uma reserva específica ou nenhuma reserva.Para impedir que uma ou mais instâncias consumam reservas, use um dos seguintes métodos:
Impedir o consumo em uma instância atual
É possível atualizar uma instância em execução para que ela não consuma reservas automaticamente. É necessário reiniciar a instância para que as mudanças entrem em vigor, conforme descrito nesta seção.
Para impedir que uma instância consuma reservas, selecione uma das seguintes opções:
gcloud
REST
Para mais informações sobre como atualizar uma instância, consulte Atualizar propriedades da instância.
Impedir o consumo ao criar uma instância
Para criar uma instância de computação que não possa consumir reservas, selecione uma das seguintes opções:
Console
gcloud
Para criar uma instância que não possa consumir reservas, use o comando
gcloud compute instances create
com a flag--reservation-affinity
definida comonone
:gcloud compute instances create INSTANCE_NAME \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none \ --zone=ZONE
Substitua:
Go
Para criar uma instância que não pode consumir reservas, use o seguinte exemplo de código:
Java
Para criar uma instância que não pode consumir reservas, use o seguinte exemplo de código:
Node.js
Para criar uma instância que não pode consumir reservas, use o seguinte exemplo de código:
Python
Para criar uma instância que não pode consumir reservas, use o seguinte exemplo de código:
REST
Para criar uma instância que não possa consumir reservas, faça uma solicitação
POST
para o métodoinstances.insert
. No corpo da solicitação, inclua o campoconsumeReservationType
definido comoNO_RESERVATION
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } }
Substitua:
Para mais informações sobre como criar uma instância, consulte Criar e iniciar uma instância do Compute Engine.
Impedir o consumo ao criar instâncias em massa
Para criar instâncias de computação em massa que não podem consumir reservas, selecione uma das seguintes opções:
gcloud
Para criar instâncias em massa que não podem consumir reservas, use o comando
gcloud compute instances bulk create
com a flag--reservation-affinity
definida comonone
.Por exemplo, para criar instâncias em massa em uma única zona e especificar um padrão de nome, execute o seguinte comando:
gcloud compute instances bulk create \ --count=COUNT \ --machine-type=MACHINE_TYPE \ --name-pattern="NAME_PATTERN" \ --reservation-affinity=none \ --zone=ZONE
Substitua:
REST
Para criar instâncias em massa que não podem consumir reservas, faça uma solicitação
POST
para o métodoinstances.bulkInsert
. No corpo da solicitação, inclua o campoconsumeReservationType
definido comoNO_RESERVATION
.Por exemplo, para criar instâncias em massa em uma única zona e especificar um padrão de nome, faça uma solicitação da seguinte maneira:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert { "count": COUNT, "namePattern": "NAME_PATTERN", "instanceProperties": { "machineType": "MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } } }
Substitua:
Para mais informações sobre a criação de instâncias em massa, consulte Criar VMs em massa.
Impedir o consumo ao criar um modelo de instância
Depois de criar um modelo de instância que configura instâncias para não consumir reservas, é possível usar o modelo para fazer o seguinte:
Para criar um modelo de instância que configure as instâncias para não consumir reservas, selecione uma das seguintes opções:
Console
gcloud
Para criar um modelo de instância que configure instâncias para não consumir reservas, use o comando
gcloud compute instances-templates create
com a flag--reservation-affinity
definida comonone
.Para criar um modelo de instância regional que configure as instâncias para não consumir reservas, execute o comando abaixo. Se você quiser criar um modelo de instância global, use o mesmo comando sem a flag
--instance-template-region
.gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none
Substitua:
Go
Para criar um modelo de instância que configure instâncias para não consumir reservas, use o seguinte exemplo de código:
Java
Para criar um modelo de instância que configure instâncias para não consumir reservas, use o seguinte exemplo de código:
Node.js
Para criar um modelo de instância que configure instâncias para não consumir reservas, use o seguinte exemplo de código:
Python
Para criar um modelo de instância que configure instâncias para não consumir reservas, use o seguinte exemplo de código:
REST
Para criar um modelo de instância que configure instâncias para não consumir reservas, faça uma solicitação
POST
para um dos seguintes métodos:No corpo da solicitação, inclua o campo
consumeReservationType
e defina-o comoNO_RESERVATION
.Por exemplo, para criar um modelo de instância regional e especificar que não consome reservas, faça uma solicitação da seguinte maneira:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/InstanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "machineType": "MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } } }
Substitua:
Para mais informações sobre como criar modelos de instância, consulte Como criar modelos de instância.
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-03-04 UTC.
-