Limitar o tempo de execução de uma VM

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 Google Cloud . 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:
  gcloud init
  Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
  
  Observação: se você já instalou a gcloud CLI, execute o comando gcloud components update para verificar se você tem a versão mais recente.
2. 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.
Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

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.

Observação: para programar uma VM para ser interrompida após mais de 120 dias, use programações de instâncias.
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 estado RUNNING.
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 Google Cloud , a CLI do Google Cloud, o Terraform ou a API Compute Engine.

Console

No console do Google Cloud , acesse a página Criar instância.

Acessar 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.

gcloud compute instances create VM_NAME \
    --max-run-duration=DURATION \
    --instance-termination-action=TERMINATION_ACTION

Substitua:

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 por d, h, m e s, respectivamente. Por exemplo, especifique 30m para uma duração de 30 minutos ou especifique 1d2h3m4s para 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.

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 argumento instance_termination_action, exceto ao criar uma VM spot (defina o argumento provisioning_model como SPOT), 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 argumento on_instance_stop_action como verdadeiro (true).
- Caso contrário, omita o argumento on_instance_stop_action.

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 campo instanceTerminationAction, 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ê especificar family/debian-10 como a imagem, especifique debian-cloud como 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ê especificar family/debian-10 como a imagem e debian-cloud como 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".

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 Google Cloud , a CLI do Google Cloud ou a API Compute Engine.

Console

No console do Google Cloud , acesse a página Criar instância.

Acessar 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.

gcloud compute instances create VM_NAME \
    --termination-time=TIME \
    --instance-termination-action=TERMINATION_ACTION

Substitua:

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), especifique Z.
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.

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 campo instanceTerminationAction, 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ê especificar family/debian-10 como a imagem, especifique debian-cloud como 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ê especificar family/debian-10 como a imagem e debian-cloud como 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), especifique Z.
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".

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 Google Cloud , 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 Google Cloud , acesse a página Instâncias de VM.

Acessar 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:
1. Se a VM estiver em execução, clique em Parar.
2. Para editar a VM, clique em Editar.
3. Na página Editar instância, siga estas etapas:
  1. 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.
  2. Para salvar as alterações, clique em Salvar.
4. 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_NAME pelo 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=true
```
Configure as seguintes flags:
- É necessário omitir a flag --max-run-duration ou --termination-time para definir o limite de tempo como um horário ou uma duração, respectivamente.
- Inclua a flag --instance-termination-action para 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 por d, h, m e s, respectivamente. Por exemplo, especifique 30m para uma duração de 30 minutos ou especifique 1d2h3m4s para 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), especifique Z.
- 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.
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_NAME pelo 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 scheduling da VM, incluindo os campos de limite de tempo dela, usando o método instances.setScheduling. Inclua o campo maxRunDuration ou terminationTime para 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ê especificar family/debian-10 como a imagem, especifique debian-cloud como 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ê especificar family/debian-10 como a imagem e debian-cloud como 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), especifique Z.
- 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".
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:
1. Confira os detalhes de uma VM.
2. Na saída, confira o campo de carimbo de data/hora de encerramento da VM:
  - Ao usar o console do Google Cloud , 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:
1. Confira as operações da VM.
2. 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.deferredStop indica uma ação de encerramento automático de interrupção.
  - compute.instances.deferredDelete indica 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:

Limitar o tempo de execução de uma VM Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Console

gcloud

REST

Restrições

Limitar o tempo de execução de uma nova VM

Definir uma duração

Console

gcloud

Terraform

REST

Definir um horário

Console

gcloud

REST

Limitar o tempo de execução de uma VM atual

Console

gcloud

REST

Monitorar o tempo de execução de uma VM

A seguir

Limitar o tempo de execução de uma VM