Combina reservas con descuentos por uso confirmado

Consola

Antes de comprar un compromiso mediante la Google Cloud consola, selecciona el proyecto que quieras usar para comprar el compromiso. Si la opción de compartir DUCs está habilitada en una cuenta de facturación de Cloud, puedes comprar la confirmación de uso con cualquier proyecto de esa cuenta. Después de seleccionar el proyecto, haz lo siguiente:

1. En la Google Cloud consola, ve a la página Descuentos por compromiso de uso.

   Ir a Descuentos por compromiso de uso

2. Para comprar un compromiso, haz clic en add_box Comprar compromiso. Se abrirá la página Compra un descuento por uso confirmado y se mostrará la pestaña Hardware.

3. En el campo Nombre, introduce un nombre para tu compromiso.

4. En el campo Región, selecciona la región en la que quieras comprometerte a usar recursos de Compute Engine.

5. En el campo Tipo de compromiso, selecciona la serie de familias de máquinas de los recursos comprometidos. Los siguientes tipos de compromiso ofrecen opciones para GPUs, discos SSD locales o ambos:

   • A2 optimizada para aceleradores para recursos de tipo de máquina A2
   • A3 optimizada para aceleradores para recursos de tipo de máquina A3 Edge y A3 High
   • A3 Mega optimizada para aceleradores para recursos de tipo de máquina A3 Mega
   • C2 optimizado para la computación para recursos de tipo de máquina C2
   • C2D optimizado para la computación para recursos de tipo de máquina C2D
   • C3 de uso general para recursos de tipo de máquina C3
   • Uso general C3D para recursos de tipo de máquina C3D
   • N1 de uso general para recursos de tipo de máquina N1
   • N2 de uso general para recursos de tipo de máquina N2
   • N2D de uso general para recursos de máquinas N2D
   • G2 optimizada para gráficos para recursos de tipo de máquina G2
   • M3 con memoria optimizada para recursos de tipo de máquina M3
   • Z3 con almacenamiento optimizado para recursos de tipo de máquina Z3

6. En Duración, haz lo siguiente:

   1. Para especificar el plan de tu compromiso, selecciona 1 año o 3 años. Este ajuste determina la duración predefinida de tu compromiso.

   2. Opcional. Para especificar una duración personalizada para tu compromiso, haz clic en el interruptor Ampliar fecha de finalización y, a continuación, en el campo Fecha, especifica una fecha de finalización personalizada. Para obtener más información, consulta el artículo Ampliar la duración de los compromisos.

7. En el campo Cores (Núcleos), introduce el número de vCPUs que quieras comprar.

8. En el campo Memoria, introduce la cantidad de memoria (en GB) que quieras comprar.

   Solo puedes especificar la memoria en incrementos de 0,25 GB. Para especificar un valor de memoria personalizado para tu compromiso, usa la CLI de gcloud o REST.

9. Para confirmar las GPUs, en la sección GPUs (GPUs), haga clic en add Add GPU (Añadir GPU) y, a continuación, siga estos pasos:

   1. En el campo Tipo de GPU, selecciona el tipo de GPU.
   2. En el campo Número de GPUs, introduce el número de GPUs.
   3. Opcional: Si tu modelo de GPU es compatible con estaciones de trabajo virtuales NVIDIA RTX para cargas de trabajo de gráficos y tienes previsto ejecutar cargas de trabajo que utilizan un gran número de gráficos, selecciona la casilla Habilitar estación de trabajo virtual (NVIDIA GRID).

10. Para confirmar el uso de discos SSD locales, en la sección SSD locales, haz clic en add Añadir SSD y, a continuación, en el campo Número de SSDs, especifica el número de discos.

11. Para asociar una o varias reservas a un compromiso, en el campo Reservas, seleccione Asociar reservas.

    La consola Google Cloud muestra una lista de todas las reservas de tu proyecto cuya región, tipo de máquina y tipo de GPU coincidan con el compromiso. A continuación, haz lo siguiente:

    1. Opcional. Para ver las reservas con propiedades específicas, en el menú Filtrar, añada o quite filtros de las propiedades que quiera.
    2. Selecciona todas las reservas que quieras asociar al compromiso.

12. Para terminar de comprar tu compromiso con las reservas asociadas, haz lo siguiente:

    1. Haz clic en Comprar.
    2. En el cuadro de diálogo Comprar un descuento por compromiso de uso, si estás de acuerdo con los términos específicos del servicio, haz clic de nuevo en Comprar.

gcloud

Para comprar un compromiso asociando reservas, ejecuta el comando gcloud compute commitments create. En tu comando, incluye la marca --existing-reservation para especificar una reserva que quieras asociar a tu compromiso. Incluya una instancia nueva de esta marca por cada reserva que quiera adjuntar. Puedes asociar cualquier número de reservas a tu compromiso.

Por ejemplo, para comprar un compromiso asociándole dos reservas, ejecuta el siguiente comando:

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --custom-end-time=CUSTOM_END_DATE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

Haz los cambios siguientes:

• COMMITMENT_NAME: el nombre del compromiso.
• REGION: la región en la que se encuentra el compromiso.
• PROJECT_ID: el ID del proyecto en el que quieres comprar el compromiso con las reservas asociadas.
• DURATION: la duración del compromiso, que puede ser 12-month o 36-month.
• CUSTOM_END_DATE: opcional. Una fecha de finalización personalizada para el plazo, que debe tener el formato YYYY-MM-DD. Por ejemplo, para especificar una fecha de finalización personalizada del 20 de abril del 2024, debe usar el formato 2024-04-20.

• COMMITMENT_TYPE: el tipo de compromiso. Los siguientes tipos de compromisos ofrecen opciones para GPUs, discos SSD locales o ambos:

  • accelerator-optimized para recursos de tipo de máquina A2
  • accelerator-optimized-a3 para los recursos de los tipos de máquinas A3 Edge y A3 High
  • accelerator-optimized-a3-mega para los recursos de tipo de máquina A3 Mega
  • compute-optimized para recursos de tipo de máquina C2
  • compute-optimized-c2d para recursos de tipo de máquina C2D
  • compute-optimized-c3 para recursos de tipo de máquina C3
  • compute-optimized-c3d para recursos de tipo de máquina C3D
  • general-purpose para recursos de tipo de máquina N1
  • general-purpose-n2 para recursos de tipo de máquina N2
  • general-purpose-n2d para recursos de máquinas N2D
  • graphics-optimized para recursos de tipo de máquina G2
  • memory-optimized-m3 para recursos de tipo de máquina M3
  • storage-optimized-z3 para recursos de tipo de máquina Z3

• COMMITTED_VCPUS: el número de vCPUs que quieres incluir en tu compromiso. El número debe ser un entero positivo.

• COMMITTED_MEMORY: la cantidad de memoria que quieres incluir en tu compromiso, en MB o GB. Por ejemplo, 10240MB o 10GB. Si no especificas ninguna unidad, Compute Engine usará GB.

• COMMITTED_LOCAL_SSD: la cantidad, en GB, de espacio de SSD local que quieres incluir en tu compromiso. Cada disco SSD local tiene 375 GB.

• COMMITTED_ACCELERATOR_COUNT: el número de GPUs que quieres incluir en tu compromiso.

• COMMITTED_ACCELERATOR_TYPE: el tipo de GPU que quieres incluir en tu compromiso.

• RESERVATION_NAME_1 y RESERVATION_NAME_2: los nombres de las reservas que quieras adjuntar al compromiso.

• RESERVATION_ZONE_1 y RESERVATION_ZONE_2: las zonas de las reservas que quieras asociar al compromiso.

Ejemplo: comprar una confirmación asociando reservas

Supongamos que tienes dos reservas, res-01 y res-02, en las zonas us-central1-a y us-central1-b del proyecto myproject. Supongamos que estas reservas tienen una capacidad combinada de 4 GPUs NVIDIA P100 y 4 discos SSD locales. Para comprar un nuevo compromiso en la región us-central1 de este proyecto para estas GPUs y discos SSD locales, y usar estas reservas como reservas adjuntas, ejecuta el siguiente comando. Ten en cuenta que el compromiso de ejemplo también contiene vCPUs y memoria.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-p100,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b
    

REST

Para comprar un compromiso asociando reservas, haz una solicitud POST al método regionCommitments.insert. En su solicitud, incluya el campo existingReservations para especificar una lista separada por comas de todas las reservas que quiera asociar a su compromiso. Puedes asociar a tu compromiso tantas reservas como quieras.

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

{
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "existingReservations": "RESERVATION_URLs"
}

Haz los cambios siguientes:

• COMMITMENT_NAME: el nombre del compromiso.
• REGION: la región en la que se encuentra el compromiso.
• PROJECT_ID: el ID del proyecto en el que quieres comprar el compromiso con las reservas asociadas.
• DURATION: la duración del compromiso, TWELVE_MONTH o THIRTY_SIX_MONTH.

• COMMITMENT_TYPE: el tipo de compromiso. Los siguientes tipos de compromisos ofrecen opciones para GPUs, discos SSD locales o ambos:

  • ACCELERATOR_OPTIMIZED para recursos de tipo de máquina A2
  • ACCELERATOR_OPTIMIZED_A3 para los recursos de los tipos de máquinas A3 Edge y A3 High
  • ACCELERATOR_OPTIMIZED_A3_MEGA para los recursos de tipo de máquina A3 Mega
  • COMPUTE_OPTIMIZED para recursos de tipo de máquina C2
  • COMPUTE_OPTIMIZED_C2D para recursos de tipo de máquina C2D
  • COMPUTE_OPTIMIZED_C3 para recursos de tipo de máquina C3
  • COMPUTE_OPTIMIZED_C3D para recursos de tipo de máquina C3D
  • GENERAL_PURPOSE para recursos de tipo de máquina N1
  • GENERAL_PURPOSE_N2 para recursos de tipo de máquina N2
  • GENERAL_PURPOSE_N2D para recursos de máquinas N2D
  • GRAPHICS_OPTIMIZED para recursos de tipo de máquina G2
  • MEMORY_OPTIMIZED_M3 para recursos de tipo de máquina M3
  • STORAGE_OPTIMIZED_Z3 para recursos de tipo de máquina Z3

• COMMITTED_VCPUS: el número de vCPUs que quieres incluir en tu compromiso. El número debe ser un entero positivo.

• COMMITTED_MEMORY: la cantidad de memoria, en MB, que quieres incluir en tu compromiso. Por ejemplo, 10240MB.

• COMMITTED_LOCAL_SSD: la cantidad, en GB, de almacenamiento SSD local que quieres incluir en tu compromiso. Cada disco SSD local tiene 375 GB.

• COMMITTED_ACCELERATOR_COUNT: el número de GPUs que quieres incluir en tu compromiso.

• COMMITTED_ACCELERATOR_TYPE: el tipo de GPU que quieres incluir en tu compromiso.

• CUSTOM_END_DATE: opcional. Una fecha de finalización personalizada para tu periodo, que debe tener el formato YYYY-MM-DD. Por ejemplo, para especificar una fecha de finalización personalizada del 20 de abril del 2024, debe usar el formato 2024-04-20.

• END_TIME: 00:00 (hora del Pacífico de EE. UU. y Canadá, UTC-8 o UTC-7), como diferencia con el tiempo universal coordinado (UTC). Especifique este valor solo si ha indicado una fecha de finalización personalizada para su compromiso. Se debe utilizar uno de los valores indicados a continuación.

  • Durante el horario de verano: 07:00:00
  • En otros momentos: 08:00:00

• RESERVATION_URLs: lista separada por comas de las URLs de las reservas que quieras asociar al compromiso. Por ejemplo, para adjuntar dos reservas, res-1 y res-2, especifica lo siguiente:

  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"
  

Ejemplo: comprar una confirmación asociando reservas

Supongamos que tienes dos reservas, res-01 y res-02, en las zonas us-central1-a y us-central1-b del proyecto myproject. Supongamos que estas reservas tienen una capacidad combinada de 4 GPUs NVIDIA P100 y 4 discos SSD locales. Para comprar un nuevo compromiso en la región us-central1 de este proyecto para estas GPUs y discos SSD locales, y para usar estas reservas como reservas adjuntas, haz la siguiente solicitud POST. Ten en cuenta que el compromiso de ejemplo también contiene vCPUs y memoria.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p100",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1536000",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-b/reservations/res-02"
  ]
}

Consola

Antes de comprar un compromiso mediante la Google Cloud consola, selecciona el proyecto que quieras usar para comprar el compromiso. Si la opción de compartir DUCs está habilitada en una cuenta de facturación de Cloud, puedes comprar la confirmación de uso con cualquier proyecto de esa cuenta. Después de seleccionar el proyecto, haz lo siguiente:

1. En la Google Cloud consola, ve a la página Descuentos por compromiso de uso.

   Ir a Descuentos por compromiso de uso

2. Para comprar un compromiso, haz clic en add_box Comprar compromiso. Se abrirá la página Compra un descuento por uso confirmado y se mostrará la pestaña Hardware.

3. En el campo Nombre, introduce un nombre para tu compromiso.

4. En el campo Región, selecciona la región en la que quieras comprometerte a usar recursos de Compute Engine.

5. En el campo Tipo de compromiso, selecciona la serie de familias de máquinas de los recursos comprometidos. Los siguientes tipos de compromiso ofrecen opciones para GPUs, discos SSD locales o ambos:

   • A2 optimizada para aceleradores para recursos de tipo de máquina A2
   • A3 optimizada para aceleradores para recursos de tipo de máquina A3 Edge y A3 High
   • A3 Mega optimizada para aceleradores para recursos de tipo de máquina A3 Mega
   • C2 optimizado para la computación para recursos de tipo de máquina C2
   • C2D optimizado para la computación para recursos de tipo de máquina C2D
   • C3 de uso general para recursos de tipo de máquina C3
   • Uso general C3D para recursos de tipo de máquina C3D
   • N1 de uso general para recursos de tipo de máquina N1
   • N2 de uso general para recursos de tipo de máquina N2
   • N2D de uso general para recursos de máquinas N2D
   • G2 optimizada para gráficos para recursos de tipo de máquina G2
   • M3 con memoria optimizada para recursos de tipo de máquina M3
   • Z3 con almacenamiento optimizado para recursos de tipo de máquina Z3

6. En Duración, elige 1 año o 3 años como plazo de tu compromiso.

7. En el campo Cores (Núcleos), introduce el número de vCPUs que quieras asignar.

8. En el campo Memoria, introduce la cantidad de memoria que quieras asignar en GB.

9. Para confirmar las GPUs, en la sección GPUs (GPUs), haga clic en add Add GPU (Añadir GPU) y, a continuación, siga estos pasos:

   1. En el campo Tipo de GPU, selecciona el tipo de GPU.
   2. En el campo Número de GPUs, introduce el número de GPUs.
   3. Opcional: Si tu modelo de GPU es compatible con estaciones de trabajo virtuales NVIDIA RTX para cargas de trabajo de gráficos y tienes previsto ejecutar cargas de trabajo que utilizan un gran número de gráficos, selecciona la casilla Habilitar estación de trabajo virtual (NVIDIA GRID).

10. Para confirmar el uso de discos SSD locales, en la sección SSD locales, haz clic en add Añadir SSD y, a continuación, en el campo Número de SSDs, especifica el número de discos.

11. Para crear una reserva y adjuntarla al compromiso, en el campo Reservas, selecciona Crear reservas y, a continuación, haz lo siguiente. Repite este paso con cada reserva que quieras crear y adjuntar.

    1. Haz clic en Añadir reserva. Aparecerá la sección Nueva reserva.
    2. En el campo Nombre, introduce un nombre para la reserva adjunta.
    3. En el campo Región, selecciona la misma región que tu compromiso.
    4. En el campo Zona, selecciona la zona en la que quieras reservar tus recursos.

    5. En la sección Tipo de uso compartido, especifique cómo quiere compartir esta reserva de una de las siguientes formas:

       • Para crear una reserva de un solo proyecto, selecciona Local.
       • Para crear una reserva que se comparta con varios proyectos, selecciona Compartido. A continuación, para especificar los proyectos con los que quieres compartir esta reserva, haz clic en add Añadir proyectos y, a continuación, selecciona los proyectos que quieras de la organización del proyecto actual.

    6. En el campo Uso con instancia de VM, selecciona cómo quieres que las VMs consuman tu reserva de una de las siguientes formas:

       • Para permitir que las VMs con propiedades coincidentes consuman automáticamente esta reserva, haga clic en Usar reserva automáticamente (opción predeterminada).
       • Para consumir los recursos de esta reserva solo al crear VMs con propiedades coincidentes que se dirijan específicamente a esta reserva por nombre, haz clic en Seleccionar reserva específica.

    7. En la sección Detalles del recurso, haga lo siguiente:

       1. En el campo Número de instancias de máquina virtual, introduce el número de instancias de máquina virtual que quieras reservar.

       2. En la sección Configuración de la máquina, especifica las propiedades de tus VMs reservadas de una de las siguientes formas:

          1. Para especificar las propiedades de tus VMs mediante una plantilla de instancia, selecciona Usar plantilla de instancia.

             En el campo Plantilla de instancia, selecciona una plantilla de instancia que especifique la misma serie de familias de máquinas que tu compromiso. Si seleccionas una plantilla de instancia regional, la región de esa plantilla también debe coincidir con la región especificada en tu compromiso.

          2. Para especificar manualmente las propiedades de tus VMs, selecciona Seleccionar tipo de máquina y, a continuación, haz lo siguiente:

             1. Selecciona la familia de máquinas que se aplique a la serie de máquinas que hayas especificado en el compromiso:

                • Uso general para series de máquinas de uso general
                • Optimizadas para la computación para series de máquinas optimizadas para la computación
                • Con memoria optimizada para series de máquinas con memoria optimizada
                • GPUs para series de máquinas optimizadas para aceleradores

             2. En la tabla que tiene la columna Serie, selecciona la misma serie de máquinas que especificaste para el compromiso.

             3. En el campo Tipo de máquina, especifica un tipo de máquina predefinido o personalizado de una de las siguientes formas:

                1. Para elegir un tipo de máquina predefinido, selecciona Predefinido y, a continuación, el tipo de máquina que quieras.
                2. Para elegir un tipo de máquina personalizado, selecciona Personalizado y, a continuación, especifica los núcleos y la memoria que quieras.

             4. Para especificar una plataforma de CPU mínima, GPUs o ambas, despliega el menú expand_more Plataforma de CPU y GPU y haz lo siguiente:

                1. Opcional: Para especificar una plataforma de CPU mínima, selecciona una opción en la lista Plataforma de CPU.

                2. Opcional: Para reservar GPUs, haz clic en add Añadir GPU. A continuación, en los campos Tipo de GPU y Número de GPUs, selecciona el tipo y el número de GPUs de cada VM.

             5. Para reservar discos SSD locales, sigue estos pasos:

                1. En el campo Número de discos, selecciona el número de discos SSD locales que quieras para cada VM.
                2. En el campo Tipo de interfaz, selecciona la interfaz de los discos SSD locales.

    8. Para terminar de especificar las propiedades de esta reserva, haga clic en Hecho.

12. Para terminar de comprar tu compromiso con las reservas asociadas, haz lo siguiente:

    1. Haz clic en Comprar.
    2. En el cuadro de diálogo Comprar un descuento por compromiso de uso, si estás de acuerdo con los términos específicos del servicio, haz clic de nuevo en Comprar.

gcloud

Para crear tus reservas asociadas al comprar tu compromiso, ejecuta el comando gcloud compute commitments create.

En función de si quieres adjuntar una o varias reservas, ejecuta el comando de una de las siguientes formas:

• Para crear y adjuntar una sola reserva a tu compromiso, define las propiedades de la reserva adjunta ejecutando el siguiente comando:

  gcloud compute commitments create COMMITMENT_NAME \
      --region=REGION \
      --project=PROJECT_ID \
      --plan DURATION \
      --type COMMITMENT_TYPE
      --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
      --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
      --custom-end-time=CUSTOM_END_DATE \
      --reservation=RESERVATION_NAME \
      --reservation-zone=RESERVATION_ZONE \
      --machine-type=RESERVED_MACHINE_TYPE \
      --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
      --vm-count=NUMBER_OF_RESERVED_VMs \
      --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
      --local-ssd=interface=INTERFACE_1,size=375 \
      --local-ssd=interface=INTERFACE_2,size=375 \
      --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
      --share-setting=SHARE_SETTING \
      --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2
  

• Para crear y adjuntar varias reservas a tu compromiso, define las propiedades de la reserva mediante un archivo YAML y, a continuación, especifica ese archivo YAML en el comando que uses para comprar tu compromiso. También puedes usar este método de archivo YAML para crear y asociar una sola reserva a tu compromiso. Para crear reservas asociadas con este método, siga estos pasos:

  1. Crea el archivo YAML en el directorio actual y especifica la configuración que quieras para cada reserva adjunta. Por ejemplo, para especificar la configuración de una reserva compartida con dos proyectos que especifique GPUs, dos discos SSD locales y una plataforma de CPU mínima, incluye el siguiente texto en tu archivo YAML:

     - reservation: RESERVATION_NAME
       reservation_zone: RESERVATION_ZONE
       require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
       vm_count: NUMBER_OF_RESERVED_VMs
       machine_type: RESERVED_MACHINE_TYPE
       accelerator:
       - count: RESERVED_ACCELERATOR_COUNT
         type: RESERVED_ACCELERATOR_TYPE
       localssd:
       - interface: INTERFACE_1
         size: 375
       - interface: INTERFACE_2
         size: 375
       project: OWNER_PROJECT_ID
       minimum-cpu-platform: MINIMUM_CPU_PLATFORM
       share-setting: SHARE_SETTING
       share-with:
       - CONSUMER_PROJECT_ID_1
       - CONSUMER_PROJECT_ID_2
     
     

     Para especificar la configuración de varias reservas, repite estas propiedades para cada reserva que quieras crear. Puedes adjuntar a tu compromiso tantas reservas como quieras.

  2. Ejecuta el comando gcloud compute commitments create e incluye la marca --reservation-from-file.

     gcloud compute commitments create COMMITMENT_NAME \
         --region REGION \
         --project PROJECT_ID \
         --plan DURATION \
         --type COMMITMENT_TYPE \
         --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
         --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
         --reservations-from-file=YAML_FILE
     

Sustituye lo siguiente por las propiedades correspondientes del compromiso y las reservas asociadas:

Compute Engine crea el compromiso y las reservas asociadas solo si hay suficientes recursos del tipo de máquina especificado en la zona de destino y cuota suficiente en el momento de tu solicitud. Si la compra se ha realizado correctamente, verás un mensaje similar al siguiente:

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

Ejemplos de compra de compromisos creando reservas nuevas para adjuntar

En los siguientes ejemplos de situaciones y comandos se muestra cómo puedes comprar un compromiso de uso de GPUs, discos SSD locales o ambos creando nuevas reservas para adjuntar a ese compromiso.

Ejemplo 1: Comprar un compromiso para GPUs adjuntando una sola reserva nueva

Supongamos que quieres comprar un compromiso commitment-01 en la región us-central1 que incluya 4 GPUs NVIDIA V100. Quieres crear una reservation-01reserva nueva como reserva adjunta para esas GPUs. Supongamos que también quieres especificar que Compute Engine use esas GPUs reservadas en dos máquinas virtuales n1-standard-32 de la zona us-central1-a. Para comprar este compromiso de ejemplo con su reserva asociada, ejecuta el siguiente comando:

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

Ejemplo 2: Comprar un compromiso para GPUs sin comprometerse a usar vCPUs ni memoria

Para confirmar y reservar GPUs y discos SSD locales sin confirmar vCPUs ni memoria, especifica 0 como valor de las cantidades de vCPU y memoria. Por ejemplo, supongamos que quieres comprar un compromiso commitment-02 para una sola GPU NVIDIA P4 en la región us-west2. También quieres crear una reserva como reserva adjunta y especificar que Compute Engine use la GPU reservada en una máquina virtual n1-standard-2 de la zona us-west2-b. Para comprar este compromiso de ejemplo con su reserva adjunta, ejecuta el siguiente comando:

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

Ejemplo 3: Comprar una confirmación de GPUs y discos SSD locales adjuntando varias reservas nuevas

Supongamos que quieres comprar una confirmación commitment-03 para 1 GPU NVIDIA V100 y 2 discos SSD locales en la región us-central1. También quieres crear y adjuntar dos reservas en la zona us-central1-a. En la primera reserva, res-01, quieres reservar 1 VM n1-standard-2 con 1 GPU. Quieres que res-01 sea una reserva orientada, lo que significa que debes orientar específicamente esa reserva por nombre para usar sus VMs reservadas. En la segunda reserva, res-02, quieres reservar 1 VM n1-standard-8 con 2 tipos de discos SSD locales conectados.

Para comprar este compromiso de ejemplo con las reservas asociadas, primero crea el archivo YAML con las propiedades de ambas reservas.

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

Una vez que hayas creado el archivo YAML, ejecuta el siguiente comando para terminar de comprar el compromiso con las reservas asociadas. Ten en cuenta que el compromiso de ejemplo también contiene recursos de vCPU y de memoria.

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

Para crear las reservas asociadas al comprar tu contrato, haz una solicitud POST al método regionCommitments.insert. En tu solicitud, incluye el campo reservations para definir una lista de todas las reservas nuevas que quieras crear y adjuntar. Puedes adjuntar a tu compromiso tantas reservas como quieras.

• Para crear una reserva especificando manualmente todas las propiedades de la máquina virtual, incluya el campo instanceProperties y excluya el campo sourceInstanceTemplate.

  Por ejemplo, para especificar manualmente la configuración de una reserva compartida con dos proyectos que especifica GPUs, dos discos SSD locales y una plataforma de CPU mínima, haz la siguiente solicitud:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
              "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_2"
            }
          ],
          "machineType": "RESERVED_MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        }
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

• Para crear una reserva especificando una plantilla de instancia, incluye el campo sourceInstanceTemplate y excluye el campo instanceProperties.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

Sustituye lo siguiente por las propiedades correspondientes del compromiso y las reservas asociadas:

Compute Engine crea el compromiso y las reservas asociadas solo si hay suficientes recursos del tipo de máquina especificado en la zona de destino y cuota suficiente en el momento de tu solicitud. Si la compra se ha realizado correctamente, Compute Engine devuelve el estado 200 para tu solicitud de la API REST.

Ejemplos de compra de compromisos creando reservas nuevas para adjuntar

En los siguientes ejemplos de situaciones y comandos se muestra cómo puedes comprar un compromiso de uso de GPUs, discos SSD locales o ambos creando nuevas reservas para adjuntar a ese compromiso.

Ejemplo 1: Comprar un compromiso para GPUs adjuntando una sola reserva nueva

Supongamos que quieres comprar un compromiso commitment-01 en la región us-central1 que incluya 4 GPUs NVIDIA V100. Quieres crear una reserva reservation-01 como reserva adjunta para esas GPUs. Supongamos que también quieres especificar que Compute Engine use esas GPUs reservadas en dos n1-standard-8 VMs de la zona us-central1-a. Para comprar este compromiso de ejemplo con su reserva asociada, haz la siguiente solicitud POST:

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

Ejemplo 2: Comprar un compromiso para GPUs sin comprometerse a usar vCPUs ni memoria

Para confirmar y reservar GPUs y discos SSD locales sin confirmar vCPUs ni memoria, especifica 0 como valor de las cantidades de vCPU y memoria. Por ejemplo, supongamos que quieres comprar un compromiso commitment-02 para una sola GPU NVIDIA P4 en la región us-west2. También quieres crear una reserva como reserva adjunta y especificar que Compute Engine use la GPU reservada en una máquina virtual n1-standard-2 de la zona us-west2-b. Para comprar esta confirmación de ejemplo con su reserva asociada, haz la siguiente solicitud POST:

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

Ejemplo 3: Comprar una confirmación de GPUs y discos SSD locales adjuntando varias reservas nuevas

Supongamos que quieres comprar una confirmación commitment-03 para 1 GPU NVIDIA V100 y 2 discos SSD locales en la región us-central1. También quieres crear y adjuntar dos reservas en la zona us-central1-a. En la primera reserva, res-01, quieres reservar 1 VM n1-standard-2 con 1 GPU. Quieres que res-01 sea una reserva orientada, lo que significa que debes orientar específicamente esa reserva por nombre para usar sus VMs reservadas. En la segunda reserva, res-02, quieres reservar 1 VM n1-standard-8 con 2 tipos de discos SSD locales conectados. Para comprar este compromiso de ejemplo con las reservas asociadas, envía la siguiente solicitud POST. Ten en cuenta que el compromiso de ejemplo también contiene recursos de vCPU y memoria.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "768000",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

gcloud

Para sustituir las reservas asociadas a compromisos, sigue estos pasos:

1. Crea un archivo YAML en el directorio actual con las configuraciones de las siguientes reservas adjuntas:

   • La reserva actual que quieras sustituir.

     Para consultar los detalles de esta reserva, consulta Ver los detalles de una reserva.

   • La nueva reserva de sustitución.

   El contenido del archivo YAML es similar al siguiente:

   - reservation: CURRENT_RESERVATION_NAME
     reservation_zone: CURRENT_RESERVATION_ZONE
     vm_count: 0
     machine_type: CURRENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
       type: CURRENT_RESERVATION_ACCELERATOR_TYPE
     local_ssd:
     - interface: CURRENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: CURRENT_RESERVATION_INTERFACE_2
       size: 375
     project: CURRENT_RESERVATION_PROJECT_ID
     share_setting: CURRENT_RESERVATION_SHARE_SETTING
     share_with:
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
   - reservation: REPLACEMENT_RESERVATION_NAME
     reservation_zone: REPLACEMENT_RESERVATION_ZONE
     vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
     machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
       type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
     local_ssd:
     - interface: REPLACEMENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: REPLACEMENT_RESERVATION_INTERFACE_2
       size: 375
     project: REPLACEMENT_RESERVATION_PROJECT_ID
     share_setting: REPLACEMENT_RESERVATION_SHARE_SETTING
     share_with:
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
   
   

   Sustituye lo siguiente por las propiedades correspondientes de las reservas actual y de sustitución:

   Reserva actual

   En la reserva actual, todas las propiedades siguientes deben ser exactamente las mismas que cuando la consultaste. Omita los campos de las propiedades que no tenga la reserva actual.

   • CURRENT_RESERVATION_NAME: el nombre de la reserva adjunta actual.
   • CURRENT_RESERVATION_ZONE: la zona de la reserva adjunta actual.
   • CURRENT_RESERVATION_MACHINE_TYPE: el tipo de máquina de la reserva adjunta actual.
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: el número de GPUs reservadas en la reserva adjunta actual.
   • CURRENT_RESERVATION_ACCELERATOR_TYPE: el tipo de acelerador reservado en la reserva adjunta actual.
   • CURRENT_RESERVATION_INTERFACE_1 y CURRENT_RESERVATION_INTERFACE_2: el tipo de interfaz que usa el disco SSD local de cada VM reservada en la reserva vinculada actual. Las opciones válidas son scsi y nvme. Cada disco SSD local tiene 375 GB. Repite el parámetro local_ssd para todos los discos SSD locales reservados.
   • CURRENT_RESERVATION_PROJECT_ID: el ID del proyecto actual que tiene el compromiso y la reserva adjunta. Especifica este campo si tu reserva adjunta actual se comparte entre varios proyectos de consumidor.
   • CURRENT_RESERVATION_SHARE_SETTING: El tipo de uso compartido de la reserva actual. Especifica este campo con el valor projects si la reserva adjunta actual se comparte entre varios proyectos de consumidor.
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 y CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: los IDs de proyecto de los proyectos con los que compartes la reserva adjunta actual. Por ejemplo, project-1 y project-2.

   Reserva de sustitución

   En la reserva de sustitución, defina las siguientes propiedades como obligatorias. Asegúrese de que cumple todos los requisitos cuando especifique estas propiedades. Omite los campos adicionales que no quieras usar.

   • REPLACEMENT_RESERVATION_NAME: el nombre de la nueva reserva de sustitución.
   • REPLACEMENT_RESERVATION_ZONE: la zona de la nueva reserva de sustitución.
   • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: el número de máquinas virtuales que quieres reservar en la nueva reserva de sustitución.

   • REPLACEMENT_RESERVATION_MACHINE_TYPE: el tipo de máquina que quieras para las VMs de tu nueva reserva de sustitución.

     • En el caso de los tipos de máquinas predefinidos, usa el formato MACHINE_FAMILY-standard-CPUS; por ejemplo, n2-standard-4.
     • En el caso de los tipos de máquina personalizados, usa el formato MACHINE_FAMILY-custom-CPUS-MEMORY; por ejemplo, n2-custom-4-5120. Para ver una lista completa de las restricciones, consulte las especificaciones de los tipos de máquinas personalizadas.

     Haz los cambios siguientes:

     • MACHINE_FAMILY: la familia de tipos de máquinas. Por ejemplo, especifica n2 para las VMs N2.
     • CPUS: el número de vCPUs.
     • MEMORY: la memoria total de una máquina virtual reservada. La memoria debe ser un múltiplo de 256 MB y debe proporcionarse en MB. Por ejemplo, para crear una máquina virtual N2 con 4 vCPUs y 5 GB de memoria (5120 MB), usa n2-custom-4-5120.

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: el número de GPUs que quieres añadir por VM en la reserva de sustitución.

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: el tipo de acelerador que quieras añadir en la reserva de sustitución.

   • REPLACEMENT_RESERVATION_INTERFACE_1 y REPLACEMENT_RESERVATION_INTERFACE_2: el tipo de interfaz que quieres que usen los discos SSD locales de cada VM reservada. Las opciones válidas son scsi y nvme. Cada disco SSD local tiene 375 GB. Repite el parámetro local_ssd por cada disco SSD local que quieras añadir. Puedes especificar hasta 24 discos SSD locales.

   • REPLACEMENT_RESERVATION_PROJECT_ID: el ID del proyecto actual que tiene el compromiso y la reserva adjunta. Especifica este campo si quieres compartir tu reserva de sustitución entre varios proyectos de consumidor.

   • REPLACEMENT_RESERVATION_SHARE_SETTING: el tipo de uso compartido de la reserva de sustitución. Especifica este campo con el valor projects si quieres compartir tu reserva de sustitución en varios proyectos de consumidor.

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 y REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: los IDs de los proyectos que pueden compartir esta reserva, por ejemplo project-1,project-2. Puedes incluir hasta 100 proyectos de consumidor. Estos proyectos deben pertenecer a la misma organización que el proyecto propietario. No incluyas REPLACEMENT_RESERVATION_PROJECT_ID, ya que tiene permiso para consumir esta reserva de forma predeterminada.

2. Ejecuta el comando gcloud beta compute commitments update-reservations y especifica la ruta al archivo YAML con la marca --reservations-from-file.

   gcloud beta compute commitments update-reservations COMMITMENT_NAME \
       --project= PROJECT_ID \
       --region= REGION \
       --reservations-from-file= YAML_FILE
   

   Haz los cambios siguientes:

   • COMMITMENT_NAME: el nombre del compromiso con la reserva asociada.
   • PROJECT_ID: el ID de proyecto del compromiso con la reserva adjunta.
   • REGION: la región en la que se encuentra el compromiso.
   • YAML_FILE: ruta al archivo YAML que contiene la configuración de las reservas actuales y de sustitución.

Ejemplo de sustitución de una reserva asociada a un compromiso

Para demostrarlo, en esta sección se muestra un ejemplo de compromiso con una reserva adjunta y cómo sustituir la reserva adjunta de ejemplo.

Ejemplo de compromiso con una reserva asociada

Por ejemplo, supongamos que quieres actualizar las reservas asociadas a la confirmación my-commitment-with-reservations, que se compró con el siguiente comando:

  gcloud beta compute commitments create my-commitment-with-reservations \
      --region=asia-east1 \
      --resources=vcpu=16,memory=60GB,local-ssd=3000 \
      --resources-accelerator=type=nvidia-tesla-p100,count=4 \
      --plan=12-month \
      --type=general-purpose \
      --reservations-from-file=one-reservation.yaml

En este ejemplo, supongamos que, cuando se ejecutó este comando, one-reservation.yaml era un archivo del directorio actual con el siguiente contenido, que define una reserva adjunta llamada res-1.

  - reservation: res-1
    reservation_zone: asia-east1-a
    vm_count: 4
    machine_type: n1-standard-4
    accelerator:
    - count: 1
      type: nvidia-tesla-p100
    local_ssd:
    - interface: scsi
      size: 375
    - interface: scsi
      size: 375

Este my-commitment-with-reservations compromiso y la reserva res-1 adjunta han dado lugar a los siguientes recursos comprometidos y reservados:

^* En concreto, la reserva adjunta de ejemplo, res-1, reserva 4 n1-standard-4 VMs, cada una con 1 GPU P100 y 2 discos SSD locales de tipo de interfaz scsi. El n1-standard-4 tipo de máquina usa 4 vCPUs y 15 GB por cada VM.

Sustituir la reserva de ejemplo adjunta

Supongamos que quieres sustituir la reserva adjunta res-1 por una nueva reserva adjunta res-2 y cambiar los recursos reservados por los siguientes:

^* En concreto, la reserva adjunta de ejemplo, res-1, reserva 4 n1-standard-4 VMs, cada una con 1 GPU P100 y 2 discos SSD locales de tipo de interfaz scsi. El n1-standard-4 tipo de máquina usa 4 vCPUs y 15 GB por cada VM.

^† En concreto, la reserva vinculada de sustitución define res-2, que reserva 2 VMs n1-standard-8, cada una con 1 GPU P100 y 4 discos SSD locales de tipo de interfaz scsi. Además, res-2 se ha compartido con otros dos proyectos, project-1 y project-2, y es propiedad del proyecto actual, my-project. El tipo de máquina n1-standard-8 usa 8 vCPUs y 30 GB por cada VM.

Para sustituir la reserva adjunta res-1 por res-2 para el compromiso my-commitment-with-reservations, haz lo siguiente:

1. Crea un archivo llamado two-reservations.yaml en el directorio actual. Este archivo debe contener lo siguiente:

   - reservation: res-1
     reservation_zone: asia-east1-a
     vm_count: 0
     machine_type: n1-standard-4
     accelerator:
     - count: 1
       type: nvidia-tesla-p100
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   - reservation: res-2
     reservation_zone: asia-east1-a
     vm_count: 2
     machine_type: n1-standard-8
     accelerator:
     - count: 2
       type: nvidia-tesla-p100
     project: my-project
     share_setting: projects
     share_with:
     - project-1
     - project-2
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   

2. Ejecuta el siguiente comando:

   gcloud beta compute commitments update-reservations my-commitment-with-reservations \
       --region=asia-east1 \
       --reservations-from-file=two-reservations.yaml
   

REST

Para sustituir las reservas asociadas a compromisos, haz una solicitud POST con el método regionCommitments.updateReservations.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/COMMITMENT_ZONE/commitments/COMMITMENT_NAME/updateReservations

{
  "reservations":
  [
    {
      "name": "REPLACEMENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "REPLACEMENT_RESERVATION_NUMBER_OF_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "REPLACEMENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "REPLACEMENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "REPLACEMENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    },
    {
      "name": "CURRENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "0",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "CURRENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "CURRENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "CURRENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    }
  ]
}

Sustituye lo siguiente por las propiedades correspondientes del compromiso, la reserva actual y la reserva de sustitución:

Ejemplo de sustitución de una reserva asociada a un compromiso

Para demostrarlo, en esta sección se muestra un ejemplo de compromiso con una reserva adjunta y cómo sustituir la reserva adjunta de ejemplo.

Ejemplo de compromiso con una reserva asociada

Por ejemplo, supongamos que quieres sustituir la reserva asociada res-1 por la confirmación my-commitment-with-reservations, que se compró haciendo la siguiente solicitud POST:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments

  {
    "name": "my-commitment-with-reservations",
    "plan": "TWELVE_MONTH",
    "reservations":
    [
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "4",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "1",
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ],
    "resources":
    [
      {
        "amount": "16",
        "type": "VCPU"
      },
      {
        "amount": "61440",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "nvidia-tesla-p100",
        "amount": "4",
        "type": "ACCELERATOR"
      }
      {
        "amount": "3072000",
        "type": "LOCAL_SSD"
      }
    ],
    "type": "GENERAL_PURPOSE"
  }

Este my-commitment-with-reservations compromiso y la reserva res-1 adjunta han dado lugar a los siguientes recursos comprometidos y reservados:

^* En concreto, la reserva adjunta de ejemplo, res-1, reserva 4 n1-standard-4 máquinas virtuales, cada una con 1 GPU P100 y 2 discos SSD locales de tipo de interfaz scsi. El n1-standard-4 tipo de máquina usa 4 vCPUs y 15 GB por cada VM.

Sustituir la reserva de ejemplo adjunta

Supongamos que quieres sustituir la reserva adjunta res-1 por una nueva reserva adjunta res-2 y cambiar los recursos reservados por los siguientes:

^* En concreto, la reserva adjunta de ejemplo, res-1, reserva 4 n1-standard-4 VMs, cada una con 1 GPU P100 y 2 discos SSD locales de tipo de interfaz scsi. El n1-standard-4 tipo de máquina usa 4 vCPUs y 15 GB por cada VM.

^† En concreto, la reserva vinculada de sustitución define res-2, que reserva 2 VMs n1-standard-8, cada una con 1 GPU P100 y 4 discos SSD locales de tipo de interfaz scsi. Además, res-2 se ha compartido con otros dos proyectos, project-1 y project-2, y es propiedad del proyecto actual, my-project. El tipo de máquina n1-standard-8 usa 8 vCPUs y 30 GB por cada VM.

Para sustituir la reserva res-1 adjunta por res-2 en el compromiso my-commitment-with-reservations, haz la siguiente solicitud POST mediante el método regionCommitments.updateReservations:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments/my-commitment-with-reservations/updateReservations

  {
    "reservations":
    [
      {
        "name": "res-2",
        "specificReservation":
        {
          "count": "2",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 2,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-8"
          }
        },
        "zone": "asia-east1-a"
      },
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "0",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 1,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ]
  }