Definir a política de manutenção do host para uma instância de computação,Definir a política de manutenção do host para uma instância de computação

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

1. No console do Google Cloud, acesse a página de instâncias de VM .

   Acesse as instâncias de VM

2. Na coluna Nome , clique no nome da instância que você deseja atualizar. Uma página que fornece os detalhes da instância é exibida.

3. Clique em edit Editar . Uma página que permite editar as propriedades da instância é exibida.

4. Na seção Gerenciamento , você pode fazer um ou mais dos seguintes procedimentos:

   • Para alterar o comportamento durante eventos de manutenção, selecione outra opção na lista Na manutenção do host

   • Para alterar o período de tempo limite antes de reiniciar uma instância que não responde, selecione outra opção na lista Tempo limite de erro do host .

   • Para alterar se a instância deve ou não ser reiniciada após erros do host ou paradas programadas, selecione outra opção na lista Reinicialização automática .

5. Clique em Salvar .

gcloud

Para alterar a política de manutenção do host em uma instância existente, use o comando gcloud compute instances set-scheduling com uma ou mais das seguintes sinalizações:

• Para alterar o comportamento de manutenção do host, inclua o sinalizador --maintenance-policy .

• Para alterar o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o sinalizador --restart-on-failure .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o sinalizador --no-restart-on-failure .

• Para alterar o tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o sinalizador --local-ssd-recovery-timeout .

• Para alterar o tempo limite de erro do host, inclua o sinalizador --host-error-timeout-seconds .

Por exemplo, para alterar o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, alterar o tempo limite de recuperação de dados do SSD local e alterar o tempo limite de erro do host, execute o seguinte comando:

gcloud compute instances set-scheduling INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Substitua o seguinte:

• INSTANCE_NAME : o nome da sua instância.

• ERROR_DETECTION_TIMEOUT : o número de segundos antes que o Compute Engine reinicie uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE .

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• ZONE : a zona onde sua instância existe.

DESCANSAR

Para alterar a política de manutenção do host em uma instância existente, faça uma solicitação POST para o método instances.setScheduling . No corpo da solicitação, inclua um ou mais dos seguintes campos:

• Para alterar o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para alterar o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o campo automaticRestart .

• Para alterar o tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para alterar o tempo limite de erro do host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para alterar o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, alterar o tempo limite de recuperação de dados do SSD local e alterar o tempo limite de erro do host, faça uma solicitação da seguinte forma:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

{
  "automaticRestart": AUTOMATIC_RESTART,
  "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
  "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
  "onHostMaintenance": "MAINTENANCE_POLICY"
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto onde existe sua instância.

• ZONE : a zona onde sua instância existe.

• INSTANCE_NAME : o nome da sua instância.

• AUTOMATIC_RESTART : o comportamento de reinicialização automática da instância caso ela trave ou o Compute Engine a interrompa para uma parada programada. Especifique um dos seguintes valores:

  • Para permitir que o Compute Engine reinicie automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE .

Console

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

   Vá para Criar uma instância

2. No campo Nome , insira um nome para a instância.

3. Nos campos Região e Zona , especifique em qual região e zona criar a instância.

4. Especifique o tipo de máquina da instância.

5. No menu de navegação, clique em Avançado .

6. Na seção Modelo de provisionamento , expanda Configurações avançadas do modelo de provisionamento de VM e execute um ou mais dos seguintes procedimentos:

   • Para definir o comportamento durante eventos de manutenção, na lista Na manutenção do host , selecione uma das seguintes opções:

     • Para migrar a instância durante eventos de manutenção do host, selecione Migrar instância de VM (recomendado) .

     • Para interromper a instância durante eventos de manutenção do host, selecione Terminate VM instance .

   • Para definir o período de tempo limite antes de reiniciar uma instância que não responde, na lista Tempo limite de erro do host , selecione uma das seguintes opções:

     • Para não especificar um tempo limite de erro de host, selecione Unspecified (default) .

     • Para especificar um tempo limite de erro de host, selecione uma das opções disponíveis, até 5 minutos e 30 segundos .

   • Para definir se a instância deve ser reiniciada se ela travar ou for interrompida, na lista Reinicialização automática , selecione uma das seguintes opções:

     • Para reiniciar automaticamente a instância após erros de host ou paradas programadas, selecione Ativado (recomendado) .

     • Para evitar que a instância seja reiniciada automaticamente após erros de host ou paradas programadas, selecione Desligado .

7. Clique em Criar .

gcloud

Para definir a política de manutenção do host de uma instância ao criá-la, use o comando gcloud compute instances create com uma ou mais das seguintes sinalizações:

• Para definir o comportamento de manutenção do host, inclua o sinalizador --maintenance-policy .

• Para definir o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o sinalizador --restart-on-failure .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o sinalizador --no-restart-on-failure .

• Para definir um tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o sinalizador --local-ssd-recovery-timeout .

• Para definir um tempo limite de erro do host, inclua o sinalizador --host-error-timeout-seconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite de recuperação de dados do SSD local e definir um tempo limite de erro do host, execute o seguinte comando:

gcloud compute instances create INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Substitua o seguinte:

• INSTANCE_NAME : o nome da instância.

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• MACHINE_TYPE : o tipo de máquina a ser usada.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE . Se você estiver criando uma VM Spot, uma VM preemptiva ou uma instância que não oferece suporte à migração em tempo real , só poderá usar TERMINATE .

• ZONE : a zona na qual criar a instância.

DESCANSAR

Para definir a política de manutenção do host de uma instância ao criá-la, faça uma solicitação POST para o método instances.insert . No corpo da solicitação, inclua um ou mais dos seguintes campos no campo scheduling :

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro de host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite de recuperação de dados SSD local e definir um tempo limite de erro do host, faça uma solicitação da seguinte forma:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "automaticRestart": AUTOMATIC_RESTART,
    "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
    "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto no qual a instância será criada.

• ZONE : a zona na qual criar a instância.

• INSTANCE_NAME : o nome da instância.

• MACHINE_TYPE : o tipo de máquina a ser usada.

• IMAGE_PROJECT : o projeto de imagem que contém a imagem — por exemplo, debian-cloud . Para obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

• IMAGE : especifique um dos seguintes:

  • Uma versão específica da imagem do sistema operacional — por exemplo, debian-12-bookworm-v20240617 .

  • Uma família de imagens , que deve ser formatada como family/ IMAGE_FAMILY . Isso especifica a imagem do sistema operacional mais recente e não obsoleta. Por exemplo, se você especificar family/debian-12 , a versão mais recente da família de imagens Debian 12 será usada. Para obter mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens .

• AUTOMATIC_RESTART : o comportamento de reinicialização automática da instância caso ela trave ou o Compute Engine a interrompa para uma parada programada. Especifique um dos seguintes valores:

  • Para permitir que o Compute Engine reinicie automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE . Se você estiver criando uma VM Spot ou uma instância que não oferece suporte à migração em tempo real , você só poderá usar TERMINATE .

gcloud

Para definir a política de manutenção do host ao criar instâncias em massa, use o comando gcloud compute instances bulk create com uma ou mais das seguintes sinalizações:

• Para definir o comportamento de manutenção do host, inclua o sinalizador --maintenance-policy .

• Para definir o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o sinalizador --restart-on-failure .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o sinalizador --no-restart-on-failure .

• Para definir um tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o sinalizador --local-ssd-recovery-timeout .

• Para definir um tempo limite de erro do host, inclua o sinalizador --host-error-timeout-seconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite de recuperação de dados do SSD local e definir um tempo limite de erro do host, execute o comando a seguir. O exemplo a seguir também cria instâncias em uma única zona e especifica um padrão de nome para as instâncias:

gcloud compute instances bulk create \
    --count=COUNT \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --restart-on-failure \
    --zone=ZONE

Substitua o seguinte:

• COUNT : o número de instâncias a serem criadas.

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• MACHINE_TYPE : o tipo de máquina a ser usada.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você estiver criando VMs spot, VMs preemptivas ou instâncias que não oferecem suporte à migração em tempo real , você só poderá usar TERMINATE .

• NAME_PATTERN : o padrão de nome para as instâncias. Para substituir uma sequência de números em um nome de instância, use uma sequência de caracteres hash ( # ). Por exemplo, usar instance-# para o padrão de nome gera instâncias com nomes começando com instance-1 , instance-2 e continuando até o número de instâncias especificado por COUNT .

• ZONE : a zona na qual criar as instâncias.

DESCANSAR

Para definir a política de manutenção do host ao criar instâncias em massa, faça uma solicitação POST para o método instances.bulkInsert . No corpo da solicitação, inclua um ou mais dos seguintes campos no campo scheduling :

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro de host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite de recuperação de dados SSD local e definir um tempo limite de erro do host, faça uma solicitação da seguinte maneira. O exemplo a seguir também cria instâncias em uma única zona e especifica um padrão de nome para as instâncias:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto no qual serão criadas as instâncias.

• ZONE : a zona na qual criar as instâncias.

• COUNT : o número de instâncias a serem criadas.

• NAME_PATTERN : o padrão de nome para as instâncias. Para substituir uma sequência de números em um nome de instância, use uma sequência de caracteres hash ( # ). Por exemplo, usar instance-# para o padrão de nome gera instâncias com nomes começando com instance-1 , instance-2 e continuando até o número de instâncias especificado por COUNT .

• MACHINE_TYPE : o tipo de máquina a ser usada.

• IMAGE_PROJECT : o projeto de imagem que contém a imagem — por exemplo, debian-cloud . Para obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

• IMAGE : especifique um dos seguintes:

  • Uma versão específica da imagem do sistema operacional — por exemplo, debian-12-bookworm-v20240617 .

  • Uma família de imagens , que deve ser formatada como family/ IMAGE_FAMILY . Isso especifica a imagem do sistema operacional mais recente e não obsoleta. Por exemplo, se você especificar family/debian-12 , a versão mais recente da família de imagens Debian 12 será usada. Para obter mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens .

• AUTOMATIC_RESTART : o comportamento de reinicialização automática da instância caso ela trave ou o Compute Engine a interrompa para uma parada programada. Especifique um dos seguintes valores:

  • Para permitir que o Compute Engine reinicie automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você estiver criando VMs spot, VMs preemptivas ou instâncias que não oferecem suporte à migração em tempo real , você só poderá usar TERMINATE .

Console

1. No console do Google Cloud, acesse a página Modelos de instância .

   Vá para modelos de instância

2. Clique em Criar modelo de instância . A página Criar modelo de instância é exibida.

3. No campo Nome , insira um nome para o modelo de instância.

4. Na seção Localização , selecione uma das seguintes opções:

   • Para criar um modelo de instância regional, selecione Regional (recomendado) e selecione a região na qual deseja criar o modelo.

   • Para criar um modelo de instância global, selecione Global .

5. Na seção Configuração da máquina , especifique o tipo de máquina para o modelo de instância.

6. Na seção Modelo de provisionamento , expanda Configurações avançadas do modelo de provisionamento de VM e execute um ou mais dos seguintes procedimentos:

   • Para alterar o comportamento durante eventos de manutenção, na lista Na manutenção do host , selecione uma das seguintes opções:

     • Para migrar a instância durante eventos de manutenção do host, selecione Migrar instância de VM (recomendado) .

     • Para interromper a instância durante eventos de manutenção do host, selecione Terminate VM instance .

   • Para alterar o período de tempo limite antes de reiniciar uma instância que não responde, na lista Tempo limite de erro do host , selecione uma das seguintes opções:

     • Para não especificar um tempo limite de erro de host, selecione Unspecified (default) .

     • Para especificar um tempo limite de erro de host, selecione uma das opções disponíveis, até 5 minutos e 30 segundos .

   • Para alterar se a instância deve ser reiniciada se ela travar ou for interrompida, na lista Reinicialização automática , selecione uma das seguintes opções:

     • Para reiniciar automaticamente a instância após erros de host ou paradas programadas, selecione Ativado (recomendado) .

     • Para evitar que a instância seja reiniciada automaticamente após erros de host ou paradas programadas, selecione Desligado .

7. Clique em Criar .

gcloud

Para definir a política de manutenção do host ao criar um modelo de instância, use o gcloud compute instance-templates create com uma ou mais das seguintes sinalizações:

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro de host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite de recuperação de dados do SSD local e definir um tempo limite de erro do host, execute o comando a seguir. O exemplo a seguir também cria um modelo de instância regional. Para criar um modelo de instância global, use o mesmo comando sem o sinalizador --instance-template-region .

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --instance-template-region=REGION \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure

Substitua o seguinte:

• INSTANCE_TEMPLATE_NAME : o nome do modelo de instância.

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• REGION : a região na qual o modelo de instância será criado.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• MACHINE_TYPE : o tipo de máquina a ser usada.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você estiver especificando uma VM Spot, uma VM preemptiva ou um tipo de instância que não oferece suporte à migração em tempo real no modelo de instância, só poderá usar TERMINATE .

DESCANSAR

Para definir a política de manutenção do host ao criar um modelo de instância, faça uma solicitação POST para um dos seguintes métodos:

• Para criar um modelo de instância regional: método regionInstanceTemplates.insert

• Para criar um modelo de instância global: método instanceTemplates.insert

No corpo da solicitação, inclua um ou mais dos seguintes campos no campo scheduling :

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento de reinicialização automática, siga um destes procedimentos:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para evitar que a instância seja reiniciada automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite de recuperação de dados do SSD local se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro de host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite de recuperação de dados SSD local e definir um tempo limite de erro do host, faça uma solicitação da seguinte maneira. O exemplo a seguir também cria um modelo de instância regional.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto no qual será criado o modelo de instância.

• REGION : a região na qual o modelo de instância será criado.

• INSTANCE_TEMPLATE_NAME : o nome do modelo de instância.

• IMAGE_PROJECT : o projeto de imagem que contém a imagem — por exemplo, debian-cloud . Para obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

• IMAGE : especifique um dos seguintes:

  • Uma versão específica da imagem do sistema operacional — por exemplo, debian-12-bookworm-v20240617 .

  • Uma família de imagens , que deve ser formatada como family/ IMAGE_FAMILY . Isso especifica a imagem do sistema operacional mais recente e não obsoleta. Por exemplo, se você especificar family/debian-12 , a versão mais recente da família de imagens Debian 12 será usada. Para obter mais informações sobre o uso de famílias de imagens, consulte Práticas recomendadas para famílias de imagens .

• MACHINE_TYPE : o tipo de máquina a ser usada.

• AUTOMATIC_RESTART : o comportamento de reinicialização automática da instância caso ela trave ou o Compute Engine a interrompa para uma parada programada. Especifique um dos seguintes valores:

  • Para permitir que o Compute Engine reinicie automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos ou 5 minutos e 30 segundos). Somente incrementos de 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas gastas na recuperação de dados dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o Compute Engine não recupera dados do SSD local.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você estiver especificando uma VM Spot, uma VM preemptiva ou um tipo de instância que não oferece suporte à migração em tempo real no modelo de instância, só poderá usar TERMINATE .

Console

1. No console do Google Cloud, acesse a página de instâncias de VM .

   Acesse as instâncias de VM

2. Na coluna Nome , clique na instância que deseja visualizar. Uma página que fornece os detalhes da instância é exibida.

3. Na guia Detalhes , na seção Gerenciamento , na seção Políticas de disponibilidade , você pode visualizar o seguinte:

   • No campo Na manutenção do host , você pode ver os eventos de comportamento de manutenção do host da instância.

   • No campo Tempo limite de erro do host , você pode ver quanto tempo a instância espera antes de reiniciar ou parar a instância após detectar que ela não está respondendo. Se o valor não estiver definido ( — ), o tempo de espera padrão será de 5 minutos e 30 segundos.

   • No campo de reinicialização automático , você pode ver se a instância reinicia automaticamente a instância depois que ela trava ou calcula o motor para uma parada programada.

gcloud

Para visualizar a política de manutenção do host para uma instância, use as gcloud compute instances describe o comando com o sinalizador --flatten definido para scheduling :

 gcloud compute instances describe INSTANCE_NAME \
    --flatten=scheduling \
    --zone=ZONE

Substitua o seguinte:

• INSTANCE_NAME : o nome da instância.

• ZONE : a zona onde a instância está localizada.

A saída é semelhante à seguinte:

---
scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

DESCANSAR

Para visualizar a Política de Manutenção do Host para uma instância, faça uma solicitação para GET as instances.get . Na URL da solicitação, inclua o parâmetro de consulta fields e defina -o como scheduling :

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?fields=scheduling

Substitua o seguinte:

• PROJECT_ID : o projeto onde a instância existe.

• ZONE : a zona onde a instância existe.

• INSTANCE_NAME : o nome da instância.

A saída é semelhante à seguinte:

{
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  }
}

Console

1. No console do Google Cloud, acesse a página de instâncias de VM .

   Acesse as instâncias de VM

2. Na coluna Nome , clique no nome da instância que você deseja atualizar. Uma página que fornece os detalhes da instância é exibida.

3. Clique em edit Editar . Uma página que permite editar propriedades da instância aparece.

4. Na seção de gerenciamento , você pode fazer um ou mais dos seguintes:

   • Para alterar o comportamento durante os eventos de manutenção, selecione outra opção na lista de manutenção do host

   • Para alterar o período de tempo limite antes de reiniciar uma instância que não responde, selecione outra opção na lista de tempo limite de erro do host .

   • Para alterar se deve reiniciar a instância ou não após erros do host ou paradas programadas, selecione outra opção na lista de reinicialização automática .

5. Clique em Salvar .

gcloud

Para alterar a política de manutenção do host em uma instância existente, use o comando gcloud compute instances set-scheduling com um ou mais dos seguintes sinalizadores:

• Para alterar o comportamento de manutenção do host, inclua a bandeira --maintenance-policy .

• Para alterar o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o sinalizador --restart-on-failure .

  • Para impedir que a instância reinicie automaticamente, inclua o sinalizador --no-restart-on-failure .

• Para alterar o tempo limite local de recuperação de dados do SSD, se sua instância tiver discos SSD locais anexados, inclua o sinalizador --local-ssd-recovery-timeout .

• Para alterar o tempo limite do erro do host, inclua o sinalizador --host-error-timeout-seconds .

Por exemplo, para alterar o comportamento de manutenção do host, reinicie automaticamente a instância após erros do host ou paradas programadas, alterar o tempo limite local de recuperação de dados do SSD e alterar o tempo limite do erro do host, execute o seguinte comando:

gcloud compute instances set-scheduling INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Substitua o seguinte:

• INSTANCE_NAME : o nome da sua instância.

• ERROR_DETECTION_TIMEOUT : O número de segundos antes do mecanismo de computação reinicia uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE .

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• ZONE : a zona onde sua instância existe.

DESCANSAR

Para alterar a política de manutenção do host em uma instância existente, faça uma solicitação POST para as instances.setScheduling . No órgão de solicitação, inclua um ou mais dos seguintes campos:

• Para alterar o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para alterar o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para impedir que a instância reinicie automaticamente, inclua o campo automaticRestart .

• Para alterar o tempo limite local de recuperação de dados do SSD se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para alterar o tempo limite do erro do host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para alterar o comportamento de manutenção do host, reinicie automaticamente a instância após erros do host ou paradas programadas, altere o tempo limite local de recuperação de dados do SSD e altere o tempo limite do erro do host, faça uma solicitação da seguinte forma:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

{
  "automaticRestart": AUTOMATIC_RESTART,
  "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
  "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
  "onHostMaintenance": "MAINTENANCE_POLICY"
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto em que sua instância existe.

• ZONE : a zona onde sua instância existe.

• INSTANCE_NAME : o nome da sua instância.

• AUTOMATIC_RESTART : o comportamento automático de reinicialização da instância se ele travar ou calcular o motor o interrompe para uma parada programada. Especifique um dos seguintes valores:

  • Para deixar o mecanismo de computação reiniciar automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE .

Console

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

   Vá para Criar uma instância

2. No campo Nome , insira um nome para a instância.

3. Nos campos de região e zona , especifique em qual região e zona para criar a instância.

4. Especifique o tipo de máquina para a instância.

5. No menu de navegação, clique em Advanced .

6. Na seção Modelo de provisionamento , expanda as configurações avançadas do modelo de provisionamento da VM e, em seguida, faça um ou mais dos seguintes:

   • Para definir o comportamento durante os eventos de manutenção, na lista de manutenção do host , selecione uma das seguintes opções:

     • Para migrar a instância durante os eventos de manutenção do host, selecione Migrar a instância da VM (recomendada) .

     • Para interromper a instância durante os eventos de manutenção do host, selecione encerrar a instância da VM .

   • Para definir o período de tempo limite antes de reiniciar uma instância que não responde, na lista de tempo limite de erro do host , selecione uma das seguintes opções:

     • Para não especificar um tempo limite de erro do host, selecione não especificado (padrão) .

     • Para especificar um tempo limite de erro do host, selecione uma das opções disponíveis, até 5 minutos e 30 segundos .

   • Para definir se deve reiniciar a instância se ela travar ou for interrompida, na lista de reinicialização automática , selecione uma das seguintes opções:

     • Para reiniciar automaticamente a instância após erros do host ou paradas programadas, selecione em (recomendado) .

     • Para impedir que a instância reinicie automaticamente após erros do host ou paradas programadas, selecione OFF .

7. Clique em Criar .

gcloud

Para definir a política de manutenção do host de uma instância ao criá -la, use o gcloud compute instances create com um ou mais dos seguintes sinalizadores:

• Para definir o comportamento de manutenção do host, inclua a bandeira --maintenance-policy .

• Para definir o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o sinalizador --restart-on-failure .

  • Para impedir que a instância reinicie automaticamente, inclua o sinalizador --no-restart-on-failure .

• Para definir um tempo limite local de recuperação de dados SSD, se sua instância tiver discos SSD locais anexados, inclua o sinalizador --local-ssd-recovery-timeout .

• Para definir um tempo limite de erro do host, inclua o sinalizador --host-error-timeout-seconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite local de recuperação de dados e defina um tempo limite de erro do host, execute o seguinte comando:

gcloud compute instances create INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Substitua o seguinte:

• INSTANCE_NAME : o nome da instância.

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• MACHINE_TYPE : o tipo de máquina a ser usado.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE . Se você estiver criando uma VM spot, VM preventível ou uma instância que não suporta migração ao vivo , você só poderá usar TERMINATE .

• ZONE : a zona para criar a instância.

DESCANSAR

Para definir a política de manutenção do host de uma instância ao criá -la, faça uma solicitação POST para o método instances.insert . No órgão de solicitação, inclua um ou mais dos campos a seguir no campo scheduling :

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para impedir que a instância reinicie automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite local de recuperação de dados SSD se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro do host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite local de recuperação de dados e defina um tempo limite de erro do host, faça uma solicitação da seguinte forma:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "automaticRestart": AUTOMATIC_RESTART,
    "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
    "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto para criar a instância.

• ZONE : a zona para criar a instância.

• INSTANCE_NAME : o nome da instância.

• MACHINE_TYPE : o tipo de máquina a ser usado.

• IMAGE_PROJECT : o projeto de imagem que contém a imagem-por exemplo, debian-cloud . Para obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

• IMAGE : Especifique um dos seguintes:

  • Uma versão específica da imagem do sistema operacional-por exemplo, debian-12-bookworm-v20240617 .

  • Uma família de imagens , que deve ser formatada como family/ IMAGE_FAMILY . Isso especifica a imagem do sistema operacional mais recente e não deprecida. Por exemplo, se você especificar family/debian-12 , a versão mais recente da família Debian 12 Image é usada. Para obter mais informações sobre o uso de famílias da imagem, consulte as melhores práticas das famílias .

• AUTOMATIC_RESTART : o comportamento automático de reinicialização da instância se ele travar ou calcular o motor o interrompe para uma parada programada. Especifique um dos seguintes valores:

  • Para deixar o mecanismo de computação reiniciar automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• MAINTENANCE_POLICY : o comportamento de manutenção da instância. O valor pode ser TERMINATE ou MIGRATE . Se você está criando uma VM spot ou uma instância que não suporta migração ao vivo , só poderá usar TERMINATE .

gcloud

Para definir a Política de Manutenção do Host enquanto cria instâncias a granel, use o comando gcloud compute instances bulk create com um ou mais dos seguintes sinalizadores:

• Para definir o comportamento de manutenção do host, inclua a bandeira --maintenance-policy .

• Para definir o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o sinalizador --restart-on-failure .

  • Para impedir que a instância reinicie automaticamente, inclua o sinalizador --no-restart-on-failure .

• Para definir um tempo limite local de recuperação de dados SSD, se sua instância tiver discos SSD locais anexados, inclua o sinalizador --local-ssd-recovery-timeout .

• Para definir um tempo limite de erro do host, inclua o sinalizador --host-error-timeout-seconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite local de recuperação de dados SSD e definir um tempo limite de erro no host, execute o seguinte comando. O exemplo a seguir também cria instâncias em uma única zona e especifica um padrão de nome para as instâncias:

gcloud compute instances bulk create \
    --count=COUNT \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --restart-on-failure \
    --zone=ZONE

Substitua o seguinte:

• COUNT : o número de instâncias para criar.

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• MACHINE_TYPE : o tipo de máquina a ser usado.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você está criando VMs à vista, VMs preventíveis ou instâncias que não suportam migração ao vivo , você só poderá usar TERMINATE .

• NAME_PATTERN : o padrão de nome para as instâncias. Para substituir uma sequência de números em um nome de instância, use uma sequência de caracteres de hash ( # ). Por exemplo, usando instance-# para o padrão de nome, gera instâncias com nomes começando com instance-1 , instance-2 e continuando até o número de instância especificada pela COUNT .

• ZONE : a zona para criar as instâncias.

DESCANSAR

Para definir a Política de Manutenção do Host, criando instâncias a granel, faça uma solicitação POST para o método instances.bulkInsert . No órgão de solicitação, inclua um ou mais dos campos a seguir no campo scheduling :

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para impedir que a instância reinicie automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite local de recuperação de dados SSD se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro do host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite local de recuperação de dados e defina um tempo limite de erro do host, faça uma solicitação da seguinte forma. O exemplo a seguir também cria instâncias em uma única zona e especifica um padrão de nome para as instâncias:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto para criar as instâncias.

• ZONE : a zona para criar as instâncias.

• COUNT : o número de instâncias para criar.

• NAME_PATTERN : o padrão de nome para as instâncias. Para substituir uma sequência de números em um nome de instância, use uma sequência de caracteres de hash ( # ). Por exemplo, usando instance-# para o padrão de nome, gera instâncias com nomes começando com instance-1 , instance-2 e continuando até o número de instância especificada pela COUNT .

• MACHINE_TYPE : o tipo de máquina a ser usado.

• IMAGE_PROJECT : o projeto de imagem que contém a imagem-por exemplo, debian-cloud . Para obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

• IMAGE : Especifique um dos seguintes:

  • Uma versão específica da imagem do sistema operacional-por exemplo, debian-12-bookworm-v20240617 .

  • Uma família de imagens , que deve ser formatada como family/ IMAGE_FAMILY . Isso especifica a imagem do sistema operacional mais recente e não deprecida. Por exemplo, se você especificar family/debian-12 , a versão mais recente da família Debian 12 Image é usada. Para obter mais informações sobre o uso de famílias da imagem, consulte as melhores práticas das famílias .

• AUTOMATIC_RESTART : o comportamento automático de reinicialização da instância se ele travar ou calcular o motor o interrompe para uma parada programada. Especifique um dos seguintes valores:

  • Para deixar o mecanismo de computação reiniciar automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você está criando VMs à vista, VMs preventíveis ou instâncias que não suportam migração ao vivo , você só poderá usar TERMINATE .

Console

1. No Google Cloud Console, vá para a página Modelos de instância .

   Vá para modelos de instância

2. Clique em Criar modelo de instância . A página do modelo Create Instância é exibida.

3. No campo Nome , insira um nome para o modelo de instância.

4. Na seção Localização , selecione uma das seguintes opções:

   • Para criar um modelo de instância regional, selecione Regional (recomendado) e selecione a região para criar o modelo.

   • Para criar um modelo de instância global, selecione Global .

5. Na seção Configuração da máquina , especifique o tipo de máquina para o modelo de instância.

6. Na seção Modelo de provisionamento , expanda as configurações avançadas do modelo de provisionamento da VM e, em seguida, faça um ou mais dos seguintes:

   • Para alterar o comportamento durante os eventos de manutenção, na lista de manutenção do host , selecione uma das seguintes opções:

     • Para migrar a instância durante os eventos de manutenção do host, selecione Migrar a instância da VM (recomendada) .

     • Para interromper a instância durante os eventos de manutenção do host, selecione encerrar a instância da VM .

   • Para alterar o período de tempo limite antes de reiniciar uma instância que não responde, na lista de tempo limite de erro do host , selecione uma das seguintes opções:

     • Para não especificar um tempo limite de erro do host, selecione não especificado (padrão) .

     • Para especificar um tempo limite de erro do host, selecione uma das opções disponíveis, até 5 minutos e 30 segundos .

   • Para alterar se deve reiniciar a instância se ela travar ou for interrompida, na lista de reinicialização automática , selecione uma das seguintes opções:

     • Para reiniciar automaticamente a instância após erros do host ou paradas programadas, selecione em (recomendado) .

     • Para impedir que a instância reinicie automaticamente após erros do host ou paradas programadas, selecione OFF .

7. Clique em Criar .

gcloud

Para definir a Política de Manutenção do Host enquanto cria um modelo de instância, use o gcloud compute instance-templates create comando com um ou mais dos seguintes sinalizadores:

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para impedir que a instância reinicie automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite local de recuperação de dados SSD se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro do host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite local de recuperação de dados SSD e definir um tempo limite de erro no host, execute o seguinte comando. O exemplo a seguir também cria um modelo de instância regional. Para criar um modelo de instância global, use o mesmo comando sem o sinalizador --instance-template-region .

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --instance-template-region=REGION \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure

Substitua o seguinte:

• INSTANCE_TEMPLATE_NAME : o nome do modelo de instância.

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• REGION : a região para criar o modelo de instância.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• MACHINE_TYPE : o tipo de máquina a ser usado.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você estiver especificando uma VM spot, VM preventível ou tipo de instância que não suporta migração ao vivo no modelo de instância, você só poderá usar TERMINATE .

DESCANSAR

Para definir a política de manutenção do host enquanto cria um modelo de instância, faça uma solicitação POST para um dos seguintes métodos:

• Para criar um modelo de instância regional: regionInstanceTemplates.insert Método

• Para criar um modelo de instância global: instanceTemplates.insert Method

No órgão de solicitação, inclua um ou mais dos campos a seguir no campo scheduling :

• Para definir o comportamento de manutenção do host, inclua o campo onHostMaintenance .

• Para definir o comportamento automático de reinicialização, faça um dos seguintes:

  • Para reiniciar automaticamente a instância, inclua o campo automaticRestart .

  • Para impedir que a instância reinicie automaticamente, inclua o campo automaticRestart .

• Para definir um tempo limite local de recuperação de dados SSD se sua instância tiver discos SSD locais anexados, inclua o campo localSsdRecoveryTimeout .

• Para definir um tempo limite de erro do host, inclua o campo hostErrorTimeoutSeconds .

Por exemplo, para definir o comportamento de manutenção do host, reiniciar automaticamente a instância após erros do host ou paradas programadas, definir um tempo limite local de recuperação de dados e defina um tempo limite de erro do host, faça uma solicitação da seguinte forma. O exemplo a seguir também cria um modelo de instância regional.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto para criar o modelo de instância.

• REGION : a região para criar o modelo de instância.

• INSTANCE_TEMPLATE_NAME : o nome do modelo de instância.

• IMAGE_PROJECT : o projeto de imagem que contém a imagem-por exemplo, debian-cloud . Para obter mais informações sobre os projetos de imagem suportados, consulte Imagens públicas .

• IMAGE : Especifique um dos seguintes:

  • Uma versão específica da imagem do sistema operacional-por exemplo, debian-12-bookworm-v20240617 .

  • Uma família de imagens , que deve ser formatada como family/ IMAGE_FAMILY . Isso especifica a imagem do sistema operacional mais recente e não deprecida. Por exemplo, se você especificar family/debian-12 , a versão mais recente da família Debian 12 Image é usada. Para obter mais informações sobre o uso de famílias da imagem, consulte as melhores práticas das famílias .

• MACHINE_TYPE : o tipo de máquina a ser usado.

• AUTOMATIC_RESTART : o comportamento automático de reinicialização da instância se ele travar ou calcular o motor o interrompe para uma parada programada. Especifique um dos seguintes valores:

  • Para deixar o mecanismo de computação reiniciar automaticamente sua instância: true

  • Para evitar reinicializações automáticas: false

• ERROR_DETECTION_TIMEOUT : o número de segundos antes de reiniciar uma instância que não responde. O valor deve estar entre 90 (90 segundos) e 330 (330 segundos, ou 5 minutos e 30 segundos). Apenas 30 segundos são permitidos.

• LOCAL_SSD_RECOVERY_TIMEOUT : o número de horas para gastar dados de recuperação dos discos SSD locais anexados. O valor deve estar entre 0 (0 horas) e 168 (168 horas ou 7 dias). Definir esse campo como 0 significa que o mecanismo de computação não recupera dados SSD locais.

• MAINTENANCE_POLICY : o comportamento de manutenção das instâncias. O valor pode ser TERMINATE ou MIGRATE . Se você estiver especificando uma VM spot, VM preventível ou tipo de instância que não suporta migração ao vivo no modelo de instância, você só poderá usar TERMINATE .

Console

1. No console do Google Cloud, acesse a página de instâncias de VM .

   Acesse as instâncias de VM

2. In the Name column, click the instance that you want to view. A page that gives the details of the instance appears.

3. On the Details tab, in the Management section, in the Availability policies section, you can view the following:

   • In the On host maintenance field, you can see the instance's host maintenance behavior events.

   • In the Host error timeout field, you can see the amount of time the instance waits before restarting or stopping the instance after detecting that it's unresponsive. If the value is unset ( — ), then the default wait time is 5 minutes and 30 seconds.

   • In the Automatic restart restart field, you can see whether the instance automatically restarts the instance after it crashes or Compute Engine stops it for a programmed stop.

gcloud

To view the host maintenance policy for an instance, use the gcloud compute instances describe command with the --flatten flag set to scheduling :

 gcloud compute instances describe INSTANCE_NAME \
    --flatten=scheduling \
    --zone=ZONE

Substitua o seguinte:

• INSTANCE_NAME : o nome da instância.

• ZONE : the zone where the instance is located.

A saída é semelhante à seguinte:

---
scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

DESCANSAR

To view the host maintenance policy for an instance, make a GET request to the instances.get method . In the request URL, include the fields query parameter and set it to scheduling :

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?fields=scheduling

Substitua o seguinte:

• PROJECT_ID : the project where the instance exists.

• ZONE : the zone where the instance exists.

• INSTANCE_NAME : o nome da instância.

A saída é semelhante à seguinte:

{
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  }
}