Este documento explica como suspender e parar instâncias de máquinas virtuais (VMs) num grupo de instâncias geridas (GIG) e como retomar o respetivo funcionamento.
Antes de começar
- Reveja a página de introdução sobre as VMs suspensas e paradas num MIG.
-
Se ainda não o tiver feito, configure a autenticação.
A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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
-
Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
gcloud init
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
- Set a default region and zone.
REST
Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.
Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
gcloud init
Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.
Suspenda VMs específicas num MIG
Pode suspender uma VM em execução num MIG através da Google Cloud consola, da CLI Google Cloud ou da API Compute Engine.
Consola
- Na Google Cloud consola, aceda à página Grupos de instâncias.
- Clique no nome do grupo de instâncias onde quer suspender as VMs.
- Na página Vista geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs que quer suspender.
- Clique em Suspender.
- Na caixa de diálogo de confirmação apresentada, clique em Suspender para confirmar.
gcloud
Use o comando
instance-groups managed suspend-instances
.gcloud compute instance-groups managed suspend-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua o seguinte:
MIG_NAME
: o nome do MIG no qual suspender uma instância.INSTANCE_NAME
: o nome da instância a suspender. Para suspender várias instâncias, indique uma lista de nomes separados por vírgulas.REGION
: para um GIG regional, a região onde o GIG está localizado.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.
REST
Use o método
instanceGroupManager.suspendInstances
e especifique as instâncias no corpo do pedido. Para GIGs regionais, use o métodoregionInstanceGroupManager.suspendInstances
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/suspendInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua o seguinte:
PROJECT_ID
: o ID do projeto do pedido.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.- Para um MIG regional, substitua
zones/ZONE
porregions/REGION
e especifique a região do MIG.
- Para um MIG regional, substitua
MIG_NAME
: o nome do MIG no qual suspender uma instância.INSTANCE_NAME_URL
: o URL da instância a suspender, 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"
.
Retome VMs selecionadas num MIG
Pode retomar uma VM suspensa num MIG através da Google Cloud consola, da CLI gcloud ou da API Compute Engine.
Consola
- Na Google Cloud consola, aceda à página Grupos de instâncias.
- Clique no nome do grupo de instâncias onde quer retomar as VMs.
- Na página Vista geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs suspensas que quer retomar e, de seguida, clique em Iniciar/Retomar.
gcloud
Use o comando
instance-groups managed resume-instances
.gcloud compute instance-groups managed resume-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua o seguinte:
MIG_NAME
: o nome do MIG no qual retomar uma instância.INSTANCE_NAME
: o nome da instância a retomar. Para retomar várias instâncias, indique uma lista de nomes separados por vírgulas.REGION
: para um GIG regional, a região onde o GIG está localizado.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.
REST
Use o método
instanceGroupManager.resumeInstances
e especifique as instâncias no corpo do pedido. Para GIGs regionais, use o métodoregionInstanceGroupManager.resumeInstances
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resumeInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua o seguinte:
PROJECT_ID
: o ID do projeto do pedido.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.- Para um MIG regional, substitua
zones/ZONE
porregions/REGION
e especifique a região do MIG.
- Para um MIG regional, substitua
MIG_NAME
: o nome do MIG no qual retomar uma instância.INSTANCE_NAME_URL
: o URL da instância a retomar, por exemplo,zones/us-central1-a/instances/example-instance-name1
. Para retomar várias instâncias, forneça uma lista de URLs separada por vírgulas. Por exemplo,"zones/us-central1-a/instances/example-instance-name1","zones/us-central1-a/instances/example-instance-name2"
.
Pare VMs selecionadas num MIG
Pode parar uma VM em execução num MIG através da Google Cloud consola, da CLI Google Cloud ou da API Compute Engine.
Consola
- Na Google Cloud consola, aceda à página Grupos de instâncias.
- Clique no nome do grupo de instâncias onde quer parar as VMs.
- Na página Vista geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs que quer parar e, de seguida, clique em Parar. Se não existir a opção Parar, clique em Mais ações > Parar.
- Na caixa de diálogo de confirmação apresentada, clique em Parar para confirmar.
gcloud
Use o comando
instance-groups managed stop-instances
.gcloud compute instance-groups managed stop-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua o seguinte:
MIG_NAME
: o nome do MIG no qual parar uma instância.INSTANCE_NAME
: o nome da instância a parar. Para parar várias instâncias, indique uma lista de nomes separados por vírgulas.REGION
: para um GIG regional, a região onde o GIG está localizado.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.
REST
Use o método
instanceGroupManager.stopInstances
e especifique as instâncias no corpo do pedido. Para GIGs regionais, use o métodoregionInstanceGroupManager.stopInstances
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/stopInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua o seguinte:
PROJECT_ID
: o ID do projeto do pedido.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.- Para um MIG regional, substitua
zones/ZONE
porregions/REGION
e especifique a região do MIG.
- Para um MIG regional, substitua
MIG_NAME
: o nome do MIG no qual parar uma instância.INSTANCE_NAME_URL
: o URL da instância a parar, por exemplo,zones/us-central1-a/instances/example-instance-name1
. Para parar várias instâncias, indique 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"
.
Inicie VMs selecionadas num MIG
Pode iniciar uma VM parada num MIG através da Google Cloud consola, da CLI gcloud ou da API Compute Engine.
Consola
- Na Google Cloud consola, aceda à página Grupos de instâncias.
- Clique no nome do grupo de instâncias onde quer iniciar VMs.
- Na página Vista geral do grupo de instâncias, em Instâncias de VM, selecione todas as VMs paradas que quer iniciar, e, de seguida, clique em Iniciar/Retomar.
gcloud
Use o comando
instance-groups managed start-instances
.gcloud compute instance-groups managed start-instances MIG_NAME \ --instances=INSTANCE_NAME \ [--region=REGION | --zone=ZONE]
Substitua o seguinte:
MIG_NAME
: o nome do MIG no qual iniciar uma instância.INSTANCE_NAME
: o nome da instância a iniciar. Para iniciar várias instâncias, indique uma lista de nomes separados por vírgulas.REGION
: para um GIG regional, a região onde o GIG está localizado.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.
REST
Use o método
instanceGroupManager.startInstances
e especifique as instâncias no corpo do pedido. Para GIGs regionais, use o métodoregionInstanceGroupManager.startInstances
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/startInstances { "instances": [ "INSTANCE_NAME_URL" ] }
Substitua o seguinte:
PROJECT_ID
: o ID do projeto do pedido.ZONE
: para um GIG zonal, a zona onde o GIG está localizado.- Para um MIG regional, substitua
zones/ZONE
porregions/REGION
e especifique a região do MIG.
- Para um MIG regional, substitua
MIG_NAME
: o nome do MIG no qual iniciar uma instância.INSTANCE_NAME_URL
: o URL da instância a iniciar, 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"
.
O que se segue?
- Saiba como acelerar a expansão com o conjunto de espera.
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-09-19 UTC.
-