Programar uma instância de VM para iniciar e parar

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. Clique na guia Programações de instância na parte superior da página.

3. Clique em date_range Criar agendamento . O painel Criar um agendamento é aberto.

4. Insira um Nome .

5. No menu suspenso Região , selecione o local para esta programação de instância.

6. Defina quando o agendamento da instância inicia e interrompe qualquer instância de VM anexada. Se você precisar que as instâncias de VM sejam iniciadas ou interrompidas em um horário específico, agende a operação 15 minutos antes do necessário. Certifique-se de que cada operação de início e parada tenha pelo menos 15 minutos de intervalo.

   Use os campos padrão Start time , Stop time e Frequency ou, se desejar configurar um planejamento mais complexo, use expressões cron .

   • Campos padrão:

     1. Insira um horário de início , um horário de término ou ambos.
        • No campo Hora de início , digite ou clique em access_time para selecionar a hora de início das instâncias de VM.
        • No campo Horário de término , digite ou clique em access_time para selecionar o horário para interromper as instâncias de VM.
     2. No menu suspenso Frequência na parte inferior do painel, selecione com que frequência o horário de início e o horário de término se repetem.

   • Expressões Cron:

     1. Para ativar expressões cron, clique no botão Usar expressão CRON na parte superior do painel.
     2. Insira uma expressão Start CRON , Stop CRON expression ou ambas.
        • No campo Iniciar expressão CRON , insira uma expressão cron que descreva quando iniciar instâncias de VM.
        • No campo Parar expressão CRON , insira uma expressão cron que descreva quando parar instâncias de VM.

7. No menu suspenso Fuso horário , selecione o fuso horário para Hora de início e Hora de término .

8. Opcional: No campo Data de início , digite ou clique em date_range para selecionar a data e a hora em que deseja que esse planejamento de instância comece. Se omitido, o cronograma entra em vigor imediatamente.

9. Opcional: No campo Data de término , digite ou clique em date_range para selecionar a data e a hora em que deseja que esse planejamento de instância termine. Se omitido, o cronograma terá efeito indefinidamente.

10. Clique em Enviar .

gcloud

Para criar uma programação de instância usando a CLI gcloud, use o comando gcloud compute resource-policies create instance-schedule :

gcloud compute resource-policies create instance-schedule SCHEDULE_NAME \
    --region=REGION \
    [--vm-start-schedule='START-OPERATION_SCHEDULE'] \
    [--vm-stop-schedule='STOP-OPERATION_SCHEDULE'] \
    [--timezone=TIME_ZONE] \
    [--initiation-date=INITIATION_DATE] \
    [--end-date=END_DATE]

Substitua o seguinte:

• SCHEDULE_NAME : o nome do novo agendamento da instância.
• REGION : a região onde estão localizadas as instâncias de VM que você deseja anexar a esse agendamento de instância.
• Especifique pelo menos um dos seguintes:
  • START-OPERATION_SCHEDULE : uma programação que descreve quando as instâncias de VM anexadas são iniciadas, formatadas como uma expressão cron. Se você precisar que as instâncias de VM sejam iniciadas em um horário específico, agende a operação 15 minutos antes do necessário. Para obter mais informações, consulte cronograma de início de operação .
  • STOP-OPERATION_SCHEDULE : um agendamento que descreve quando as instâncias de VM anexadas são interrompidas, formatadas como uma expressão cron. Se você precisar que as instâncias de VM parem em um horário específico, agende a operação 15 minutos antes do necessário. Para obter mais informações, consulte cronograma de parada de operação .
• TIME_ZONE : Opcional: o fuso horário da IANA baseado em localização para esta programação de instância. Se omitido, o valor padrão UTC será usado. Para obter mais informações, consulte fuso horário .
• INITIATION_DATE : Opcional: a primeira data em que o agendamento da instância entra em vigor, formatado como um carimbo de data/hora RFC 3339. Se omitido, o cronograma entra em vigor imediatamente. Para obter mais informações, consulte data de início .
• END_DATE : Opcional: a última data em que o agendamento da instância entrou em vigor, formatado como um carimbo de data/hora RFC 3339. Se omitido, o cronograma terá efeito indefinidamente. Para obter mais informações, consulte data de término .

DESCANSAR

Para criar uma programação de instância usando a API Compute Engine, faça uma solicitação usando o método resourcePolicies.insert :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
  "name": "SCHEDULE_NAME",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "START-OPERATION_SCHEDULE"
    },
    "vmStopSchedule": {
      "schedule": "STOP-OPERATION_SCHEDULE"
    },
    "timeZone": "TIME_ZONE",
    "startTime":"INITIATION_DATE",
    "expirationTime":"END_DATE"
  }
}

Substitua o seguinte:

• PROJECT : seu ID do projeto .
• REGION : a região onde estão localizadas as instâncias de VM que você deseja anexar a esse agendamento de instância.
• SCHEDULE_NAME : o nome do novo agendamento da instância.
• START-OPERATION_SCHEDULE ou STOP-OPERATION_SCHEDULE : especifique pelo menos um dos seguintes:
  • START-OPERATION_SCHEDULE : uma programação que descreve quando as instâncias de VM anexadas são iniciadas, formatadas como uma expressão cron. Se você precisar que as instâncias de VM sejam iniciadas em um horário específico, agende a operação 15 minutos antes do necessário. Para obter mais informações, consulte cronograma de início de operação .
  • STOP-OPERATION_SCHEDULE : um agendamento que descreve quando as instâncias de VM anexadas são interrompidas, formatadas como uma expressão cron. Se você precisar que as instâncias de VM parem em um horário específico, agende a operação 15 minutos antes do necessário. Para obter mais informações, consulte cronograma de parada de operação .
• TIME_ZONE : o fuso horário da IANA baseado em localização para esta programação de instância. Para obter mais informações, consulte fuso horário .
• INITIATION_DATE : Opcional: a primeira data em que o agendamento da instância entra em vigor, formatado como um carimbo de data/hora RFC 3339. Se omitido, o cronograma entra em vigor imediatamente. Para obter mais informações, consulte data de início .
• END_DATE : Opcional: a última data em que o agendamento da instância entrou em vigor, formatado como um carimbo de data/hora RFC 3339. Se omitido, o cronograma terá efeito indefinidamente. Para obter mais informações, consulte data de término .

Console

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

   Acesse as instâncias de VM

2. Clique na guia Programações de instância na parte superior da página. Isso exibe uma lista de todos os cronogramas de instância deste projeto.

gcloud

Para visualizar uma lista de todas as suas políticas de recursos, incluindo programações de instâncias, usando a CLI gcloud, use o comando gcloud compute resource-policies list . Opcionalmente, para restringir os resultados a uma região específica, inclua o sinalizador --filter .

gcloud compute resource-policies list \
    [--filter="region:(REGION)"]

Substitua o seguinte:

• REGION : Opcional: a região onde estão localizados os agendamentos de instância que você deseja listar.

DESCANSAR

Para visualizar uma lista de todas as suas políticas de recursos, incluindo programações de instâncias, em uma região específica usando a API Compute Engine, faça uma solicitação usando o método resourcePolicies.list :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies

Substitua o seguinte:

• PROJECT : seu ID do projeto .
• REGION : a região onde estão localizados os agendamentos de instância que você deseja listar.

Console

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

   Acesse as instâncias de VM

2. Clique na guia Programações de instância na parte superior da página. Isso exibe uma lista de todos os cronogramas de instância deste projeto.

3. Clique no nome do agendamento da instância que você deseja descrever. Isso abre a página de detalhes dos agendamentos de instâncias desse agendamento.

gcloud

Para descrever uma programação de instância usando a CLI gcloud, use o comando gcloud compute resource-policies describe :

gcloud compute resource-policies describe SCHEDULE_NAME \
    --region=REGION

Substitua o seguinte:

• SCHEDULE_NAME : o nome do agendamento da instância que você deseja descrever.
• REGION : a região onde o agendamento da instância está localizado.

A saída é semelhante à seguinte:

...
description: Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.
...
instanceSchedulePolicy:
 expirationTime: '2022-12-31T23:59:59Z'
 startTime: '2022-01-01T00:00:00Z'
 timeZone: UTC
 vmStartSchedule:
   schedule: 0 8 * * MON-FRI
 vmStopSchedule:
   schedule: 0 17 * * MON-FRI
...
name: example-instance-schedule
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-west1
resourceStatus:
 instanceSchedulePolicy:
   nextRunStartTime: '2022-01-03T08:00:00Z'
...
status: READY

DESCANSAR

Para descrever uma programação de instância usando a API Compute Engine, faça uma solicitação usando o método resourcePolicies.get :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME

Substitua o seguinte:

• PROJECT : seu ID do projeto .
• REGION : a região onde o agendamento da instância está localizado.
• SCHEDULE_NAME : o nome do agendamento da instância que você deseja descrever.

A saída é semelhante à seguinte:

{
  ...
  "description": "Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.",
  "name": "example-instance-schedule",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "0 8 * * MON-FRI"
    },
    "vmStopSchedule": {
      "schedule": "0 17 * * MON-FRI"
    },
    "timeZone": "UTC",
    "startTime": "2022-01-01T00:00:00Z",
    "expirationTime": "2022-12-31T23:59:59Z"
  },
  "status": "READY",
  "resourceStatus": {
    "instanceSchedulePolicy": {
      "nextRunStartTime": "2022-01-03T08:00:00Z"
    }
  },
  ...
}

Console

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

   Acesse as instâncias de VM

2. Clique na guia Programações de instância na parte superior da página. Isso exibe uma lista de todos os cronogramas de instância deste projeto.

3. Marque as caixas de seleção dos agendamentos de instância que você deseja excluir.

4. Clique em delete Excluir na parte superior da página. Isso abre uma nova caixa de diálogo para confirmar esta ação.

5. Na caixa de diálogo, clique em Excluir .

gcloud

1. Se esta programação de instância estiver anexada a qualquer instância de VM, remova-a.
   1. Para verificar a quais instâncias de VM esta programação está anexada, descreva a programação da instância .
   2. Para cada instância de VM à qual esta programação está anexada, remova a programação da instância .

2. Para excluir uma programação de instância usando a CLI gcloud, use o comando gcloud compute resource-policies delete :

   gcloud compute resource-policies delete SCHEDULE_NAME \
      --region=REGION
   

   Substitua o seguinte:

   • SCHEDULE_NAME : o nome do agendamento da instância que você deseja excluir.
   • REGION : a região onde o agendamento da instância está localizado.

DESCANSAR

1. Se esta programação de instância estiver anexada a qualquer instância de VM, remova-a.
   1. Para verificar a quais instâncias de VM esta programação está anexada, descreva a programação da instância .
   2. Para cada instância de VM à qual esta programação está anexada, remova a programação da instância .

2. Para excluir uma programação de instância usando a API Compute Engine, faça uma solicitação usando o método resourcePolicies.delete :

   DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME
   

   Substitua o seguinte:

   • PROJECT : seu ID do projeto .
   • REGION : a região onde o agendamento da instância está localizado.
   • SCHEDULE_NAME : o nome do agendamento da instância que você deseja excluir.

Console

Não é possível anexar uma programação de instância ao criar uma instância usando o console do Google Cloud. Para usar o console do Google Cloud para anexar uma programação de instância a uma nova instância de VM, crie uma instância de VM e anexe uma programação à instância de VM .

gcloud

Para anexar uma programação de instância a uma instância de VM usando a CLI gcloud, use o comando gcloud compute instances create com a sinalização --resource-policies . Por exemplo, para criar uma instância de VM a partir de uma imagem pública com uma programação de instância anexada, use o seguinte comando:

gcloud compute instances create VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    [--image-project IMAGE_PROJECT]

Substitua o seguinte:

• VM_NAME : o nome da instância de VM à qual você deseja anexar uma programação de instância.
• SCHEDULE_NAME : o nome do agendamento da instância que você deseja anexar.
• ZONE : a zona onde sua instância de VM está localizada.
• Opcional: crie uma instância de VM a partir de uma imagem pública:
  • IMAGE ou IMAGE_FAMILY : especifique um dos seguintes:
  • IMAGE : a versão necessária de uma imagem pública. Por exemplo, --image debian-10-buster-v20200309 .
  • IMAGE_FAMILY : uma família de imagens . Isso cria a VM a partir da imagem do sistema operacional mais recente e não obsoleta. Por exemplo, se você especificar --image-family debian-10 , o Compute Engine criará uma VM a partir da versão mais recente da imagem do sistema operacional na família de imagens Debian 10.
  • IMAGE_PROJECT : o projeto que contém a imagem.

DESCANSAR

Para anexar uma programação de instância a uma instância de VM usando a API Compute Engine, faça uma solicitação usando o método instances.insert e inclua o atributo resourcePolicies . Por exemplo, para criar uma instância de VM a partir de uma imagem pública com uma programação de instância anexada, faça a seguinte solicitação:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ],
  "resourcePolicies": [
    "https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
  ]
}

Substitua o seguinte:

• PROJECT_ID : o ID do projeto no qual criar a VM.
• ZONE : a zona na qual criar a VM.
• MACHINE_TYPE_ZONE : a zona que contém o tipo de máquina a ser usada para a nova VM.
• MACHINE_TYPE : o tipo de máquina, predefinido ou personalizado , para a nova VM.
• VM_NAME : o nome da nova VM.
• Opcional: crie uma instância de VM a partir de uma imagem pública:
  • IMAGE_PROJECT : o projeto que contém a imagem. Por exemplo, se você especificar family/debian-10 como a família da imagem, especifique debian-cloud como o projeto da imagem.
  • IMAGE ou IMAGE_FAMILY : especifique um dos seguintes:
  • IMAGE : a versão necessária de uma imagem pública. Por exemplo, "sourceImage": "projects/debian-cloud/global/images/debian-10-buster-v20200309"
  • IMAGE_FAMILY : uma família de imagens . Isso cria a VM a partir da imagem do sistema operacional mais recente e não obsoleta. Por exemplo, se você especificar "sourceImage": "projects/debian-cloud/global/images/family/debian-10" , o Compute Engine criará uma VM a partir da versão mais recente da imagem do sistema operacional na família de imagens Debian 10.
• REGION : a região onde o agendamento da instância está localizado.
• SCHEDULE_NAME : o nome do agendamento da instância que você deseja anexar.

Console

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

   Acesse as instâncias de VM

2. Clique na guia Programações de instância na parte superior da página. Isso exibe uma lista de todos os cronogramas de instância deste projeto.

3. Clique no nome do agendamento da instância que você deseja anexar. A página de detalhes do agendamento da instância é aberta.

4. Clique em Adicionar instâncias para agendar . O painel Adicionar instâncias ao agendamento é aberto.

5. Marque a caixa de seleção de cada instância de VM à qual você deseja anexar esta programação.

6. Clique em Adicionar .

gcloud

Para anexar uma programação de instância a uma instância de VM usando a CLI gcloud, use o comando gcloud compute instances add-resource-policies :

gcloud compute instances add-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE

Substitua o seguinte:

• VM_NAME : o nome da instância de VM à qual você deseja anexar uma programação de instância.
• SCHEDULE_NAME : o nome do agendamento da instância que você deseja anexar.
• ZONE : a zona onde sua instância de VM está localizada.

DESCANSAR

Para anexar uma programação de instância a uma instância de VM usando a API Compute Engine, faça uma solicitação usando o método instances.addResourcePolicies :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/addResourcePolicies
{
  "resourcePolicies": "projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

Substitua o seguinte:

• PROJECT : seu ID do projeto .
• ZONE : a zona onde sua instância de VM está localizada.
• VM_NAME : o nome da instância de VM à qual você deseja anexar uma programação de instância.
• REGION : a região onde o agendamento da instância está localizado.
• SCHEDULE_NAME : o nome do agendamento da instância que você deseja anexar.

Console

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

   Acesse as instâncias de VM

2. Clique na guia Programações de instância na parte superior da página. Uma lista de todos os planejamentos de instância deste projeto é exibida.

3. Clique no nome do agendamento da instância que você deseja remover. A página de detalhes do agendamento da instância é aberta.

4. Na seção Instâncias anexadas , marque a caixa de seleção de cada instância de VM que você deseja remover desta programação.

5. Clique em delete Remover instâncias do agendamento . Isso abre uma nova caixa de diálogo para confirmar esta ação.

6. Na caixa de diálogo, clique em Remover .

gcloud

Para remover uma programação de instância de uma instância de VM usando a CLI gcloud, use o comando gcloud compute instances remove-resource-policies :

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE

Substitua o seguinte:

• VM_NAME : o nome da instância de VM da qual você deseja remover uma programação de instância.
• SCHEDULE_NAME : o nome do agendamento da instância que você deseja remover.
• ZONE : a zona onde sua instância de VM está localizada.

DESCANSAR

Para remover uma programação de instância de uma instância de VM usando a API Compute Engine, faça uma solicitação usando o método instances.removeResourcePolicies :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/removeResourcePolicies
{
  "resourcePolicies": "projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

Substitua o seguinte:

• PROJECT : seu ID do projeto .
• ZONE : a zona onde sua instância de VM está localizada.
• VM_NAME : o nome da instância de VM da qual você deseja remover uma programação de instância.
• REGION : a região onde o agendamento da instância está localizado.
• SCHEDULE_NAME : o nome do agendamento da instância que você deseja remover.