Neste documento, explicamos como suspender e interromper instâncias de máquina virtual (VM) em um grupo gerenciado de instâncias (MIG) e como retomar a operação delas.
Antes de começar
- Consulte a página introdutória sobre VMs suspensas e interrompidas em um MIG.
-
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 da seguinte maneira.
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Defina uma região e uma zona padrão.
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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
Suspender VMs específicas em um MIG
É possível suspender uma VM em execução em um MIG usando o console do Google Cloud, a CLI do Google Cloud ou a API Compute Engine.
Console
- No Console do Google Cloud, acesse a página Grupos de instâncias.
- Clique no nome do grupo de instâncias em que você quer suspender as VMs.
- Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs que você quer suspender.
- Clique em Suspender.
- Na caixa de diálogo de confirmação, clique em Suspender para confirmar.
gcloud
Use o
comando beta instance-groups managed suspend-instances
.
gcloud beta compute instance-groups managed suspend-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua:
MIG_NAME
: o nome do MIG em que uma instância será suspensa.INSTANCE_NAME
: o nome da instância a ser suspensa. Para suspender várias instâncias, forneça uma lista de nomes separados por vírgulas.REGION
: para um MIG regional, a região em que o MIG está localizado.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.
API
Use o
método beta.instanceGroupManager.suspendInstances
e especifique as instâncias no corpo da solicitação.
Para MIGs regionais, use o
método beta.regionInstanceGroupManager.suspendInstances
.
POST https://www.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/suspendInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua:
PROJECT_ID
: o ID do projeto para a solicitação.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.zones/ZONE
porregions/REGION
e especifique a região do MIG se ele for regional;
MIG_NAME
: o nome do MIG em que uma instância será suspensa.INSTANCE_NAME_URL
: o URL da instância a ser suspensa, por exemplo,zones/us-central1-a/instances/example-instance-name1
. Para suspender várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo,"zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2"
.
Retomar VMs selecionadas em um MIG
É possível retomar uma VM suspensa em um MIG usando o console do Google Cloud, a gcloud CLI ou a API Compute Engine.
Console
- No Console do Google Cloud, acesse a página Grupos de instâncias.
- Clique no nome do grupo de instâncias em que você quer retomar as VMs.
- Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs suspensas que você quer retomar e clique em Iniciar/Retomar.
gcloud
Use o
comando beta instance-groups managed resume-instances
.
gcloud beta compute instance-groups managed resume-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua:
MIG_NAME
: o nome do MIG em que uma instância será retomada.INSTANCE_NAME
: o nome da instância a ser retomada. Para retomar várias instâncias, forneça uma lista de nomes separados por vírgulas.REGION
: para um MIG regional, a região em que o MIG está localizado.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.
API
Use o
método beta.instanceGroupManager.resumeInstances
e especifique as instâncias no corpo da solicitação.
Para MIGs regionais, use o
método beta.regionInstanceGroupManager.resumeInstances
.
POST https://www.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resumeInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua:
PROJECT_ID
: o ID do projeto para a solicitação.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.zones/ZONE
porregions/REGION
e especifique a região do MIG se ele for regional;
MIG_NAME
: o nome do MIG em que uma instância será retomada.INSTANCE_NAME_URL
: o URL da instância a ser retomada, por exemplo,zones/us-central1-a/instances/example-instance-name1
. Para retomar várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo,"zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2"
.
Interromper VMs selecionadas em um MIG
É possível interromper uma VM em execução em um MIG usando o console do Google Cloud, a CLI do Google Cloud ou a API Compute Engine.
Console
- No Console do Google Cloud, acesse a página Grupos de instâncias.
- Clique no nome do grupo de instâncias em que você quer interromper as VMs.
- Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs que você quer interromper e clique em Interromper.
- Na caixa de diálogo de confirmação que aparece, clique em Interromper para confirmar.
gcloud
Use o
comando beta instance-groups managed stop-instances
.
gcloud beta compute instance-groups managed stop-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua:
MIG_NAME
: o nome do MIG em que uma instância será interrompida.INSTANCE_NAME
: o nome da instância a ser interrompida. Para interromper várias instâncias, forneça uma lista de nomes separados por vírgulas.REGION
: para um MIG regional, a região em que o MIG está localizado.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.
API
Use o
método beta.instanceGroupManager.stopInstances
e especifique as instâncias no corpo da solicitação.
Para MIGs regionais, use o
método beta.regionInstanceGroupManager.stopInstances
.
POST https://www.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/stopInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua:
PROJECT_ID
: o ID do projeto para a solicitação.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.zones/ZONE
porregions/REGION
e especifique a região do MIG se ele for regional;
MIG_NAME
: o nome do MIG em que uma instância será interrompida.INSTANCE_NAME_URL
: o URL da instância a ser interrompida, por exemplo,zones/us-central1-a/instances/example-instance-name1
. Para interromper várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo,"zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2"
.
Iniciar VMs selecionadas em um MIG
É possível iniciar uma VM interrompida em um MIG usando o console do Google Cloud, a gcloud CLI ou a API Compute Engine.
Console
- No Console do Google Cloud, acesse a página Grupos de instâncias.
- Clique no nome do grupo de instâncias em que você quer iniciar as VMs.
- Na página Visão geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs suspensas que você quer retomar e clique em Iniciar/Retomar.
gcloud
Use o
comando beta instance-groups managed start-instances
.
gcloud beta compute instance-groups managed start-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua:
MIG_NAME
: o nome do MIG em que uma instância será iniciada.INSTANCE_NAME
: o nome da instância a ser iniciada. Para iniciar várias instâncias, forneça uma lista de nomes separados por vírgulas.REGION
: para um MIG regional, a região em que o MIG está localizado.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.
API
Use o
método beta.instanceGroupManager.startInstances
e especifique as instâncias no corpo da solicitação.
Para MIGs regionais, use o
método beta.regionInstanceGroupManager.startInstances
.
POST https://www.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/startInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua:
PROJECT_ID
: o ID do projeto para a solicitação.ZONE
: para um MIG zonal, a zona em que o MIG está localizado.zones/ZONE
porregions/REGION
e especifique a região do MIG se ele for regional;
MIG_NAME
: o nome do MIG em que uma instância será iniciada.INSTANCE_NAME_URL
: o URL da instância a ser iniciada. Por exemplo,zones/us-central1-a/instances/example-instance-name1
. Para iniciar várias instâncias, forneça uma lista de URLs separados por vírgulas, por exemplo,"zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2"
.