Criar uma solicitação de reserva adiantada no modo de calendário

Console

É possível conferir a disponibilidade futura de VMs de GPU, VMs H4D ou TPUs em uma região ao criar uma solicitação de reserva adiantada no modo de calendário. Para mais informações, consulte Criar uma solicitação de reserva para VMs de GPU, VMs H4D ou TPUs neste documento.

gcloud

Para conferir a disponibilidade futura de VMs de GPU, VMs H4D ou TPUs em uma região, use um dos seguintes comandos gcloud beta compute advice calendar-mode. Com base nos recursos que você quer visualizar, inclua as seguintes flags:

• Para conferir a disponibilidade de VMs de GPU ou H4D, inclua as flags --vm-count e --machine-type:

  gcloud beta compute advice calendar-mode \
      --vm-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

• Para conferir a disponibilidade de TPUs, inclua as flags --chip-count e --tpu-version:

  gcloud beta compute advice calendar-mode \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

Substitua:

• NUMBER_OF_VMS: o número de VMs a serem reservadas. O valor precisa ser pelo menos 1 e não maior que 80 para VMs de GPU ou 256 para VMs de HPC H4D.

• MACHINE_TYPE: o tipo de máquina de GPU ou H4D a ser reservado. Especifique um dos seguintes valores:

  • Para tipos de máquina A4: a4-highgpu-8g

  • Para tipos de máquina A3 Ultra: a3-ultragpu-8g

  • Para tipos de máquina A3 Mega: a3-megagpu-8g

  • Para tipos de máquinas A3 High com 8 GPUs: a3-highgpu-8g

  • Para tipos de máquinas H4D HPC: consulte Tipos de máquinas H4D

• NUMBER_OF_CHIPS: o número de chips de TPU a serem reservados. O valor precisa ser 1, 4, 8, 16, 32, 64, 128, 256, 512 ou 1024.

• TPU_VERSION: a versão da TPU a ser reservada. Especifique um dos seguintes valores:

  • Para TPU7x: TPU7X

  • Para a TPU v6e: V6E

  • Para TPU v5p: V5P

  • Para a TPU v5e: V5E

  Se você especificar uma TPU v5e, inclua a flag --workload-type. Defina esta flag com o tipo de cargas de trabalho que você quer executar nas TPUs:

  • Para cargas de trabalho que processam grandes quantidades de dados em uma ou várias operações, como as de treinamento de machine learning (ML), especifique BATCH.

  • Para cargas de trabalho que processam solicitações simultâneas e exigem latência de rede mínima, como as de inferência de ML, especifique SERVING.

• REGION: a região em que as VMs de GPU, VMs H4D ou TPUs serão reservadas. Para verificar quais regiões e zonas são compatíveis, consulte Limitações.

• FROM_START_TIME e TO_START_TIME: as datas mais antigas e mais recentes em que você quer reservar capacidade. Formate essas datas como carimbos 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, separados por hífens (-).

  • HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).

  • OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Para não usar ajuste, especifique Z.

• FROM_END_TIME e TO_END_TIME: as datas de início e término da reserva de capacidade. Formate essas datas como carimbos de data/hora RFC 3339. Se você quiser especificar um intervalo de durações para o período de reserva em vez de horários de término, substitua a flag --end-time-range pela --duration-range.

O resultado será o seguinte:

- recommendationsPerSpec:
    spec:
      endTime: '2025-09-07T00:00:00Z'
      location: zones/us-central1-a
      otherLocations:
        zones/us-central1-b:
          details: Recommendation in this zone is possible.
          status: RECOMMENDED
        zones/us-central1-c:
          details: Temporarily no free capacity in this zone in the
          requested time window.
          status: NO_CAPACITY
        zones/us-central1-f:
          details: This machine family is not supported in this zone.
          status: NOT_SUPPORTED
      recommendationId: 0d3f005d-f952-4fce-96f2-6af25e1591eb
      recommendationType: FUTURE_RESERVATION
      startTime: '2025-06-09T00:00:00Z'

Se os recursos solicitados estiverem disponíveis, a saída vai conter os campos startTime, endTime e location. Esses campos especificam o horário de início mais cedo, o horário de término mais tarde e as zonas em que os recursos estão disponíveis.

REST

Para conferir a disponibilidade futura de VMs de GPU, VMs H4D ou TPUs em uma região, faça uma solicitação GET para o método advice.calendarMode da versão Beta. Com base nos recursos que você quer visualizar, inclua os seguintes campos no corpo da solicitação:

• Para conferir a disponibilidade de VMs de GPU ou H4D, inclua os campos instanceCount e machineType:

  POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "specificSkuResources": {
            "instanceCount": "NUMBER_OF_VMS",
            "machineType": "MACHINE_TYPE"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

• Para conferir a disponibilidade de TPU, inclua os campos acceleratorCount e vmFamily:

  POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "aggregateResources": {
            "acceleratorCount": "NUMBER_OF_CHIPS",
            "vmFamily": "TPU_VERSION"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

Substitua:

• PROJECT_ID: o ID do projeto em que você quer reservar recursos.

• REGION: a região em que você quer reservar VMs de GPU, VMs H4D ou TPUs. Para conferir as regiões e zonas compatíveis, consulte Limitações.

• NUMBER_OF_VMS: o número de VMs de GPU ou H4D a serem reservadas. Para VMs com GPU, o valor precisa estar entre 1 e 80. Para VMs H4D, o valor precisa estar entre 1 e 256.

• MACHINE_TYPE: o tipo de máquina de GPU ou H4D a ser reservado. Especifique um dos seguintes valores:

  • Para tipos de máquina A4: a4-highgpu-8g

  • Para tipos de máquina A3 Ultra: a3-ultragpu-8g

  • Para tipos de máquina A3 Mega: a3-megagpu-8g

  • Para tipos de máquinas A3 High com 8 GPUs: a3-highgpu-8g

  • Para tipos de máquinas H4D HPC: consulte Tipos de máquinas H4D

• NUMBER_OF_CHIPS: o número de chips de TPU a serem reservados. O valor precisa ser 1, 4, 8, 16, 32, 64, 128, 256, 512 ou 1024.

• TPU_VERSION: a versão da TPU a ser reservada. Especifique um dos seguintes valores:

  • Para TPU7x: VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X

  • Para a TPU v6e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

  • Para TPU v5p: VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

  • Para a TPU v5e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

  Se você especificar uma TPU v5e, inclua o campo workloadType no campo aggregateResources. Defina este campo como o tipo de cargas de trabalho que você quer executar nas TPUs:

  • Para cargas de trabalho que processam grandes quantidades de dados em uma ou várias operações, como as de treinamento de machine learning (ML), especifique BATCH.

  • Para cargas de trabalho que processam solicitações simultâneas e exigem latência de rede mínima, como as de inferência de ML, especifique SERVING.

• FROM_START_TIME e TO_START_TIME: as datas mais antigas e mais recentes em que você quer reservar capacidade. Formate essas datas como carimbos 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, separados por hífens (-).

  • HH:MM:SS: um horário formatado como uma hora de dois dígitos usando um horário de 24 horas, minutos de dois dígitos e segundos de dois dígitos, separados por dois pontos (:).

  • OFFSET: o fuso horário formatado como um ajuste de Tempo Universal Coordenado (UTC). Por exemplo, para usar o horário padrão do Pacífico (PST), especifique -08:00. Para não usar ajuste, especifique Z.

• FROM_END_TIME e TO_END_TIME: as datas de início e término da reserva de capacidade. Formate essas datas como carimbos de data/hora RFC 3339. Se você quiser especificar um intervalo de durações para o período de reserva em vez de horários de término, substitua os campos endTimeNotEarlierThan e endTimeNotLaterThan pelos campos minDuration e maxDuration.

O resultado será o seguinte:

{
  "recommendations": [
    {
      "recommendationsPerSpec": {
        "spec": {
          "recommendationId": "a21a2fa0-72c7-4105-8179-88de5409890b",
          "recommendationType": "FUTURE_RESERVATION",
          "startTime": "2025-06-09T00:00:00Z",
          "endTime": "2025-09-07T00:00:00Z",
          "otherLocations": {
            "zones/us-central1-b": {
              "status": "RECOMMENDED",
              "details": "Recommendation in this zone is possible."
            },
            "zones/us-central1-c": {
              "status": "NO_CAPACITY",
              "details": "Temporarily no free capacity in this zone in the
                          requested time window."
            },
            "zones/us-central1-f": {
              "status": "NOT_SUPPORTED",
              "details": "This machine family is not supported in this zone."
            }
          },
          "location": "zones/us-central1-a"
        }
      }
    }
  ]
}

Se os recursos solicitados estiverem disponíveis, a saída vai conter os campos startTime, endTime e location. Esses campos especificam o horário de início mais cedo, o horário de término mais tarde e as zonas em que os recursos estão disponíveis.

Console

1. No console do Cloud de Confiance , acesse a página Reservas.

   Acesse "Reservas"

2. Clique na guia Reservas adiantadas.

3. Clique em add_boxCriar reserva adiantada. A página Criar uma reserva adiantada aparece e o painel Configuração de hardware é selecionado.

4. Na seção Configurações, especifique as propriedades das VMs com GPU, VMs H4D ou TPUs que você quer reservar fazendo uma das seguintes ações:

   • Para especificar diretamente as propriedades de uma VM de GPU, H4D ou TPU, siga estas etapas:

     1. Selecione Especificar tipo de máquina.

     2. Clique na guia GPUs, TPUs ou Otimizada para computação e selecione um tipo de máquina de GPU, H4D ou versão de TPU compatível.

   • Para especificar propriedades de GPU ou VM H4D usando uma VM atual como referência, selecione Usar VM atual e escolha a VM.

5. Se você especificou uma TPU v5e (CT5LP) na etapa anterior, na lista Tipo de carga de trabalho da TPU v5, selecione uma das seguintes opções:

   • Para executar cargas de trabalho nas TPUs que processam grandes quantidades de dados em uma ou várias operações, como cargas de trabalho de treinamento de ML, selecione Lote.

   • Para executar cargas de trabalho nas TPUs que processam solicitações simultâneas e exigem latência de rede mínima, como as de inferência de ML, selecione Serviço.

6. Na seção Pesquisar capacidade, siga estas etapas:

   1. Nas listas Região e Zona, especifique a região e a zona em que você quer reservar recursos.

   2. No campo Capacidade total necessária (ao reservar VMs de GPU ou H4D) ou na lista Número de chips (ao reservar TPUs), especifique o número de VMs de GPU, VMs H4D ou chips de TPU a serem reservados. É possível especificar os seguintes valores:

      • Para VMs de GPU, um valor entre 1 e 80
      • Para VMs H4D, um valor entre 1 e 256
      • Para chips de TPU, um valor de 1, 4, 8, 16, 32, 64, 128, 256, 512 ou 1024

   3. Na lista Horário de início, selecione o horário de início da sua solicitação.

   4. Opcional: na lista Escolha a flexibilidade da data de início, selecione o nível de exatidão da data de início.

   5. No campo Duração da reserva, especifique por quanto tempo você quer reservar recursos.

   6. Clique em Pesquisar capacidade. Em seguida, na tabela Capacidade disponível, selecione uma das opções disponíveis que contenham o tipo, o número e o período de reserva das VMs de GPU, VMs H4D ou TPUs a serem reservadas.

7. Clique em Próxima.

8. Na seção Tipo de compartilhamento, selecione os projetos com que você quer compartilhar a capacidade solicitada:

   • Para usar a capacidade reservada apenas no seu projeto, selecione Local.

   • Para compartilhar a capacidade reservada com outros projetos, selecione Compartilhada, clique em add Adicionar projetos e siga as instruções para selecionar os projetos.

9. Clique em Próxima.

10. No campo Nome da reserva adiantada, insira um nome para a solicitação.

11. No campo Nome da reserva, insira o nome da reserva que o Compute Engine cria automaticamente para provisionar a capacidade solicitada.

12. Clique em Criar.

gcloud

Para criar uma solicitação de reserva adiantada no modo de calendário e enviar para análise, use um dos seguintes comandos gcloud beta compute future-reservations create. Com base nos recursos que você quer reservar, inclua as seguintes flags:

• Para reservar VMs de GPU ou H4D, inclua as flags --total-count, --machine-type e --deployment-type=DENSE:

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --total-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --deployment-type=DENSE \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

• Para reservar TPUs, inclua as flags --chip-count e --tpu-version:

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

Substitua:

• FUTURE_RESERVATION_NAME: o nome da solicitação.

• NUMBER_OF_VMS: o número de VMs de GPU ou H4D a serem reservadas. Para VMs com GPU, o valor precisa estar entre 1 e 80. Para VMs H4D, o valor precisa estar entre 1 e 256. Especifique um número de VMs igual ou menor que o número de VMs que você confirmou como disponíveis.

• MACHINE_TYPE: o tipo de máquina de GPU ou H4D a ser reservado.

• NUMBER_OF_CHIPS: o número de chips de TPU a serem reservados. Especifique um valor igual ou menor que o número de chips que você confirmou como disponíveis. O valor precisa ser um dos seguintes: 1, 4, 8, 16, 32, 64, 128, 256, 512 ou 1024.

• TPU_VERSION: a versão da TPU a ser reservada. Se você especificar uma TPU v5e (V5E), inclua a flag --workload-type para especificar o tipo de cargas de trabalho a serem executadas nas TPUs.

• RESERVATION_NAME: o nome da reserva que o Compute Engine cria automaticamente para provisionar a capacidade solicitada.

• SHARE_TYPE: se outros projetos na sua organização podem consumir a capacidade reservada. Especifique um dos seguintes valores:

  • Para usar a capacidade apenas no seu projeto: local

  • Para compartilhar capacidade com outros projetos: projects

  Se você especificar projects, inclua a flag --share-with definida como uma lista separada por vírgulas de IDs de projetos, por exemplo, project-1,project-2. É possível especificar até 100 projetos na sua organização. Não inclua o ID do projeto nessa lista. É possível consumir a capacidade reservada por padrão.

• START_TIME: o horário de início da solicitação, que precisa ser formatado como um carimbo de data/hora RFC 3339.

• END_TIME: o horário de término do período de reserva, que precisa ser formatado como um carimbo de data/hora RFC 3339. Se você quiser especificar uma duração, em segundos, para o período de reserva em vez de um horário de término, substitua a flag --end-time pela --duration.

• ZONE: a zona em que você quer reservar recursos.

REST

Para criar uma solicitação de reserva adiantada no modo de calendário e enviá-la para análise, envie a seguinte solicitação POST para o método futureReservations.insert da versão Beta. Com base nos recursos que você quer reservar, inclua os seguintes campos no corpo da solicitação:

• Para reservar VMs de GPU ou H4D, inclua os campos totalCount e machineType, além do campo deploymentType definido como DENSE:

  POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "deploymentType": "DENSE",
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "specificSkuProperties": {
      "totalCount": NUMBER_OF_VMS,
      "instanceProperties": {
        "machineType": "MACHINE_TYPE"
      }
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

• Para reservar TPUs, inclua os campos acceleratorCount e vmFamily:

  POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "aggregateReservation": {
      "reservedResources": [
        {
          "accelerator": {
            "acceleratorCount": NUMBER_OF_CHIPS
          }
        }
      ],
      "vmFamily": "TPU_VERSION"
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

Substitua:

• PROJECT_ID: o ID do projeto em que você quer criar a solicitação.

• ZONE: a zona em que você quer reservar recursos.

• FUTURE_RESERVATION_NAME: o nome da solicitação.

• RESERVATION_NAME: o nome da reserva que o Compute Engine cria automaticamente para provisionar a capacidade solicitada.

• SHARE_TYPE: se outros projetos na sua organização podem consumir a capacidade reservada. Especifique um dos seguintes valores:

  • Para usar a capacidade apenas no seu projeto: LOCAL

  • Para compartilhar capacidade com outros projetos: SPECIFIC_PROJECTS

  Se você especificar SPECIFIC_PROJECTS, no campo shareSettings, inclua o campo projectMap para especificar os projetos com que compartilhar a capacidade. É possível especificar até 100 projetos na sua organização. Não especifique o ID do projeto. Você pode consumir a capacidade reservada por padrão.

  Por exemplo, para compartilhar a capacidade solicitada com dois outros projetos, inclua o seguinte:

  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
  

  Substitua CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2 pelos IDs de dois projetos que você quer permitir que consumam a capacidade solicitada.

• NUMBER_OF_VMS: o número de VMs de GPU ou H4D a serem reservadas. Para VMs com GPU, o valor precisa estar entre 1 e 80. Para VMs H4D, o valor precisa estar entre 1 e 256. Especifique um número de VMs igual ou menor que o número de VMs que você confirmou como disponíveis.

• MACHINE_TYPE: o tipo de máquina de GPU ou H4D a ser reservado.

• NUMBER_OF_CHIPS: o número de chips de TPU a serem reservados. Especifique um valor igual ou menor que o número de chips que você confirmou como disponíveis. O valor precisa ser um dos seguintes: 1, 4, 8, 16, 32, 64, 128, 256, 512 ou 1024.

• TPU_VERSION: a versão da TPU a ser reservada. Se você especificar uma TPU v5e (VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP), inclua no campo aggregateResources o campo workloadType para especificar o tipo de cargas de trabalho a serem executadas nas TPUs.

• START_TIME: o horário de início da solicitação, que precisa ser formatado como um carimbo de data/hora RFC 3339.

• END_TIME: o horário de término do período de reserva, que precisa ser formatado como um carimbo de data/hora RFC 3339. Se você quiser especificar uma duração, em segundos, para o período de reserva em vez de um horário de término, substitua o campo endTime pelo campo duration.