Criar uma reserva compartilhada

Console

Siga as etapas em Como visualizar políticas da organização usando a restrição Projetos de proprietário de reservas compartilhadas.

gcloud

Para ver quais projetos a restrição compute.sharedReservationsOwnerProjects permite criar e modificar reservas compartilhadas:

1. Faça o download da política da sua organização como um arquivo chamado policy.yaml, usando o comando gcloud resource-manager org-policies describe:

   gcloud resource-manager org-policies describe compute.sharedReservationsOwnerProjects --organization=ORGANIZATION_ID > policy.yaml
   

   Substitua ORGANIZATION_ID pelo ID da organização.

2. Use um editor de texto para abrir o arquivo policy.yaml e ver a restrição compute.sharedReservationsOwnerProjects. Os projetos que têm permissão para criar e modificar reservas compartilhadas estão listados em allowedValues:

   ...
   constraint: constraints/compute.sharedReservationsOwnerProjects
   listPolicy:
     allowedValues:
     - projects/PROJECT_NUMBER_1
     - projects/PROJECT_NUMBER_2
     - projects/PROJECT_NUMBER_3
   ...
   

   em que PROJECT_NUMBER_1, PROJECT_NUMBER_2 e PROJECT_NUMBER_3 são os números de projeto dos únicos projetos da organização que têm permissão para criar reservas compartilhadas.

3. Opcional: exclua o arquivo policy.yaml.

   • Se você estiver usando um terminal Linux ou macOS, use o seguinte comando:

     rm policy.yaml
     

   • Se você estiver usando um terminal do Windows, use o seguinte comando:

     del policy.yaml
     

Console

Siga as etapas em Como personalizar políticas para restrições de lista usando a restrição Projetos de proprietário de reservas compartilhadas.

gcloud

Para editar quais projetos a restrição compute.sharedReservationsOwnerProjects permite criar e modificar reservas compartilhadas, use um dos seguintes métodos:

• Para conceder permissão a um único projeto para criar e modificar reservas compartilhadas, use o comando gcloud resource-manager org-policies allow. Repita esse comando para cada projeto ao qual quer conceder essa permissão.

  gcloud resource-manager org-policies allow compute.sharedReservationsOwnerProjects projects/PROJECT_NUMBER \
      --organization=ORGANIZATION_ID
  

  Substitua:

  • PROJECT_NUMBER: o número do projeto (não o ID) de um projeto na organização que você quer permitir para criar e modificar reservas compartilhadas.
  • ORGANIZATION_ID: o ID da organização.

• Para conceder ou revogar as permissões de vários projetos para criar e modificar reservas compartilhadas, substitua a restrição da política da organização:

  1. Para fazer o download da política da sua organização como um arquivo chamado policy.yaml, use o comando gcloud resource-manager org-policies describe:

     gcloud resource-manager org-policies describe compute.sharedReservationsOwnerProjects --organization=ORGANIZATION_ID > policy.yaml
     

     Substitua ORGANIZATION_ID pelo ID da organização.

  2. Use um editor de texto para modificar o arquivo policy.yaml para que a restrição compute.sharedReservationsOwnerProjects liste todos os projetos que podem ter permissão para criar e modificar reservas compartilhadas em allowedValues.

     • Para cada projeto que receber permissão para criar e modificar reservas compartilhadas, adicione o projeto a uma nova linha em allowedValues.
     • Para cada projeto que tiver permissão revogada para criar e modificar reservas compartilhadas, exclua a linha desse projeto.

     Ao terminar, verifique se o arquivo policy.yaml fica parecido com o seguinte:

     ...
     constraint: constraints/compute.sharedReservationsOwnerProjects
     listPolicy:
       allowedValues:
       - projects/PROJECT_NUMBER_1
       - projects/PROJECT_NUMBER_2
       - projects/PROJECT_NUMBER_3
     ...
     

     em que PROJECT_NUMBER_1, PROJECT_NUMBER_2 e PROJECT_NUMBER_3 são os números (não os IDs) de todos os projetos em sua organização que você quer que crie e modifique reservas compartilhadas.

  3. Salve o arquivo policy.yaml e feche o editor.

  4. Para atualizar a política da organização com as alterações, use o comando gcloud resource-manager org-policies set-policy:

     gcloud resource-manager org-policies set-policy --organization=ORGANIZATION_ID policy.yaml
     

     Substitua ORGANIZATION_ID pelo ID da organização.

  5. Opcional: exclua o arquivo policy.yaml.

     • Se você estiver usando um terminal Linux ou macOS, use o seguinte comando:

       rm policy.yaml
       

     • Se você estiver usando um terminal do Windows, use o seguinte comando:

       del policy.yaml
       

Console

Para criar uma reserva compartilhada especificando um modelo de instância, faça o seguinte:

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

   Acessar "Reservas"

   A página Reservas é exibida.

2. Clique em add_box Criar reserva.

   A página Criar uma reserva será exibida.

3. No campo Nome, insira um nome para a reserva.

4. Escolha a Região e a Zona em que você quer reservar recursos.

5. Na seção Tipo de compartilhamento, faça o seguinte:

   1. Para especificar uma reserva compartilhada, clique em Compartilhada.

   2. Clique em add Adicionar projetos e selecione os projetos da organização com que você quer compartilhar a reserva.

6. Na seção Usar com instância de VM, selecione uma das seguintes opções:

   • Para permitir que instâncias de VM correspondentes usem essa reserva automaticamente, clique em Usar reserva automaticamente (padrão).

   • Para consumir os recursos desta reserva apenas ao criar VMs correspondentes que visam especificamente essa reserva por nome, selecione Selecionar reserva específica.

7. No campo Número de instâncias de VM, insira o número de VMs que você quer reservar.

8. Na seção Configuração da máquina, faça o seguinte:

   1. Para especificar as propriedades das VMs com base em um modelo de instância, selecione Usar modelo de instância.

   2. No campo Modelo de instância, selecione o modelo de instância de sua escolha. Se você selecionar um modelo de instância regional, só poderá reservar recursos dentro da região do modelo de instância.

9. Na seção Exclusão automática, é possível ativar a opção para permitir que o Compute Engine exclua automaticamente a reserva em uma data e hora específicas. A exclusão automática de reservas pode ser útil para evitar cobranças desnecessárias quando você para de consumir a reserva.

10. Para criar a reserva, clique em Criar.

    A criação da reserva compartilhada pode levar algum tempo. Essa ação redireciona você para a página Reservas.

gcloud

Para criar uma reserva compartilhada especificando um modelo de instância, use o comando gcloud compute reservations create.

Para criar uma reserva compartilhada especificando um modelo de instância sem flags opcionais, execute o seguinte comando:

gcloud compute reservations create RESERVATION_NAME \
    --project=PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Substitua:

• RESERVATION_NAME: o nome da reserva a ser criada.

• PROJECT_ID: o ID do projeto em que você quer reservar recursos e onde o modelo de instância existe.

• CONSUMER_PROJECT_IDS: uma lista separada por vírgulas de IDs de projetos que podem consumir essa reserva, por exemplo, project-1,project-2. É possível incluir até 100 projetos pessoais. Esses projetos precisam estar na mesma organização do projeto de proprietário. Não inclua o projeto proprietário. Por padrão, ele já é permitido para consumir a reserva.

• LOCATION: o local do modelo de instância. Especifique um dos seguintes valores:

  • Para um modelo de instância global: global

  • Para um modelo de instância regional: regions/REGION. Substitua REGION pela região em que o modelo de instância está. Se você especificar um modelo de instância regional, só será possível reservar VMs dentro da região do modelo de instância.

• INSTANCE_TEMPLATE_NAME: o nome de um modelo de instância. Se você especificar um modelo de instância, não será possível modificar nenhuma das propriedades ao criar a reserva. Caso contrário, você vai encontrar erros.

• NUMBER_OF_VMS: o número de VMs a serem reservadas.

• ZONE: a zona em que os recursos serão reservados.

Por exemplo, para criar uma reserva especificando um modelo de instância global na zona us-central1-a, compartilhe a reserva com os projetos project-1 e project-2 e reserve dez VMs que usam um tipo de máquina predefinido N2 com quatro vCPUs, execute o seguinte comando:

gcloud compute reservations create my-reservation \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/global/example-instance-template \
    --vm-count=10 \
    --zone=us-central1-a

Também é possível realizar uma ou mais das seguintes ações:

• Para especificar que apenas VMs que segmentam especificamente esta reserva podem consumi-la, inclua a flag --require-specific-reservation.

  gcloud compute reservations create example-reservation \
      --require-specific-reservation \
      ...
  

• Para permitir que o Compute Engine exclua automaticamente a reserva, selecione um dos seguintes métodos:

  • Para excluir a reserva em uma data e hora específicas, use o comando gcloud beta compute reservations create e inclua a flag --delete-at-time.

    gcloud beta compute reservations create reservation-example \
        --delete-at-time=DELETE_AT_TIME \
        ...
    

    Substitua DELETE_AT_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:

    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. Outra possibilidade é não usar ajuste: especifique Z.

  • Para excluir a reserva após uma duração específica, use o comando gcloud beta compute reservations create e inclua a flag --delete-after-duration.

    gcloud beta compute reservations create reservation-example \
        --delete-after-duration=DELETE_AFTER_DURATION \
        ...
    

    Substitua DELETE_AFTER_DURATION por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.

REST

Para criar uma reserva compartilhada especificando um modelo de instância, faça uma solicitação POST para o método reservations.insert.

Por exemplo, para criar uma reserva compartilhada especificando um modelo de instância sem campos opcionais e compartilhar a reserva com dois projetos de consumidor, faça a seguinte solicitação POST:

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

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  },
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
  }
}

Substitua:

• PROJECT_ID: o ID do projeto em que você quer reservar recursos e onde o modelo de instância existe.

• ZONE: a zona em que os recursos serão reservados.

• RESERVATION_NAME: o nome da reserva a ser criada.

• CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: os IDs do projeto que podem consumir essa reserva. É possível incluir até 100 projetos pessoais. Esses projetos precisam estar na mesma organização do projeto de proprietário. Não inclua o projeto proprietário. Por padrão, ele já pode consumir a reserva.

• NUMBER_OF_VMS: o número de VMs a serem reservadas.

• LOCATION: o local do modelo de instância. Especifique um dos seguintes valores:

  • Para um modelo de instância global: global

  • Para um modelo de instância regional: regions/REGION. Substitua REGION pela região em que o modelo de instância está. Se você especificar um modelo de instância regional, só será possível reservar VMs dentro da região do modelo de instância.

• INSTANCE_TEMPLATE_NAME: o nome de um modelo de instância. Se você especificar um modelo de instância, não será possível modificar nenhuma das propriedades ao criar a reserva. Caso contrário, você vai encontrar erros.

Por exemplo, para criar uma reserva para dez VMs na zona us-central1-a especificando um modelo de instância global e compartilhar a reserva com os projetos project-1 e project-2, faça a solicitação POST a seguir:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "project-1": {
        "projectId": "project-1"
      },
      "project-2": {
        "projectId": "project-2"
      }
    }
  },
  "specificReservation": {
    "count": "10",
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template"
  }
}

Também é possível realizar uma ou mais das seguintes ações:

• Para especificar que apenas VMs que segmentam especificamente esta reserva possam consumi-la, inclua o campo specificReservationRequired no corpo da solicitação e defina-o como true.

  POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations
  
  {
    "name": "example-reservation",
    "specificReservationRequired": true,
    ...
  }
  

• Para permitir que o Compute Engine exclua automaticamente a reserva, selecione um dos seguintes métodos:

  • Para excluir a reserva em uma data e hora específicas, faça uma solicitação POST para o método beta.reservations.insert. No corpo da solicitação, inclua o campo deleteAtTime.

    POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations
    
    {
      "name": "example-reservation",
      "deleteAtTime": "DELETE_AT_TIME",
      ...
    }
    

    Substitua DELETE_AT_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:

    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. Outra possibilidade é não usar ajuste: especifique Z.

  • Para excluir a reserva após uma duração específica, faça uma solicitação POST para o método beta.reservations.insert. No corpo da solicitação, inclua o campo deleteAfterDuration.

    POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations
    
    {
      "name": "example-reservation",
      "deleteAfterDuration": {
        "seconds": "DELETE_AFTER_DURATION"
      },
      ...
    }
    

    Substitua DELETE_AFTER_DURATION por uma duração em segundos. Por exemplo, especifique 86400 para 86.400 segundos (1 dia).

Console

Para criar uma reserva compartilhada, faça o seguinte:

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

   Acessar "Reservas"

   A página Reservas é exibida.

2. Clique em add_box Criar reserva.

   A página Criar uma reserva será exibida.

3. No campo Nome, insira um nome para a reserva.

4. Escolha a Região e a Zona em que você quer reservar recursos.

5. Na seção Tipo de compartilhamento, faça o seguinte:

   1. Para especificar uma reserva compartilhada, clique em Compartilhada.

   2. Clique em add Adicionar projetos e selecione os projetos da organização com que você quer compartilhar a reserva.

6. Na seção Usar com instância de VM, selecione uma das seguintes opções:

   • Permitir que VMs correspondentes consumam essa reserva automaticamente. Clique em Usar reserva automaticamente (padrão).

   • Para consumir os recursos desta reserva apenas ao criar VMs correspondentes que visam especificamente essa reserva por nome, selecione Selecionar reserva específica.

7. No campo Número de instâncias de VM, insira o número de VMs que você quer reservar.

8. Na seção Configuração da máquina, selecione Especificar tipo de máquina e especifique o seguinte:

   1. Nos campos Família de máquinas, Série e Tipo de máquina, selecione uma família, uma série e um tipo de máquina.

   2. Opcional: para especificar uma plataforma de CPU mínima e/ou GPUs, faça o seguinte:

      1. Para expandir a seção Plataforma de CPU e GPU, clique na seta de expansão expand_more.

      2. Opcional: para especificar uma plataforma mínima de CPU, selecione uma opção na lista Plataforma de CPU.

      3. Opcional: para adicionar GPUs, clique em add Adicionar GPU. Em seguida, nos campos Tipo de GPU e Número de GPUs, selecione o tipo e o número de GPUs para cada VM.

   3. Opcional: para adicionar SSDs locais, faça o seguinte:

      1. No campo Número de discos, selecione o número de SSDs locais para cada VM.

      2. No campo Tipo de interface, selecione a interface dos SSDs locais.

9. Na seção Exclusão automática, é possível ativar a opção para permitir que o Compute Engine exclua automaticamente a reserva em uma data e hora específicas. A exclusão automática de reservas pode ser útil para evitar cobranças desnecessárias quando você para de consumir a reserva.

10. Para criar a reserva, clique em Criar.

    A criação da reserva compartilhada pode levar algum tempo. Essa ação redireciona você para a página Reservas.

gcloud

Para criar uma reserva compartilhada, use o comando gcloud compute reservations create.

Para criar uma reserva compartilhada sem flags opcionais, execute o seguinte comando:

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --project=PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Substitua:

• RESERVATION_NAME: o nome da reserva a ser criada.

• MACHINE_TYPE: um tipo de máquina a ser usado em cada VM. Especifique um dos seguintes valores:

  • Para um tipo de máquina predefinido: MACHINE_FAMILY-standard-CPUS.

  • Para um tipo de máquina personalizado: MACHINE_FAMILY-custom-CPUS-MEMORY. Antes de especificar um tipo de máquina personalizado, analise as limitações para VMs com tipos de máquina personalizados.

  Substitua:

  • MACHINE_FAMILY: a família de máquinas.

  • CPUS: o número de vCPUs.

  • MEMORY: a memória total para uma instância reservada. A memória precisa ser um múltiplo de 256 MB e ser fornecida em MB.

  Por exemplo, para especificar um tipo de máquina personalizado N2 com 4 vCPUs e 5 GB de memória, que é de 5.120 MB, especifique n2-custom-4-5120.

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

• CONSUMER_PROJECT_IDS: uma lista separada por vírgulas de IDs de projetos que podem consumir essa reserva, por exemplo, project-1,project-2. É possível incluir até 100 projetos pessoais. Esses projetos precisam estar na mesma organização do projeto de proprietário. Não inclua o projeto proprietário. Por padrão, ele já é permitido para consumir a reserva.

• NUMBER_OF_VMS: o número de VMs a serem reservadas.

• ZONE: a zona em que os recursos serão reservados.

Por exemplo, para criar uma reserva para dez VMs na zona us-central1-a especificando um modelo de instância global e compartilhar a reserva com os projetos project-1 e project-2, execute o seguinte comando:

gcloud compute reservations create my-reservation \
    --machine-type=n2-standard-4 \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --vm-count=10 \
    --zone=us-central1-a

Também é possível realizar uma ou mais das seguintes ações:

• Para adicionar unidades de processamento gráfico (GPUs) a cada VM reservada, inclua a flag --accelerator.

  gcloud compute reservations create my-reservation \
      --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE
      ...
  

  Substitua:

  • NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.

  • ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas.

  Verifique se o tipo de máquina especificado na reserva é compatível com os tipos de GPUs especificados e se a GPU está disponível na zona em que você quer reservar recursos. Caso contrário, a criação da reserva falhará.

• Para adicionar um ou mais SSDs locais a cada VM reservada, inclua uma ou mais flags --local-ssd. É possível especificar até 24 SSDs locais. Cada SSD local tem 375 GB.

  Por exemplo, para especificar dois SSDs locais ao criar uma reserva, inclua duas flags --local-ssd.

  gcloud compute reservations create my-reservation \
      --local-ssd=size=375,interface=INTERFACE_1 \
      --local-ssd=size=375,interface=INTERFACE_2 \
      ...
  

  Substitua INTERFACE_1 e INTERFACE_2 pelo tipo de interface que você quer que cada SSD local use. Especifique um dos seguintes valores:

  • Para interfaces de disco NVME: nvme

  • Para interfaces de disco SCSI: scsi.

  Verifique se o tipo de máquina especificado para as VMs reservadas é compatível com as interfaces de disco escolhidas. Caso contrário, a criação da reserva falhará. Para mais informações, veja como escolher uma interface de disco.

• Para que as VMs reservadas usem uma plataforma mínima de CPU específica, em vez da plataforma de CPU padrão da zona, inclua a flag --min-cpu-platform.

  gcloud compute reservations create my-reservation \
      --min-cpu-platform="MIN_CPU_PLATFORM" \
      ...
  

  Substitua MIN_CPU_PLATFORM por uma plataforma de CPU mínima. Para garantir que uma plataforma de CPU esteja disponível na zona em que você está reservando recursos, confira as plataformas de CPU disponíveis por zona.

• Para especificar que apenas VMs que segmentam especificamente esta reserva podem consumi-la, inclua a flag --require-specific-reservation.

  gcloud compute reservations create example-reservation \
      --require-specific-reservation \
      ...
  

• Para permitir que o Compute Engine exclua automaticamente a reserva, selecione um dos seguintes métodos:

  • Para excluir a reserva em uma data e hora específicas, use o comando gcloud beta compute reservations create e inclua a flag --delete-at-time.

    gcloud beta compute reservations create reservation-example \
        --delete-at-time=DELETE_AT_TIME \
        ...
    

    Substitua DELETE_AT_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:

    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. Outra possibilidade é não usar ajuste: especifique Z.

  • Para excluir a reserva após uma duração específica, use o comando gcloud beta compute reservations create e inclua a flag --delete-after-duration.

    gcloud beta compute reservations create reservation-example \
        --delete-after-duration=DELETE_AFTER_DURATION \
        ...
    

    Substitua DELETE_AFTER_DURATION por uma duração em dias, horas, minutos ou segundos. Por exemplo, especifique 30m para 30 minutos ou 1d2h3m4s para 1 dia, 2 horas, 3 minutos e 4 segundos.

Terraform

Para criar uma reserva, use o recurso google_compute_reservation do Terraform. Para especificar uma reserva compartilhada, defina o bloco share_settings:

• Defina o campo share_type como SPECIFIC_PROJECTS
• No bloco project_map, especifique os IDs dos projetos com que você quer compartilhar essa reserva.

Para mais informações sobre como usar o Terraform, consulte Como usar o Terraform com o Google Cloud.

REST

Para criar uma reserva compartilhada, faça uma solicitação POST para o método reservations.insert.

Por exemplo, para criar uma reserva compartilhada sem campos opcionais e compartilhar a reserva com dois projetos de consumidor, faça a seguinte solicitação POST:

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

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  },
  "specificReservation": {
    "count": "NUMBER_OF_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  }
}

Substitua:

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

• ZONE: a zona em que os recursos serão reservados.

• RESERVATION_NAME: o nome da reserva a ser criada.

• CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: os IDs do projeto que podem consumir essa reserva. É possível incluir até 100 projetos pessoais. Esses projetos precisam estar na mesma organização do projeto de proprietário. Não inclua o projeto proprietário. Por padrão, ele já pode consumir a reserva.

• NUMBER_OF_VMS: o número de VMs a serem reservadas.

• MACHINE_TYPE: um tipo de máquina a ser usado em cada VM. Especifique um dos seguintes valores:

  • Para um tipo de máquina predefinido: MACHINE_FAMILY-standard-CPUS.

  • Para um tipo de máquina personalizado: MACHINE_FAMILY-custom-CPUS-MEMORY. Antes de especificar um tipo de máquina personalizado, analise as limitações para VMs com tipos de máquina personalizados.

  Substitua:

  • MACHINE_FAMILY: a família de máquinas.

  • CPUS: o número de vCPUs.

  • MEMORY: a memória total para uma instância reservada. A memória precisa ser um múltiplo de 256 MB e ser fornecida em MB.

  Por exemplo, para especificar um tipo de máquina personalizado N2 com 4 vCPUs e 5 GB de memória, que é de 5.120 MB, especifique n2-custom-4-5120.

Por exemplo, para criar uma reserva especificando um modelo de instância global na zona us-central1-a, compartilhe a reserva com os projetos project-1 e project-2 e reserve dez VMs que usam um tipo de máquina predefinido N2 com quatro vCPUs, faça a seguinte solicitação POST:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations

{
  "name": "my-reservation",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "project-1": {
        "projectId": "project-1"
      },
      "project-2": {
        "projectId": "project-2"
      }
    }
  },
  "specificReservation": {
    "count": "10",
    "instanceProperties": {
      "machineType": "n2-standard-4",
    }
  }
}

Também é possível realizar uma ou mais das seguintes ações:

• Para adicionar unidades de processamento gráfico (GPUs) a cada VM reservada, inclua o campo guestAccelerators no corpo da solicitação.

  POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations
  
  {
    "name": "example-reservation",
    "specificReservation": {
      "instanceProperties": {
        "guestAccelerators": [
          {
            "acceleratorCount": NUMBER_OF_ACCELERATORS,
            "acceleratorType": "ACCELERATOR_TYPE"
          }
        ],
        ...
      },
      ...
    }
  }
  

  Substitua:

  • NUMBER_OF_ACCELERATORS: o número de GPUs a serem adicionadas por VM reservada.

  • ACCELERATOR_TYPE: o tipo de GPU a ser adicionada às VMs reservadas.

  Verifique se o tipo de máquina especificado na reserva é compatível com os tipos de GPUs especificados e se a GPU está disponível na zona em que você quer reservar recursos. Caso contrário, a criação da reserva falhará.

• Para adicionar um ou mais SSDs locais a cada VM reservada, inclua o campo localSsds no corpo da solicitação. É possível especificar até 24 SSDs locais. Cada SSD local tem 375 GB.

  Por exemplo, para especificar dois SSDs locais ao criar uma reserva, especifique o seguinte:

  POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations
  
  {
    "name": "example-reservation",
    "specificReservation": {
      "instanceProperties": {
        "localSsds": [
          {
            "diskSizeGb": "375",
            "interface": "INTERFACE_1"
          },
          {
            "diskSizeGb": "375",
            "interface": "INTERFACE_2"
          }
        ],
        ...
      },
      ...
    }
  }
  

  Substitua INTERFACE_1 e INTERFACE_2 pelo tipo de interface que você quer que cada SSD local use. Especifique um dos seguintes valores:

  • Para interfaces de disco NVME: NVME

  • Para interfaces de disco SCSI: SCSI.

  Verifique se o tipo de máquina especificado para as VMs reservadas é compatível com as interfaces de disco escolhidas. Caso contrário, a criação da reserva falhará. Para mais informações, veja como escolher uma interface de disco.

• Para que as VMs reservadas usem uma plataforma mínima de CPU específica, em vez da plataforma de CPU padrão da zona, inclua o campo minCpuPlatform no corpo da solicitação.

  POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations
  
  {
    "name": "example-reservation",
    "specificReservation": {
      "instanceProperties": {
        "minCpuPlatform": "MIN_CPU_PLATFORM",
        ...
      },
      ...
    }
  }
  

  Substitua MIN_CPU_PLATFORM por uma plataforma de CPU mínima. Para garantir que uma plataforma de CPU esteja disponível na zona em que você está reservando recursos, confira as plataformas de CPU disponíveis por zona.

• Para especificar que apenas VMs que segmentam especificamente esta reserva possam consumi-la, inclua o campo specificReservationRequired no corpo da solicitação e defina-o como true.

  POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations
  
  {
    "name": "example-reservation",
    "specificReservationRequired": true,
    ...
  }
  

• Para permitir que o Compute Engine exclua automaticamente a reserva, selecione um dos seguintes métodos:

  • Para excluir a reserva em uma data e hora específicas, faça uma solicitação POST para o método beta.reservations.insert. No corpo da solicitação, inclua o campo deleteAtTime.

    POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations
    
    {
      "name": "example-reservation",
      "deleteAtTime": "DELETE_AT_TIME",
      ...
    }
    

    Substitua DELETE_AT_TIME por uma data e hora formatadas como um carimbo de data/hora RFC 3339, que precisa ser o seguinte:

    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. Outra possibilidade é não usar ajuste: especifique Z.

  • Para excluir a reserva após uma duração específica, faça uma solicitação POST para o método beta.reservations.insert. No corpo da solicitação, inclua o campo deleteAfterDuration.

    POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/reservations
    
    {
      "name": "example-reservation",
      "deleteAfterDuration": {
        "seconds": "DELETE_AFTER_DURATION"
      },
      ...
    }
    

    Substitua DELETE_AFTER_DURATION por uma duração em segundos. Por exemplo, especifique 86400 para 86.400 segundos (1 dia).