Neste documento, explicamos como limitar e monitorar o tempo de execução de instâncias de máquina virtual (VM) novas ou atuais. Para grupos gerenciados de instâncias (MIGs), consulte Limitar o tempo de execução de um MIG.
Com a limitação do tempo de execução de uma VM, é possível programar o encerramento (parada ou exclusão) automático para quando ela atinge um limite de tempo específico (duração ou horário). É possível otimizar cargas de trabalho temporárias usando limites de tempo. Além disso, ao limitar automaticamente os tempos de execução de VMs, você pode minimizar custos e liberar cotas.
Para saber como interromper imediatamente uma VM, consulte Interromper ou reiniciar uma VM. Para saber como excluir imediatamente uma VM, consulte Excluir uma VM.
Antes de começar
-
Para ter as permissões necessárias para limitar o tempo de execução de uma VM, peça ao administrador para conceder a você o papel do IAM de Administrador da instância do Compute (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.Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.
-
Configure a autenticação, se ainda não tiver feito isso.
Com isso, você confirma sua identidade para acesso a serviços e APIs do Cloud de Confiance by S3NS . Para executar código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Cloud de Confiance console to access Cloud de Confiance by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instale a CLI do Google Cloud e faça login na gcloud CLI com sua identidade federada. Depois de fazer login, inicialize a CLI do Google Cloud executando o seguinte comando:
gcloud init - Set a default region and zone.
REST
Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Instale a CLI do Google Cloud e faça login na gcloud CLI com sua identidade federada. Depois de fazer login, inicialize a CLI do Google Cloud executando o seguinte comando:
gcloud initSaiba mais em Autenticar para usar REST na documentação de autenticação do Cloud de Confiance .
Restrições
Confira abaixo as restrições para a limitação do tempo de execução de uma VM:
A ação de encerramento automático precisa ser uma parada ou exclusão. Não é possível configurar uma VM para ser suspensa automaticamente quando o limite de tempo for atingido.
O limite de tempo mínimo é de 30 segundos, e o máximo é de 120 dias.
O encerramento automático pode levar até 30 segundos a mais do que a duração ou o horário especificado para começar o processo de interrupção ou exclusão da VM.
Não é possível usar limites de tempo com VMs preemptivas legadas. Em vez disso, use-os com VMs spot.
Os dados do SSD local de uma VM não podem ser preservados quando ela é interrompida automaticamente devido a um limite de tempo. Para mais informações, consulte Interromper uma VM com SSD local.
Limitar o tempo de execução de uma nova VM
Nas seções a seguir, descrevemos como configurar um limite de tempo ao criar uma VM. É possível especificar o limite de tempo, que indica quando você quer que a VM seja encerrada automaticamente, como uma duração (
maxRunDuration) ou um horário (terminationTime).Ao decidir o tipo de limite de tempo de uma VM, considere que ela pode ser interrompida, por exemplo, por uma solicitação do usuário ou um evento de host. O comportamento de um limite de tempo varia de acordo com o tipo da interrupção e do limite:
O carimbo de data/hora de encerramento (
terminationTimestamp) de uma VM é um campo somente leitura que representa o horário planejado para o encerramento automático e é definido automaticamente pelo Compute Engine sempre que uma VM tem um limite de tempo e entra no estadoRUNNING.O carimbo de data/hora de encerramento é apagado automaticamente sempre que uma VM é interrompida ou suspensa. No entanto, ele não é alterado quando você redefine ou reinicia a VM.
O carimbo de data/hora de encerramento é redefinido automaticamente sempre que a VM é reiniciada ou retomada, com base no tipo de limite de tempo configurado:
- Se você definir uma duração para a VM, o carimbo de data/hora de encerramento será recalculado adicionando essa duração ao horário de início mais recente da VM.
- Se você definir um horário para a VM, o carimbo de data/hora de encerramento será esse horário. No entanto, o horário precisa estar no futuro. Caso contrário, qualquer solicitação para criar ou executar a VM novamente vai falhar até que você atualize ou remova esse horário.
Definir uma duração
Uma duração representa o tempo total de execução pretendido para uma VM. Para criar uma VM que é encerrada de modo automático após uma duração específica de execução, use o console do Cloud de Confiance , a CLI do Google Cloud, o Terraform ou a API Compute Engine.
Console
No console do Cloud de Confiance , acesse a página Criar instância.
Na seção Políticas de disponibilidade, abra Configurações avançadas do modelo de provisionamento de VM.
Marque a caixa de seleção Definir um limite de tempo para a VM. O campo Tipo de limite de tempo é exibido.
No campo Tipo de limite de tempo, selecione Por horas (padrão) para especificar uma duração. No campo a seguir, insira a duração em horas.
Na lista Após o encerramento da VM, selecione o que acontece quando a VM atinge o limite de tempo de execução especificado:
- Para encerrar a VM de modo automático, selecione Parar (padrão).
- Para excluir a VM, selecione Excluir.
Opcional: especifique outras opções para a VM. Para mais informações, consulte Como criar e iniciar uma instância de VM.
Para criar e iniciar a VM, clique em Criar.
gcloud
Para criar uma VM com a gcloud CLI, use o comando
gcloud compute instances create.- Para criar uma VM que é encerrada automaticamente após um período específico,
inclua a flag
--max-run-duration. - Para especificar a ação de encerramento, inclua a
flag
--instance-termination-action. - Configure a
flag
--discard-local-ssds-at-termination-timestamp:- Se a VM tiver SSDs locais e a ação de encerramento
(
TERMINATION_ACTION) for de interrupção (STOP), inclua a flag--discard-local-ssds-at-termination-timestamp=true. - Caso contrário, omita a flag
--discard-local-ssds-at-termination-timestamp.
- Se a VM tiver SSDs locais e a ação de encerramento
(
gcloud compute instances create VM_NAME \ --max-run-duration=DURATION \ --instance-termination-action=TERMINATION_ACTIONSubstitua:
VM_NAME: o nome da nova VM.DURATION: a duração da execução pretendida para a VM até que ela seja encerrada de modo automático. Formate a duração como o número de dias, horas, minutos e segundos seguidos pord,h,mes, respectivamente. Por exemplo, especifique30mpara uma duração de 30 minutos ou especifique1d2h3m4spara uma duração de um dia, duas horas, três minutos e quatro segundos. A duração mínima é de 30 segundos (30s) e a máxima é de 120 dias (120d).TERMINATION_ACTION: a ação de encerramento da VM, que pode ser uma ação de parada (STOP) ou de exclusão (DELETE). A exigência desse campo ou a inclusão de um valor padrão para ele variam com base no modelo de provisionamento da VM:- No caso de uma VM spot (que usa a flag
--provisioning-model=SPOT), a flag--instance-termination-action=TERMINATION_ACTIONé opcional. Quando essa flag é omitida, a ação de encerramento padrão é interrompida. - Caso contrário,
o padrão é
a exigência da
flag
--instance-termination-action=TERMINATION_ACTION.
- No caso de uma VM spot (que usa a flag
Para mais informações sobre as opções que podem ser especificadas ao criar uma VM, consulte Como criar e iniciar uma instância de VM.
Terraform
Para criar uma VM usando o Terraform, utilize o recurso
google_compute_instance.- Para criar uma VM que seja encerrada de modo automático após um período específico,
inclua o
argumento
max_run_duration. - Para especificar a ação de encerramento, inclua o
argumento
instance_termination_action. É necessário incluir o argumentoinstance_termination_action, exceto ao criar uma VM spot (defina o argumentoprovisioning_modelcomoSPOT), que tem como padrão a interrupção (STOP). - Configure o
argumento
on_instance_stop_action:- Se a VM tiver SSDs locais e a ação de encerramento
(argumento
instance_termination_action) for uma interrupção (STOP), defina o argumentoon_instance_stop_actioncomo verdadeiro (true). - Caso contrário, omita o argumento
on_instance_stop_action.
- Se a VM tiver SSDs locais e a ação de encerramento
(argumento
Para mais informações, consulte a documentação do Terraform para o recurso
google_compute_instance.REST
Para criar uma VM com base na API Compute Engine, use o método
instances.insert. Especifique um nome, um tipo de máquina e um disco de inicialização para a VM.Para criar uma VM que seja encerrada de modo automático após um período específico, inclua o campo
maxRunDuration. Para especificar a ação de encerramento, inclua o campoinstanceTerminationAction, que é opcional em VMs spot.POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID/zones/ZONE/instances { "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "name": "VM_NAME", "disks": [ { "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" }, "boot": true } ] "scheduling": { "maxRunDuration": { "seconds": DURATION }, "instanceTerminationAction": "TERMINATION_ACTION" }, }Substitua:
PROJECT_ID: o ID do projeto em que a VM será criada.ZONE: a zona em que a VM será criada. A zona também precisa permitir o tipo de máquina a ser usado na nova VM.MACHINE_TYPE: o tipo de máquina predefinido ou personalizado da nova VM.VM_NAME: o nome da nova VM.IMAGE_PROJECT: o projeto que contém a imagem. Por exemplo, se você especificarfamily/debian-10como a imagem, especifiquedebian-cloudcomo o projeto de imagem.IMAGE: a imagem da nova VM. Você pode especificar uma versão específica de uma imagem pública ou de uma família de imagens. Por exemplo, se você especificarfamily/debian-10como a imagem edebian-cloudcomo o projeto de imagem, o Compute Engine vai criar uma VM com base na versão mais recente da imagem do SO na família de imagens Debian 10.DURATION: a duração em segundos da execução pretendida para essa VM antes do encerramento automático. A duração mínima é de 30 segundos (30s) e a máxima é de 120 dias (120d).TERMINATION_ACTION: a ação de encerramento da VM, que pode ser uma ação de parada (STOP) ou de exclusão (DELETE). A exigência desse campo ou a inclusão de um valor padrão para ele variam com base no modelo de provisionamento da VM:- No caso de uma VM spot (que usa o
campo
"provisioningModel": "SPOT"), o campo"instanceTerminationAction": "TERMINATION_ACTION"é opcional. Quando esse campo é omitido, a ação de encerramento padrão é a interrupção. - Caso contrário, o
padrão é a exigência
do campo
"instanceTerminationAction": "TERMINATION_ACTION".
- No caso de uma VM spot (que usa o
campo
Para mais informações sobre as opções que podem ser especificadas ao criar uma VM, consulte Como criar e iniciar uma instância de VM.
Definir um horário
Um horário representa a data, a hora e o fuso horário em que você quer que a VM seja encerrada. Para criar uma VM que seja encerrada de modo automático em um horário específico, use o console do Cloud de Confiance , a CLI do Google Cloud ou a API Compute Engine.
Console
No console do Cloud de Confiance , acesse a página Criar instância.
Na seção Políticas de disponibilidade, abra Configurações avançadas do modelo de provisionamento de VM.
Marque a caixa de seleção Definir um limite de tempo para a VM. O campo Tipo de limite de tempo é exibido.
No campo Tipo de limite de tempo, selecione Por data para especificar o limite como um horário e uma data. No campo a seguir, clique em Selecionar data e hora e escolha a data, a hora e o fuso horário do limite de tempo.
Na lista Após o encerramento da VM, selecione o que acontece quando a VM atinge o limite de tempo de execução especificado:
- Para encerrar a VM de modo automático, selecione Parar (padrão).
- Para excluir a VM, selecione Excluir.
Opcional: especifique outras opções para a VM. Para mais informações, consulte Como criar e iniciar uma instância de VM.
Para criar e iniciar a VM, clique em Criar.
gcloud
Para criar uma VM com a gcloud CLI, use o comando
gcloud compute instances create.- Para criar uma VM que é encerrada de modo automático em um horário específico,
inclua a flag
--termination-time. - Para especificar a ação de encerramento, inclua a flag
--instance-termination-action, que é opcional para VMs spot. - Configure a
flag
--discard-local-ssds-at-termination-timestamp:- Se a VM tiver SSDs locais e a ação de encerramento (
TERMINATION_ACTION) estiver definida como interrupção (STOP), inclua a flag--discard-local-ssds-at-termination-timestamp=true. - Caso contrário, omita a flag
--discard-local-ssds-at-termination-timestamp.
- Se a VM tiver SSDs locais e a ação de encerramento (
gcloud compute instances create VM_NAME \ --termination-time=TIME \ --instance-termination-action=TERMINATION_ACTIONSubstitua:
VM_NAME: o nome da nova VM.TIME: o horário em que você quer que a VM seja encerrada de modo automático. O horário especificado precisa ser pelo menos 30 segundos no futuro e no máximo 120 dias. Formate o horário como um carimbo de data/hora RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Substitua:
YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos desse mês, separados por hifens.HH:MM:SS: um horário no escopo de 24 horas formatado como uma hora de dois dígitos, minutos de dois dígitos e segundos de dois dígitos, separados por hifens.OFFSET: um fuso horário formatado como um deslocamento do Tempo Universal Coordenado (UTC). Por exemplo, para usar o Horário Padrão do Pacífico (PST), que é 8 horas antes do UTC, especifique-08:00. Como alternativa, para não usar deslocamento (UTC+0), especifiqueZ.
TERMINATION_ACTION: a ação de encerramento da VM, que pode ser interrupção (STOP) ou exclusão (DELETE). A exigência desse campo ou a inclusão de um valor padrão para ele variam com base no modelo de provisionamento da VM:- No caso de uma VM spot (que usa a flag
--provisioning-model=SPOT), a flag--instance-termination-action=TERMINATION_ACTIONé opcional. Quando essa flag é omitida, a ação de encerramento padrão é interrompida. - Caso contrário, o padrão
é a exigência da
flag
--instance-termination-action=TERMINATION_ACTION.
- No caso de uma VM spot (que usa a flag
Para mais informações sobre as opções que podem ser especificadas ao criar uma VM, consulte Como criar e iniciar uma instância de VM.
REST
Para criar uma VM com base na API Compute Engine, use o método
instances.insert. Especifique um nome, um tipo de máquina e um disco de inicialização para a VM.Para criar uma VM que é encerrada de modo automático em um horário específico, inclua o campo
terminationTime. Para especificar a ação de encerramento, inclua o campoinstanceTerminationAction, que é opcional em VMs spot.POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID/zones/ZONE/instances { "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "name": "VM_NAME", "disks": [ { "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" }, "boot": true } ] "scheduling": { "terminationTime": "TIME", "instanceTerminationAction": "TERMINATION_ACTION" }, }Substitua:
PROJECT_ID: o ID do projeto em que a VM será criada.ZONE: a zona em que a VM será criada. A zona também precisa permitir o tipo de máquina a ser usado na nova VM.MACHINE_TYPE: o tipo de máquina predefinido ou personalizado da nova VM.VM_NAME: o nome da nova VM.IMAGE_PROJECT: o projeto que contém a imagem. Por exemplo, se você especificarfamily/debian-10como a imagem, especifiquedebian-cloudcomo o projeto de imagem.IMAGE: a imagem da nova VM. Você pode especificar uma versão específica de uma imagem pública ou de uma família de imagens. Por exemplo, se você especificarfamily/debian-10como a imagem edebian-cloudcomo o projeto de imagem, o Compute Engine vai criar uma VM com base na versão mais recente da imagem do SO na família de imagens Debian 10.TIME: o horário em que você quer que a VM seja encerrada de modo automático. O horário especificado precisa ser pelo menos 30 segundos no futuro e no máximo 120 dias. Formate o horário como um carimbo de data/hora RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Substitua:
YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos desse mês, separados por hifens.HH:MM:SS: um horário no escopo de 24 horas formatado como uma hora de dois dígitos, minutos de dois dígitos e segundos de dois dígitos, separados por hifens.OFFSET: um fuso horário formatado como um deslocamento do Tempo Universal Coordenado (UTC). Por exemplo, para usar o Horário Padrão do Pacífico (PST), que é 8 horas antes do UTC, especifique-08:00. Como alternativa, para não usar deslocamento (UTC+0), especifiqueZ.
TERMINATION_ACTION: a ação de encerramento da VM, que pode ser interrupção (STOP) ou exclusão (DELETE). A exigência desse campo ou a inclusão de um valor padrão para ele variam com base no modelo de provisionamento da VM:- No caso de uma VM spot (que usa o
campo
"provisioningModel": "SPOT"), o campo"instanceTerminationAction": "TERMINATION_ACTION"é opcional. Quando esse campo é omitido, a ação de encerramento padrão é a interrupção. - Caso contrário, o
padrão é a exigência
do campo
"instanceTerminationAction": "TERMINATION_ACTION".
- No caso de uma VM spot (que usa o
campo
Para mais informações sobre as opções que podem ser especificadas ao criar uma VM, consulte Como criar e iniciar uma instância de VM.
Limitar o tempo de execução de uma VM atual
É possível limitar o tempo de execução de uma VM atual atualizando a programação dela. Se você ainda não sabe como definir as configurações de limites de tempo, confira primeiro as seções anteriores sobre como limitar o tempo de execução de uma nova VM.
É possível usar o console do Cloud de Confiance , a CLI do Google Cloud ou a API Compute Engine para atualizar as propriedades relacionadas à programação da VM, conforme descrito nesta seção. Esse método exige que você pare a VM, atualize as propriedades dela e, em seguida, reinicie a VM. Você também pode atualizar simultaneamente outras propriedades da VM, além de interrompê-la e reiniciá-la de modo automático. Para isso, consulte Atualizar as propriedades da instância.
Console
No console do Cloud de Confiance , acesse a página Instâncias de VM.
Na coluna Nome, clique no nome da VM que você quer atualizar.
Na página Detalhes da instância de VM, siga estas etapas:
- Se a VM estiver em execução, clique em Parar.
- Para editar a VM, clique em Editar.
Na página Editar instância, siga estas etapas:
Na seção Políticas de disponibilidade, modifique a caixa de seleção Definir limite de tempo da VM e todos os campos abaixo dela como quiser.
Para saber como configurar as propriedades de limites de tempo, consulte Limitar o tempo de execução de uma nova VM.
Para salvar as alterações, clique em Salvar.
Opcional: para começar a executar a VM agora, clique em Iniciar.
gcloud
Para atualizar o limite de tempo de uma VM usando a gcloud CLI, siga estas etapas:
Se a VM estiver em execução, interrompa-a usando o comando
gcloud compute instances stop:gcloud compute instances stop VM_NAME
Substitua
VM_NAMEpelo nome da VM a ser atualizada.Atualize o limite de tempo da VM usando o comando
gcloud compute instances set-scheduling.gcloud compute instances set-scheduling VM_NAME \ --max-run-duration=DURATION \ --termination-time=TIME \ --instance-termination-action=TERMINATION_ACTION \ --discard-local-ssds-at-termination-timestamp=trueConfigure as seguintes flags:
- É necessário omitir a flag
--max-run-durationou--termination-timepara definir o limite de tempo como um horário ou uma duração, respectivamente. - Inclua a flag
--instance-termination-actionpara definir a ação de encerramento. - Se a VM tiver SSDs locais e a ação de encerramento (
TERMINATION_ACTION) estiver definida como interrupção (STOP), inclua a flag--discard-local-ssds-at-termination-timestamp=true. Caso contrário, omita a flag--discard-local-ssds-at-termination-timestamp=true.
Em seguida, substitua:
VM_NAME: o nome da VM que você quer atualizar.DURATION: a duração da execução pretendida para a VM até que ela seja encerrada de modo automático. Formate a duração como o número de dias, horas, minutos e segundos seguidos pord,h,mes, respectivamente. Por exemplo, especifique30mpara uma duração de 30 minutos ou especifique1d2h3m4spara uma duração de um dia, duas horas, três minutos e quatro segundos. A duração mínima é de 30 segundos (30s) e a máxima é de 120 dias (120d).TIME: o horário em que você quer que a VM seja encerrada de modo automático. O horário especificado precisa ser pelo menos 30 segundos no futuro e no máximo 120 dias. Formate o horário como um carimbo de data/hora RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Substitua:
YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos desse mês, separados por hifens.HH:MM:SS: um horário no escopo de 24 horas formatado como uma hora de dois dígitos, minutos de dois dígitos e segundos de dois dígitos, separados por hifens.OFFSET: um fuso horário formatado como um deslocamento do Tempo Universal Coordenado (UTC). Por exemplo, para usar o Horário Padrão do Pacífico (PST), que é 8 horas antes do UTC, especifique-08:00. Como alternativa, para não usar deslocamento (UTC+0), especifiqueZ.
TERMINATION_ACTION: a ação de encerramento da VM, que pode ser interrupção (STOP) ou exclusão (DELETE). A exigência desse campo ou a inclusão de um valor padrão para ele variam com base no modelo de provisionamento da VM:- No caso de uma VM spot (que usa a flag
--provisioning-model=SPOT), a flag--instance-termination-action=TERMINATION_ACTIONé opcional. Quando essa flag é omitida, a ação de encerramento padrão é interrompida. - Caso contrário, o padrão
é a exigência da
flag
--instance-termination-action=TERMINATION_ACTION.
- No caso de uma VM spot (que usa a flag
- É necessário omitir a flag
Para que a VM comece a ser executada, inicie-a usando o comando
gcloud compute instances start:gcloud compute instances start VM_NAME
Substitua
VM_NAMEpelo nome da VM.
REST
Para atualizar o limite de tempo de uma VM usando a API Compute Engine, faça o seguinte:
Se a VM estiver em execução, interrompa-a usando o método
instances.stop:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop
Substitua:
PROJECT_ID: o ID do projeto que contém a VM.ZONE: a zona que contém a VM.VM_NAME: o nome da VM que você quer atualizar.
Atualize a propriedade
schedulingda VM, incluindo os campos de limite de tempo dela, usando o métodoinstances.setScheduling. Inclua o campomaxRunDurationouterminationTimepara definir o limite de tempo como uma duração ou um horário, respectivamente:Para definir uma duração, use esta solicitação:
POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling { "maxRunDuration": { "seconds": DURATION }, "instanceTerminationAction": "TERMINATION_ACTION" }Para definir um horário, use esta solicitação:
POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling { "terminationTime": "TIME", "instanceTerminationAction": "TERMINATION_ACTION" }
Substitua:
PROJECT_ID: o ID do projeto em que a VM será criada.ZONE: a zona em que a VM será criada. A zona também precisa permitir o tipo de máquina a ser usado na nova VM.MACHINE_TYPE: o tipo de máquina predefinido ou personalizado da nova VM.VM_NAME: o nome da nova VM.IMAGE_PROJECT: o projeto que contém a imagem. Por exemplo, se você especificarfamily/debian-10como a imagem, especifiquedebian-cloudcomo o projeto de imagem.IMAGE: a imagem da nova VM. Você pode especificar uma versão específica de uma imagem pública ou de uma família de imagens. Por exemplo, se você especificarfamily/debian-10como a imagem edebian-cloudcomo o projeto de imagem, o Compute Engine vai criar uma VM com base na versão mais recente da imagem do SO na família de imagens Debian 10.DURATION: a duração em segundos da execução pretendida para essa VM antes do encerramento automático. A duração mínima é de 30 segundos (30s) e a máxima é de 120 dias (120d).TIME: o horário em que você quer que a VM seja encerrada de modo automático. O horário especificado precisa ser pelo menos 30 segundos no futuro e no máximo 120 dias. Formate o horário como um carimbo de data/hora RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Substitua:
YYYY-MM-DD: uma data formatada como um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos desse mês, separados por hifens.HH:MM:SS: um horário no escopo de 24 horas formatado como uma hora de dois dígitos, minutos de dois dígitos e segundos de dois dígitos, separados por hifens.OFFSET: um fuso horário formatado como um deslocamento do Tempo Universal Coordenado (UTC). Por exemplo, para usar o Horário Padrão do Pacífico (PST), que é 8 horas antes do UTC, especifique-08:00. Como alternativa, para não usar deslocamento (UTC+0), especifiqueZ.
TERMINATION_ACTION: a ação de encerramento da VM, que pode ser interrupção (STOP) ou exclusão (DELETE). A exigência desse campo ou a inclusão de um valor padrão para ele variam com base no modelo de provisionamento da VM:- No caso de uma VM spot (que usa o
campo
"provisioningModel": "SPOT"), o campo"instanceTerminationAction": "TERMINATION_ACTION"é opcional. Quando esse campo é omitido, a ação de encerramento padrão é a interrupção. - Caso contrário, o
padrão é a exigência
do campo
"instanceTerminationAction": "TERMINATION_ACTION".
- No caso de uma VM spot (que usa o
campo
Para que a VM comece a ser executada, inicie-a usando o método
instances.start:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/start
Substitua:
PROJECT_ID: o ID do projeto que contém a VM.ZONE: a zona que contém a VM.VM_NAME: o nome da VM.
Monitorar o tempo de execução de uma VM
Use as opções abaixo para monitorar o tempo de execução de uma VM com limite de tempo:
Para descobrir quando uma VM em execução está programada para ser encerrada automaticamente, confira o carimbo de data/hora de encerramento dela:
- Confira os detalhes de uma VM.
- Na saída, confira o campo de carimbo de data/hora de encerramento da VM:
- Ao usar o console do Cloud de Confiance , consulte o campo Duração máxima.
- Ao usar a CLI do Google Cloud ou a API Compute Engine, consulte o
campo
terminationTimestamp.
Para verificar se uma VM foi encerrada automaticamente, confira as operações dela:
- Confira as operações da VM.
Na saída, é possível procurar os tipos de operações abaixo para identificar as operações da VM que são causadas por um limite de tempo:
compute.instances.deferredStopindica uma ação de encerramento automático de interrupção.compute.instances.deferredDeleteindica uma ação de encerramento automático de exclusão.
A seguir
Saiba como otimizar ainda mais as VMs:
- Se as cargas de trabalho forem tolerantes a falhas, use VMs spot para receber descontos significativos e uma cota dedicada opcional.
- Para que uma VM execute comandos automaticamente antes de ser encerrada, use scripts de encerramento.
Conheça outras opções para limitar automaticamente os tempos de execução das VMs:
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-12-17 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-12-17 UTC."],[],[]] -