Esta página foi traduzida pela API Cloud Translation.

Reservar capacidade com sua equipe de contas

Neste documento, explicamos como conseguir capacidade quando você quer usar as reservas futuras para reservar blocos de capacidade. Esse método de provisionamento permite criar clusters de HPC com recursos aprimorados de gerenciamento.

Para ter uma garantia muito alta de que suas cargas de trabalho têm os recursos necessários, peça uma reserva futura ao Google. Essa ação permite reservar blocos de capacidade por um período definido, começando em uma data e hora específicas que você escolher. Com base na sua solicitação, o Google cria um rascunho de solicitação de reserva adiantada. Depois que você revisar e enviar esse rascunho de solicitação, e Google Cloud aprovar, o Compute Engine vai criar automaticamente (criação automática) uma reserva vazia. Depois, no horário de início escolhido, o Compute Engine provisiona a capacidade solicitada na reserva criada automaticamente. Em seguida, é possível usar a reserva para criar instâncias de máquina virtual (VM) até o fim do período de reserva.

Se você não precisar reservar blocos densos de capacidade para suas instâncias, consulte Modelos de provisionamento de instâncias do Compute Engine.

Limitações

Esta seção descreve as limitações para solicitações de reserva adiantada e para a reserva criada automaticamente para uma solicitação.

Limitações para solicitações de reserva adiantada

Depois que o Google cria um rascunho de solicitação de reserva adiantada para você, as seguintes limitações se aplicam:

Não é possível modificar os detalhes da solicitação, incluindo o tipo de compartilhamento.
Depois que o pedido é enviado, aprovado e o estado muda para PROVISIONING, não é possível cancelar ou excluir. Você se compromete a pagar pela capacidade solicitada a partir do horário de início do pedido, independente do uso.

Limitações das reservas criadas automaticamente

Depois que o Compute Engine cria uma reserva imediata para atender à capacidade solicitada, as seguintes limitações se aplicam:

Só é possível usar ou modificar a reserva após o horário de início da solicitação.
Só é possível modificar a reserva conforme descrito em Ativar notificações de manutenção de emergência de hardware.

Para modificar outras propriedades em uma reserva, entre em contato com a equipe da sua conta.
Não é possível excluir a reserva manualmente. Se, ao reservar capacidade, você especificar que não quer excluir automaticamente a reserva no final do período, entre em contato com sua equipe de conta para excluir a reserva.

Antes de começar

Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:
  gcloud init
  Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
  
  Observação: se você já instalou a gcloud CLI, execute o comando gcloud components update para verificar se você tem a versão mais recente.
2. Set a default region and zone.
REST

Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber as permissões necessárias para criar uma solicitação de reserva adiantada, peça ao administrador para conceder a você o papel do IAM de Usuário da reserva adiantada do Compute (roles/compute.futureReservationUser) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para criar uma solicitação de reserva adiantada. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para criar uma solicitação de reserva adiantada:

Para permitir que o Compute Engine crie reservas automaticamente: compute.reservations.create no projeto
Para criar uma solicitação de reserva futura: compute.futureReservations.create no projeto
Para especificar um modelo de instância: compute.instanceTemplates.useReadOnly no modelo de instância

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Cota

Como parte do processo de solicitação de reserva adiantada, o Google gerencia a cota dos seus recursos reservados. Não é necessário solicitar cota. No horário de início da sua reserva adiantada aprovada, o Google aumenta sua cota se você não tiver o suficiente para os recursos reservados.

Visão geral

Para reservar blocos de capacidade, siga estas etapas:

Solicite capacidade à equipe da sua conta. Entre em contato com sua equipe de conta para especificar o tipo e o número de recursos que você quer reservar.
Revisar e enviar um rascunho de pedido de reserva. Depois que o Google criar um rascunho de solicitação de reserva adiantada, revise-o. Se estiver tudo certo, envie o pedido de revisão.O Google Cloud vai aprovar imediatamente.

Solicitar capacidade pela equipe da sua conta

Entre em contato com sua equipe de conta e forneça as seguintes informações para que o Google crie um rascunho de solicitação de reserva adiantada:

Número do projeto: o número do projeto em que sua equipe de contas cria a solicitação e o Compute Engine provisiona a capacidade.
Tipo de máquina: o tipo de máquina a ser reservado. Você pode especificar uma das seguintes opções:
- h4d-standard-192
- h4d-highmem-192
- h4d-highmem-192-lssd
Zona: a zona em que você quer reservar capacidade. Para conferir as regiões e zonas disponíveis para o tipo de máquina, consulte Regiões e zonas disponíveis.
Contagem total: o número total de VMs a serem reservadas. Só é possível reservar múltiplos de duas VMs. Os tamanhos de bloco e a contagem de VMs por bloco variam de acordo com o tipo de máquina e a disponibilidade. Sua equipe de conta pode fornecer mais detalhes sobre sua solicitação.
Horário de início: o horário de início do período de reserva. Você pode começar a usar a capacidade reservada nesse momento. Formate o horário de início como um carimbo de data/hora RFC 3339 da seguinte maneira:
```
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.
Horário de término: o horário de término do período de reserva. Formate como um carimbo de data/hora RFC 3339. Nesse momento, o Compute Engine faz o seguinte:
- O Compute Engine exclui a reserva criada automaticamente.
- Com base na ação de encerramento especificada para as instâncias de VM, o Compute Engine interrompe ou exclui todas as instâncias de VM criadas usando a reserva criada automaticamente.
Nome da reserva: o nome da reserva que o Compute Engine cria para entregar a capacidade reservada. O Compute Engine só pode criar reservas especificamente segmentadas.
Exclusão automática de reserva: se você quer que o Compute Engine exclua automaticamente a reserva criada automaticamente no final do período de reserva. Se quiser excluir a reserva manualmente, entre em contato com sua equipe de conta.
Tipo de programação de manutenção: como o Compute Engine programa a manutenção do host para as instâncias de VM no seu cluster. Especifique uma das seguintes opções:
- Para sincronizar a manutenção em todas as instâncias do H4D nos blocos reservados, use GROUPED.
- Para usar programações de manutenção diferentes nas instâncias H4D, use INDEPENDENT.
Modo operacional da reserva: se você ou Google Cloud gerencia o processo de recuperação da instância de VM após um erro ou relatório de host com falha.

Para instâncias H4D, especifique Modo gerenciado (HIGHLY_AVAILABLE_CAPACITY). Esse modo permite que o Google Cloud gerencie o processo de manutenção e recuperação de uma instância substituindo automaticamente máquinas com falha. Essa abordagem aumenta a disponibilidade das suas instâncias e ajuda você a reiniciá-las rapidamente em novos hosts. No entanto, a topologia das instâncias pode mudar depois que o Compute Engine substitui uma máquina.

Importante:no modo gerenciado, as chamadas para a API "report faulty host" podem ser limitadas por taxa por reserva.
Tipo de compartilhamento: se apenas seu projeto pode usar a reserva criada automaticamente (LOCAL) ou se outros projetos podem usar a reserva (SPECIFIC_PROJECTS). Essa propriedade não pode ser alterada depois que você envia a solicitação. Para compartilhar a capacidade reservada com outros projetos na sua organização, faça o seguinte:
1. Se ainda não tiver feito isso, verifique se o projeto em que o Google cria a solicitação tem permissão para criar reservas compartilhadas.
2. Informe os números dos projetos com que você quer compartilhar a capacidade reservada. Você pode especificar até 100 projetos na sua organização.
Nome do compromisso: se o período de reserva for de um ano ou mais, compre e anexe um compromisso baseado em recursos aos recursos reservados. Para períodos de reserva de um ano a menos de três anos, o compromisso oferece a taxa de desconto por compromisso de uso (CUD) de um ano. Para períodos de reserva de 3 a menos de 6 anos, o compromisso oferece a taxa de CUD de 3 anos.

Se você compartilhar a capacidade reservada com outros projetos, eles vão receber descontos apenas se usarem a mesma conta do Cloud Billing que o projeto em que você reservou a capacidade. Para mais detalhes, consulte Ativar o compartilhamento de CUD para compromissos baseados em recursos.

O compromisso tem as mesmas datas de início e término da sua reserva, mas os horários de ativação podem ser diferentes. Se você especificar o horário de início da reserva como 0h do Horário do Pacífico dos EUA e do Canadá, o compromisso será ativado às 0h na data de início escolhida. Se você especificar um horário de início diferente, o compromisso será ativado às 0h do dia seguinte à data de início escolhida.

Atenção:para garantir que o uso da sua reserva se qualifique para CUDs e evitar pagar taxas sob demanda, aguarde até que o compromisso seja ativado antes de usar a reserva.

Depois que o Google cria o rascunho da solicitação de reserva adiantada, sua equipe de conta entra em contato com você.

Revisar e enviar um rascunho de solicitação de reserva

Depois que você informa ao time de contas o tipo e a quantidade de recursos a serem reservados, o Google cria um rascunho de solicitação de reserva adiantada. Você pode revisar o rascunho da solicitação e, se estiver tudo certo, enviar para análise. É necessário enviar a solicitação antes do horário de início.

Atenção:ao enviar uma solicitação, você confirma seu compromisso de reservar a capacidade solicitada. Depois que Google Cloud aprovar a solicitação e o estado dela mudar para PROVISIONING, não será possível cancelar, modificar ou excluir a solicitação. Você se compromete a pagar pela capacidade solicitada a partir do horário de início da solicitação, mesmo que não use a capacidade.

Para analisar e enviar um rascunho de solicitação de reserva adiantada, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Reservas.

Acesse "Reservas"
Clique na guia Reservas adiantadas. A tabela Reservas adiantadas lista cada solicitação de reserva adiantada no projeto, e cada coluna da tabela descreve uma propriedade.
Na coluna Nome, clique no nome da solicitação de rascunho que o Google criou para você. Uma página com os detalhes da solicitação de reserva adiantada vai aparecer.
Na seção Informações básicas, verifique se os detalhes da solicitação, como Datas e Tipo de compartilhamento, estão corretos. Além disso, se você solicitou um compromisso, verifique se ele foi especificado. Se algum desses detalhes estiver incorreto, entre em contato com sua equipe de contas.
Se tudo estiver correto, envie sua solicitação:
1. Clique em Editar rascunho. Uma página para modificar o rascunho da solicitação é exibida.
2. Clique em Criar. A página Reserva é exibida. Google Cloud aprova sua solicitação em alguns minutos e o Compute Engine cria uma reserva vazia com os recursos solicitados.

gcloud

Para conferir uma lista de solicitações de reserva adiantadas no projeto, use o comando gcloud compute future-reservations list com a flag --filter definida como PROCUREMENT_STATUS=DRAFTING:
```
gcloud compute future-reservations list --filter=PROCUREMENT_STATUS=DRAFTING
```
Na saída do comando, procure a solicitação de reserva com o nome que você forneceu à equipe de conta.

Para conferir os detalhes da solicitação de rascunho, use o comando gcloud compute future-reservations describe:

gcloud compute future-reservations describe FUTURE_RESERVATION_NAME \
    --zone=ZONE

Substitua:

FUTURE_RESERVATION_NAME: o nome do rascunho de solicitação de reserva adiantada.
ZONE: a zona em que o Google criou a solicitação.

O resultado será o seguinte:

autoCreatedReservationsDeleteTime: '2026-02-10T19:20:00Z'
creationTimestamp: '2025-11-27T11:14:58.305-08:00'
deploymentType: DENSE
id: '7979651787097007552'
kind: compute#futureReservation
name: example-draft-request
planningStatus: DRAFT
reservationName: example-reservation
schedulingType: INDEPENDENT
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/example-draft-request
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552
specificReservationRequired: true
specificSkuProperties:
   instanceProperties:
     localSsds:
  -   diskSizeGb: '375'
      interface: NVME
    ...
  machineType: h4d-highmem-192-lssd
totalCount: '2'
status:
  autoCreatedReservations:
  -   https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/reservations/example-reservation
  fulfilledCount: '2'
  lockTime: '2026-01-27T19:15:00Z'
  procurementStatus: DRAFTING
timeWindow:
  endTime: '2026-02-10T19:20:00Z'
  startTime: '2026-01-27T19:20:00Z'
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b

Na saída do comando, verifique se os detalhes da solicitação, como o período da reserva e o tipo de compartilhamento, estão corretos. Além disso, se você comprou um contrato de fidelidade, verifique se ele está especificado. Se os detalhes estiverem incorretos, entre em contato com sua equipe de contas.
Para enviar o rascunho da solicitação para análise, use o comando gcloud compute future-reservations update com a flag --planning-status definida como SUBMITTED:
```
gcloud compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE
```
Em alguns minutos, Google Cloud aprova sua solicitação e o Compute Engine cria uma reserva vazia com os recursos solicitados.

REST

Para conferir uma lista de solicitações de reserva adiantadas no projeto, faça uma solicitação GET para o método futureReservations.list. No URL da solicitação, inclua o parâmetro de consulta filter e defina-o como status.procurementStatus=DRAFTING.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations?filter=status.procurementStatus=DRAFTING
```
Substitua:
- PROJECT_ID: o ID do projeto em que o Google criou a solicitação de reserva adiantada em rascunho.
- ZONE: a zona em que a solicitação existe.
Na saída da solicitação, procure a solicitação de reserva com o nome que você forneceu à equipe de conta.

Para conferir os detalhes do rascunho da solicitação, faça uma solicitação GET para o método futureReservations.get da versão Beta:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

Substitua FUTURE_RESERVATION_NAME pelo nome do rascunho da solicitação de reserva futura.

O resultado será o seguinte:

{
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "h4d-highmem-192-lssd",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        ...
      ]
    },
    "totalCount": "2"
  },
  "kind": "compute#futureReservation",
  "id": "7979651787097007552",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b",
  "name": "example-draft-request",
  "timeWindow": {
    "startTime": "2026-01-27T19:20:00Z",
    "endTime": "2026-02-10T19:20:00Z"
  },
  "status": {
    "procurementStatus": "DRAFTING",
    "lockTime": "2026-01-27T19:15:00Z"
    },
  "planningStatus": "DRAFT",
  "specificReservationRequired": true,
  "reservationName": "example-reservation",
  "deploymentType": "DENSE",
  "schedulingType": "INDEPENDENT",
  "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
}

Na saída, verifique se os detalhes da solicitação, como o período de reserva e o tipo de compartilhamento, estão corretos. Além disso, se você pediu um compromisso, verifique se ele foi especificado. Se os detalhes estiverem incorretos, entre em contato com a equipe da sua conta.
Para enviar o rascunho da solicitação para análise, faça uma solicitação PATCH ao método futureReservations.update da versão Beta. No URL da solicitação, inclua o parâmetro de consulta updateMask e defina-o como planningStatus:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}
```
Em alguns minutos, Google Cloud aprova sua solicitação e o Compute Engine cria uma reserva vazia com os recursos solicitados.

A seguir

Ver capacidade reservada

Reservar capacidade com sua equipe de contas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Limitações

Limitações para solicitações de reserva adiantada

Limitações das reservas criadas automaticamente

Antes de começar

Console

gcloud

REST

Funções exigidas

Permissões necessárias

Cota

Visão geral

Solicitar capacidade pela equipe da sua conta

Revisar e enviar um rascunho de solicitação de reserva

Console

gcloud

REST

A seguir

Reservar capacidade com sua equipe de contas