Este documento explica como conferir as configurações e o progresso de um desligamento normal em uma instância do Compute Engine. Para saber mais sobre o encerramento gradual, consulte Visão geral do encerramento gradual.
Ao visualizar os detalhes de uma instância, é possível fazer o seguinte:
Ver as configurações de encerramento completo. Você pode verificar se o desligamento normal está ativado e quanto tempo ele dura.
Monitorar o encerramento completo. Quando um encerramento sem dificuldades está em andamento, você pode verificar o seguinte:
Quando o processo de encerramento normal expira.
Se uma operação de interrupção ou exclusão estiver em andamento.
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:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
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 .
Funções exigidas
Para receber a permissão necessária para conferir o encerramento normal de uma instância de computação, 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 a permissão
compute.instances.get
on the projectTambém é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.
Ver configurações de desligamento normal
Para conferir as configurações de desligamento normal em uma instância de computação, selecione uma das seguintes opções:
Console
No Trusted Cloud console, acesse a página Instâncias de VM:
Na coluna Nome, clique no nome da instância.
A página de detalhes da instância é aberta na guia Detalhes.
Para verificar as configurações de desligamento otimizado, na seção Políticas de disponibilidade, confira o valor do campo Duração máxima do desligamento otimizado. Esse campo mostra o período de desligamento normal. Se mostrar um hífen (-), o desligamento normal estará desativado.
gcloud
Para conferir as configurações de encerramento normal em uma instância, use o comando
gcloud beta compute instances describe
:gcloud beta compute instances describe INSTANCE_NAME \ --zone=ZONE
Substitua:
INSTANCE_NAME
: o nome da instância.ZONE
: a zona em que a instância existe.
Se o desligamento normal estiver ativado, a saída será semelhante a esta:
... scheduling: ... gracefulShutdown: enabled: true maxDuration: seconds: 'MAX_DURATION' ... ...
A saída inclui o valor
MAX_DURATION
. Esse valor indica a duração do período de encerramento normal em segundos. Se você não especificou um período de desligamento personalizado ao ativar o desligamento normal na instância, o Compute Engine omite o campomaxDuration
e define o período de desligamento normal como 10 minutos.REST
Para conferir as configurações de encerramento sem dificuldades em uma instância, faça uma solicitação
GET
para o métodoinstances.get
da versão Beta:GET https://compute.s3nsapis.fr/compute/beta/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.
Se o desligamento normal estiver ativado, a saída será semelhante a esta:
{ ... "scheduling": { ... "gracefulShutdown": { "enabled": true, "maxDuration": { "seconds": "MAX_DURATION" } } }, ... }
A saída inclui o valor
MAX_DURATION
. Esse valor indica a duração do período de encerramento normal em segundos. Se você não especificou um período de desligamento personalizado ao ativar o desligamento normal na instância, o Compute Engine omite o campomaxDuration
e define o período de desligamento normal como 10 minutos.Monitorar o encerramento sem dificuldades
Para monitorar um desligamento normal em andamento em uma instância de computação, selecione uma das seguintes opções:
Console
No Trusted Cloud console, acesse a página Instâncias de VM:
Na coluna Nome, clique no nome da instância.
A página de detalhes da instância é aberta na guia Detalhes.
Se um encerramento sem dificuldades estiver em andamento, na seção Informações básicas, verifique os seguintes campos:
Status: esse campo mostra o estado da sua instância. Durante um encerramento normal, esse campo mostra Parada pendente e um timer de contagem regressiva. O cronômetro faz a contagem regressiva até o momento em que o encerramento normal termina.
Estado de destino: este campo mostra se o Compute Engine está parando (Parada) ou excluindo (Excluída) a instância.
gcloud
Para monitorar um encerramento normal em andamento em uma instância, use o comando
gcloud beta compute instances describe
:gcloud beta compute instances describe INSTANCE_NAME \ --zone=ZONE
Substitua:
INSTANCE_NAME
: o nome da instância.ZONE
: a zona em que a instância existe.
Se um desligamento normal estiver em andamento, a saída será semelhante a esta:
... resourceStatus: ... shutdownDetails: maxDuration: seconds: 'MAX_DURATION' requestTimestamp: 'REQUEST_TIMESTAMP' stopState: STOP_STATE targetState: TARGET_STATE ... status: PENDING_STOP ...
Esta saída inclui os seguintes valores:
MAX_DURATION
: a duração do período de desligamento normal em segundos. Depois que o Compute Engine defineSTOP_STATE
comoSTOPPING
, ele exclui o campomaxDuration
.REQUEST_TIMESTAMP
: o carimbo de data/hora em que oSTOP_STATE
começou.STOP_STATE
: a fase de interrupção da instância. O valor pode ser um dos seguintes:PENDING_STOP
: o Compute Engine iniciou o desligamento normal. A instância permanece nesse estado até que você encerre manualmente o desligamento normal ou o período de desligamento normal expire.STOPPING
: o encerramento normal foi concluído, e o Compute Engine continua com a operação de parada ou exclusão.
TARGET_STATE
: se o Compute Engine está interrompendo (STOPPED
) ou excluindo (DELETED
) a instância.
Se uma operação de interrupção estiver em execução, depois que o Compute Engine definir o campo
status
comoTERMINATE
, ele vai excluir o camposhutdownDetails
.REST
Para monitorar um encerramento sem dificuldades em andamento em uma instância, faça uma solicitação
GET
para o método Betainstances.get
:GET https://compute.s3nsapis.fr/compute/beta/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.
Se um desligamento normal estiver em andamento, a saída será semelhante a esta:
{ ... "resourceStatus": { ... "shutdownDetails": { "maxDuration": { "seconds": "MAX_DURATION" }, "requestTimestamp": "REQUEST_TIMESTAMP", "stopState": "STOP_STATE", "targetState": "TARGET_STATE" } }, ... "status": "PENDING_STOP", ... }
Esta saída inclui os seguintes valores:
MAX_DURATION
: a duração do período de desligamento normal em segundos. Depois que o Compute Engine defineSTOP_STATE
comoSTOPPING
, ele exclui o campomaxDuration
.REQUEST_TIMESTAMP
: o carimbo de data/hora em que oSTOP_STATE
começou.STOP_STATE
: a fase de interrupção da instância. O valor pode ser um dos seguintes:PENDING_STOP
: o Compute Engine iniciou o desligamento normal. A instância permanece nesse estado até que você encerre manualmente o desligamento normal ou o período de desligamento normal expire.STOPPING
: o encerramento normal foi concluído, e o Compute Engine continua com a operação de parada ou exclusão.
TARGET_STATE
: se o Compute Engine está interrompendo (STOPPED
) ou excluindo (DELETED
) a instância.
Se uma operação de interrupção estiver em execução, depois que o Compute Engine definir o campo
status
comoTERMINATE
, ele vai excluir o camposhutdownDetails
.Servidor de metadados
Conecte-se à instância.
Consulte o servidor de metadados:
curl "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details/?recursive=true?alt=json" \-H "Metadata-Flavor: Google"
Se um desligamento normal estiver em andamento, a saída será semelhante a esta:
{ "maxDuration": "MAX_DURATION", "requestTimestamp": "REQUEST_TIMESTAMP", "stopState": "STOP_STATE", "targetState": "TARGET_STATE" }
A saída inclui os seguintes valores:
MAX_DURATION
: a duração do período de desligamento normal em segundos. Depois que o Compute Engine defineSTOP_STATE
comoSTOPPING
, ele exclui o campomaxDuration
.REQUEST_TIMESTAMP
: o carimbo de data/hora em que oSTOP_STATE
começou.STOP_STATE
: a fase de interrupção da instância. O papel pode ser um dos seguintes:PENDING_STOP
: o Compute Engine iniciou o encerramento normal. A instância permanece nesse estado até que você encerre manualmente o desligamento normal ou o período de desligamento normal expire.STOPPING
: o encerramento normal foi concluído, e o Compute Engine continua com a operação de parada ou exclusão.
TARGET_STATE
: se o Compute Engine está interrompendo (STOPPED
) ou excluindo (DELETED
) a 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-08-18 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-18 UTC."],[[["\u003cp\u003eThis document guides you through viewing the settings and progress of a graceful shutdown in a Compute Engine instance, detailing how to check if it's enabled and its duration.\u003c/p\u003e\n"],["\u003cp\u003eYou can monitor a graceful shutdown in progress to determine when it will time out and whether a stop or delete operation is currently active.\u003c/p\u003e\n"],["\u003cp\u003eThe graceful shutdown feature is a pre-GA offering, which means it is subject to the "Pre-GA Offerings Terms", with the possibility of having limited support.\u003c/p\u003e\n"],["\u003cp\u003eViewing the graceful shutdown settings and monitoring the progress can be done using the Google Cloud Console, gcloud CLI, or REST API, with specific steps provided for each method.\u003c/p\u003e\n"],["\u003cp\u003eAccessing the metadata server allows for the retrieval of details regarding graceful shutdown, including the maximum duration, request timestamp, stop state, and the target state of the instance.\u003c/p\u003e\n"]]],[],null,[]] -