Combina reservas con descuentos por uso comprometido

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Consola

Antes de comprar un compromiso usando la consola de Google Cloud, seleccione el proyecto que desea usar para comprar el compromiso. Si el uso compartido de CUD está habilitado para una cuenta de Facturación de Cloud, puedes comprar el compromiso usando cualquier proyecto de esa cuenta de Facturación de Cloud. Después de seleccionar el proyecto, haga lo siguiente:

1. En la consola de Google Cloud, vaya a la página de descuentos por uso confirmado .

   Ir a descuentos por uso comprometido

2. Para comprar un compromiso, haga clic en add_box Compromiso de compra . Se abre la página Comprar un descuento por uso comprometido y muestra la pestaña Hardware .

3. En el campo Nombre , ingrese un nombre para su compromiso.

4. En el campo Región , selecciona la región donde deseas comprometer los recursos de Compute Engine.

5. En el campo Tipo de compromiso , seleccione la serie de la familia de máquinas para sus recursos comprometidos. Los siguientes tipos de compromiso brindan opciones para GPU, discos SSD locales o ambos:

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

6. Para Duración , haga lo siguiente:

   1. Para especificar el plan de su compromiso, seleccione 1 año o 3 años . Esta configuración determina la duración del plazo preestablecido de su compromiso.

   2. Opcional. Para especificar una duración de plazo personalizada para su compromiso, haga clic en el botón Ampliar fecha de finalización y luego, en el campo Fecha , especifique una fecha de finalización personalizada. Para obtener más información, consulte Ampliar la duración del plazo de los compromisos .

7. En el campo Núcleos , ingrese la cantidad de vCPU que desea comprometer.

8. En el campo Memoria , ingrese la cantidad, en GB, de memoria que desea asignar.

9. Para comprometerse con las GPU, en la sección GPU , haga clic en add Agregar GPU y luego haga lo siguiente:

   1. En el campo Tipo de GPU , seleccione el tipo de GPU.
   2. En el campo Número de GPU , ingrese la cantidad de GPU.
   3. Opcional: si su modelo de GPU admite estaciones de trabajo virtuales NVIDIA RTX (vWS) para cargas de trabajo de gráficos y planea ejecutar cargas de trabajo con uso intensivo de gráficos, seleccione la casilla de verificación Habilitar estación de trabajo virtual (NVIDIA GRID) .

10. Para comprometerse con discos SSD locales, en la sección SSD locales , haga clic en add Agregar SSD y luego, en el campo Número de SSD , especifique la cantidad de discos.

11. Para adjuntar una o más reservas existentes al compromiso, en el campo Reservas , seleccione Adjuntar reservas existentes .

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

    1. Opcional. Para ver reservas con propiedades específicas, en el menú Filtro , agregue o elimine filtros para las propiedades que desee.
    2. Selecciona todas las reservas que quieras adjuntar al compromiso.

12. Para finalizar la compra de tu compromiso con las reservas adjuntas, haz lo siguiente:

    1. Haga clic en Comprar .
    2. En el cuadro de diálogo Comprar un descuento por uso comprometido , si está de acuerdo con los términos específicos del servicio , haga clic en Comprar nuevamente.

nube de gcloud

Para comprar un compromiso adjuntando reservas existentes, ejecuta el comando gcloud compute commitments create . En su comando, incluya la marca --existing-reservation para especificar una reserva existente que desea adjuntar a su compromiso. Incluya una nueva instancia de esta bandera para cada reserva existente que desee adjuntar. Puede adjuntar cualquier número de reservas existentes a su compromiso.

Por ejemplo, para comprar un compromiso adjuntándole dos reservas, ejecute 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'

Reemplace lo siguiente:

• COMMITMENT_NAME : el nombre del compromiso.
• REGION : la región donde se encuentra el compromiso.
• PROJECT_ID : el ID del proyecto donde deseas adquirir el compromiso con las reservas adjuntas.
• DURATION : la duración del plazo del compromiso, ya sea 12-month o 36-month .
• CUSTOM_END_DATE : Opcional. Una fecha de finalización personalizada para su período, que debe tener el formato YYYY-MM-DD . Por ejemplo, para especificar una fecha de finalización personalizada del 20 de abril de 2024, formatéela como 2024-04-20 .

• COMMITMENT_TYPE : el tipo de compromiso. Los siguientes tipos de compromiso brindan opciones para GPU, discos SSD locales o ambos:

  • accelerator-optimized para recursos de tipo máquina A2.
  • accelerator-optimized-a3 para recursos de tipo de máquina A3 Edge y A3 High
  • accelerator-optimized-a3-mega para recursos de tipo máquina A3 Mega
  • compute-optimized para recursos de tipo máquina C2.
  • compute-optimized-c2d para recursos de tipo máquina C2D
  • compute-optimized-c3 para recursos de tipo de máquina C3
  • compute-optimized-c3d para recursos de tipo máquina C3D
  • general-purpose para recursos de tipo máquina N1
  • general-purpose-n2 para recursos de tipo máquina N2
  • general-purpose-n2d para recursos de máquinas N2D
  • graphics-optimized para recursos de tipo 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 : la cantidad de vCPU que desea en su compromiso. El número debe ser un número entero positivo.

• COMMITTED_MEMORY : la cantidad, en MB o GB, de memoria que deseas en tu compromiso. Por ejemplo, 10240MB o 10GB . Si no especificas una unidad, Compute Engine usa GB como unidad. Puede comprar memoria en incrementos de 0,25 GB.

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

• COMMITTED_ACCELERATOR_COUNT : la cantidad de GPU que deseas en tu compromiso.

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

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

• RESERVATION_ZONE_1 y RESERVATION_ZONE_2 : Las zonas de las reservas existentes que desea adjuntar al compromiso.

Ejemplo: comprar un compromiso adjuntando reservas existentes

Supongamos que tiene 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 para 4 GPU NVIDIA P100 y 4 discos SSD locales. Para comprar un nuevo compromiso en la región us-central1 de este proyecto para estas GPU y discos SSD locales, y usar estas reservas existentes como reservas adjuntas, ejecute el siguiente comando. Tenga en cuenta que el compromiso de ejemplo también contiene vCPU 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
    

DESCANSAR

Para comprar un compromiso adjuntando reservas existentes, realice 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 existentes que desea adjuntar a su compromiso. Puede adjuntar cualquier número de reservas existentes a su compromiso.

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"
}

Reemplace lo siguiente:

• COMMITMENT_NAME : el nombre del compromiso.
• REGION : la región donde se encuentra el compromiso.
• PROJECT_ID : el ID del proyecto donde deseas adquirir el compromiso con las reservas adjuntas.
• DURATION : la duración del plazo del compromiso, ya sea TWELVE_MONTH o THIRTY_SIX_MONTH .

• COMMITMENT_TYPE : el tipo de compromiso. Los siguientes tipos de compromiso brindan opciones para GPU, discos SSD locales o ambos:

  • ACCELERATOR_OPTIMIZED para recursos de tipo máquina A2
  • ACCELERATOR_OPTIMIZED_A3 para recursos de tipo de máquina A3 Edge y A3 High
  • ACCELERATOR_OPTIMIZED_A3_MEGA para recursos de tipo máquina A3 Mega
  • COMPUTE_OPTIMIZED para recursos de tipo máquina C2
  • COMPUTE_OPTIMIZED_C2D para recursos de tipo de máquina C2D
  • COMPUTE_OPTIMIZED_C3 para recursos de tipo 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áquina 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 máquina Z3

• COMMITTED_VCPUS : la cantidad de vCPU que desea en su compromiso. El número debe ser un número entero positivo.

• COMMITTED_MEMORY : la cantidad, en MB, de memoria que deseas en tu compromiso. Por ejemplo, 10240MB . Puede comprar memoria en incrementos de 256 MB.

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

• COMMITTED_ACCELERATOR_COUNT : la cantidad de GPU que deseas en tu compromiso.

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

• CUSTOM_END_DATE : Opcional. Una fecha de finalización personalizada para su período, que debe tener el formato YYYY-MM-DD . Por ejemplo, para especificar una fecha de finalización personalizada del 20 de abril de 2024, formatéela como 2024-04-20 .

• END_TIME : 12 a. m., hora del Pacífico de EE. UU. y Canadá (UTC-8 o UTC-7), como diferencia con la hora universal coordinada (UTC) . Especifique este valor solo si especificó una fecha de finalización personalizada para su compromiso. Especifique uno de los siguientes valores:

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

• RESERVATION_URLs : una lista separada por comas de las URL de las reservas existentes que desea adjuntar al compromiso. Por ejemplo, para adjuntar dos reservas, res-1 y res-2 , especifique 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 un compromiso adjuntando reservas existentes

Supongamos que tiene 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 para 4 GPU NVIDIA P100 y 4 discos SSD locales. Para comprar un nuevo compromiso en la región us-central1 de este proyecto para estas GPU y discos SSD locales y utilizar estas reservas existentes como reservas adjuntas, realice la siguiente solicitud POST . Tenga en cuenta que el compromiso de ejemplo también contiene vCPU 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 usando la consola de Google Cloud, seleccione el proyecto que desea usar para comprar el compromiso. Si el uso compartido de CUD está habilitado para una cuenta de Facturación de Cloud, puedes comprar el compromiso usando cualquier proyecto de esa cuenta de Facturación de Cloud. Después de seleccionar el proyecto, haga lo siguiente:

1. En la consola de Google Cloud, vaya a la página de descuentos por uso confirmado .

   Ir a descuentos por uso comprometido

2. Para comprar un compromiso, haga clic en add_box Compromiso de compra . Se abre la página Comprar un descuento por uso comprometido y muestra la pestaña Hardware .

3. En el campo Nombre , ingrese un nombre para su compromiso.

4. En el campo Región , selecciona la región donde deseas comprometer los recursos de Compute Engine.

5. En el campo Tipo de compromiso , seleccione la serie de la familia de máquinas para sus recursos comprometidos. Los siguientes tipos de compromiso brindan opciones para GPU, discos SSD locales o ambos:

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

6. Para Duración , elija 1 año o 3 años como duración del plazo de su compromiso.

7. En el campo Núcleos , ingrese la cantidad de vCPU que desea comprometer.

8. En el campo Memoria , ingrese la cantidad, en GB, de memoria que desea asignar.

9. Para comprometerse con las GPU, en la sección GPU , haga clic en add Agregar GPU y luego haga lo siguiente:

   1. En el campo Tipo de GPU , seleccione el tipo de GPU.
   2. En el campo Número de GPU , ingrese la cantidad de GPU.
   3. Opcional: si su modelo de GPU admite estaciones de trabajo virtuales NVIDIA RTX (vWS) para cargas de trabajo de gráficos y planea ejecutar cargas de trabajo con uso intensivo de gráficos, seleccione la casilla de verificación Habilitar estación de trabajo virtual (NVIDIA GRID) .

10. Para comprometerse con discos SSD locales, en la sección SSD locales , haga clic en add Agregar SSD y luego, en el campo Número de SSD , especifique la cantidad de discos.

11. Para crear una nueva reserva y adjuntarla al compromiso, en el campo Reservas , seleccione Crear reservas y luego haga lo siguiente. Repita este paso para cada nueva reserva que desee crear y adjuntar.

    1. Haz clic en Agregar una reserva . Aparece la sección Nueva reserva .
    2. En el campo Nombre , ingrese un nombre para su reserva adjunta.
    3. En el campo Región , seleccione la misma región que su compromiso.
    4. En el campo Zona , seleccione la zona donde desea reservar sus recursos.

    5. En la sección Tipo de compartir , especifique cómo desea compartir esta reserva de una de las siguientes maneras:

       • Para crear una reserva de un solo proyecto, seleccione Local .
       • Para crear una reserva compartida con varios proyectos, seleccione Compartido . Luego, para especificar los proyectos con los que compartir esta reserva, haga clic en add Agregar proyectos y luego seleccione los proyectos que desee de la organización del proyecto actual.

    6. En el campo Usar con instancia de VM , seleccione cómo desea que las VM consuman su reserva de una de las siguientes maneras:

       • Para permitir que las máquinas virtuales con propiedades coincidentes consuman automáticamente esta reserva, haga clic en Usar reserva automáticamente (predeterminado).
       • Para consumir los recursos de esta reserva solo al crear máquinas virtuales con propiedades coincidentes que se dirijan específicamente a esta reserva por nombre, haga clic en Seleccionar Seleccionar reserva específica .

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

       1. En el campo Número de instancias de VM , ingrese la cantidad de instancias de VM que desea reservar.

       2. En la sección Configuración de la máquina , especifique las propiedades de sus máquinas virtuales reservadas de una de las siguientes maneras:

          1. Para especificar las propiedades de sus máquinas virtuales usando una plantilla de instancia existente, seleccione Usar plantilla de instancia .

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

          2. Para especificar manualmente las propiedades de sus máquinas virtuales, seleccione Seleccionar tipo de máquina y luego haga lo siguiente:

             1. Seleccione la familia de máquinas que se aplica a la serie de máquinas que especificó para el compromiso:

                • Propósito general para series de máquinas de uso general.
                • Computación optimizada para series de máquinas optimizadas para computación
                • Memoria optimizada para series de máquinas con memoria optimizada
                • GPU para series de máquinas optimizadas para aceleradores

             2. En la tabla que tiene la columna Serie , seleccione la misma serie de máquinas que especificó para el compromiso.

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

                1. Para elegir un tipo de máquina predefinido, seleccione Preestablecido y luego seleccione el tipo de máquina que desee.
                2. Para elegir un tipo de máquina personalizado, seleccione Personalizado y luego especifique los núcleos y la memoria que desee.

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

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

                2. Opcional: para reservar GPU, haga clic en add Agregar GPU . Luego, en los campos Tipo de GPU y Número de GPU , seleccione el tipo y la cantidad de GPU para cada VM.

             5. Para reservar discos SSD locales, haga lo siguiente:

                1. En el campo Número de discos , seleccione la cantidad de discos SSD locales que desea para cada máquina virtual.
                2. En el campo Tipo de interfaz , seleccione la interfaz para los discos SSD locales.

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

12. Para finalizar la compra de tu compromiso con las reservas adjuntas, haz lo siguiente:

    1. Haga clic en Comprar .
    2. En el cuadro de diálogo Comprar un descuento por uso comprometido , si está de acuerdo con los términos específicos del servicio , haga clic en Comprar nuevamente.

nube de gcloud

Para crear tus reservas adjuntas mientras compras tu compromiso, ejecuta el comando gcloud compute commitments create .

Dependiendo de si desea adjuntar una única reserva o varias reservas, ejecute el comando de una de las siguientes maneras:

• Para crear y adjuntar una única reserva a su compromiso, defina 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 su compromiso, defina las propiedades de la reserva usando un archivo YAML y luego especifique ese archivo YAML en el comando que usa para comprar su compromiso. Opcionalmente, también puede usar este enfoque de archivo YAML para crear y adjuntar una sola reserva a su compromiso. Para crear sus reservas adjuntas utilizando este enfoque, haga lo siguiente:

  1. Cree el archivo YAML en el directorio actual y especifique la configuración que desea para cada reserva adjunta. Por ejemplo, para especificar la configuración de una reserva compartida compartida con dos proyectos que especifica GPU, dos discos SSD locales y una plataforma mínima de CPU, incluya el siguiente texto en su 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 múltiples reservas, repita estas propiedades para cada reserva que desea crear. Puede adjuntar cualquier cantidad de reservas existentes que desee con su compromiso.

  2. Ejecute el comando gcloud compute commitments create e incluya el indicador --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
     

Reemplace lo siguiente con las propiedades correspondientes del compromiso y las reservas adjuntas:

El motor de cálculo crea el compromiso y las reservas adjuntas solo si hay suficientes recursos del tipo de máquina especificada en la zona de destino, y una cuota suficiente, en el momento de su solicitud. Si su compra fue exitosa, verá un mensaje de éxito similar al siguiente:

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

Ejemplos para comprar compromisos creando nuevas reservas para adjuntar

Los siguientes escenarios y comandos de ejemplo muestran cómo puede comprar un compromiso para GPU, discos SSD locales o ambos creando nuevas reservas para adjuntar ese compromiso.

Ejemplo 1: Compre un compromiso para las GPU adjuntando una sola reserva nueva

Supongamos que desea comprar un commitment-01 en la región us-central1 Que incluye 4 GPU NVIDIA V100. Desea crear una nueva reservation-01 como la reserva adjunta para esas GPU. Supongamos que también desea especificar Compute Engine para usar esas GPU reservadas en 2 máquinas virtuales n1-standard-32 en la zona us-central1-a . Para comprar este compromiso de ejemplo con su reserva adjunta, ejecute 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: Compre un compromiso para las GPU sin comprometerse con VCPU o memoria

Para comprometerse y reservar GPU y discos SSD locales sin comprometerse con VCPU o memoria, especifique 0 como el valor para las cantidades de VCPU y memoria. Por ejemplo, suponga que desea comprar un commitment-02 para una sola GPU NVIDIA P4 en la región us-west2 . También desea crear una nueva reserva como reserva adjunta y especificar el motor de cálculo para usar la GPU reservada en una VM n1-standard-2 en la zona us-west2-b . Para comprar este compromiso de ejemplo con su reserva adjunta, ejecute 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: Compre un compromiso para las GPU y los discos SSD locales adjuntando múltiples nuevas reservas

Supongamos que desea comprar un commitment-03 para 1 GPU NVIDIA V100 y 2 discos SSD locales en la región us-central1 . También desea crear y adjuntar dos reservas en la zona us-central1-a . En la primera reserva, res-01 , desea reservar 1 VM n1-standard-2 con 1 GPU. Desea hacer de res-01 una reserva específica, lo que significa que debe dirigirse específicamente a esa reserva por nombre para usar sus máquinas virtuales reservadas. En la segunda reserva, res-02 , desea reservar 1 n1-standard-8 VM con 2 tipos de discos SSD locales adjuntos.

Para comprar este compromiso de ejemplo con las reservas adjuntas, primero cree 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

Después de crear el archivo YAML, para terminar de comprar el compromiso con sus reservas adjuntas, ejecute el siguiente comando. Tenga en cuenta que el compromiso de ejemplo también contiene recursos de VCPU y 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

DESCANSAR

Para crear sus reservas adjuntas mientras compra su compromiso, realice una solicitud POST a regionCommitments.insert Método Insert . En su solicitud, incluya el campo reservations para definir una lista de todas las nuevas reservas que desea crear y adjuntar. Puede adjuntar cualquier cantidad de reservas existentes que desee con su compromiso.

• Para crear su nueva reserva especificando manualmente todas las propiedades de VM, incluya el campo instanceProperties y excluya el campo sourceInstanceTemplate .

  Por ejemplo, para especificar manualmente la configuración de una reserva compartida compartida con dos proyectos que especifica GPU, dos discos SSD locales y una plataforma mínima de CPU, realice 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 su nueva reserva especificando una plantilla de instancia, incluya el campo sourceInstanceTemplate y excluya 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"
          }
        }
      }
    }
  ]
  }
  
  

Reemplace lo siguiente con las propiedades correspondientes del compromiso y las reservas adjuntas:

El motor de cálculo crea el compromiso y las reservas adjuntas solo si hay suficientes recursos del tipo de máquina especificada en la zona de destino, y una cuota suficiente, en el momento de su solicitud. Si su compra fue exitosa, Compute Engine devuelve un estado 200 para su solicitud de API REST.

Ejemplos para comprar compromisos creando nuevas reservas para adjuntar

Los siguientes escenarios y comandos de ejemplo muestran cómo puede comprar un compromiso para GPU, discos SSD locales o ambos creando nuevas reservas para adjuntar ese compromiso.

Ejemplo 1: Compre un compromiso para las GPU adjuntando una sola reserva nueva

Supongamos que desea comprar un commitment-01 en la región us-central1 Que incluye 4 GPU NVIDIA V100. Desea crear una nueva reservation-01 como la reserva adjunta para esas GPU. Supongamos que también desea especificar Compute Engine para usar esas GPU reservadas en 2 n1-standard-8 VM en la zona us-central1-a . Para comprar este ejemplo de compromiso con su reserva adjunta, haga 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: Compre un compromiso para las GPU sin comprometerse con VCPU o memoria

Para comprometerse y reservar GPU y discos SSD locales sin comprometerse con VCPU o memoria, especifique 0 como el valor para las cantidades de VCPU y memoria. Por ejemplo, suponga que desea comprar un commitment-02 para una sola GPU NVIDIA P4 en la región us-west2 . También desea crear una nueva reserva como reserva adjunta y especificar el motor de cálculo para usar la GPU reservada en una VM n1-standard-2 en la zona us-west2-b . Para comprar este ejemplo de compromiso con su reserva adjunta, haga 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: Compre un compromiso para las GPU y los discos SSD locales adjuntando múltiples nuevas reservas

Supongamos que desea comprar un commitment-03 para 1 GPU NVIDIA V100 y 2 discos SSD locales en la región us-central1 . También desea crear y adjuntar dos reservas en la zona us-central1-a . En la primera reserva, res-01 , desea reservar 1 VM n1-standard-2 con 1 GPU. Desea hacer de res-01 una reserva específica, lo que significa que debe dirigirse específicamente a esa reserva por nombre para usar sus máquinas virtuales reservadas. En la segunda reserva, res-02 , desea reservar 1 n1-standard-8 VM con 2 tipos de discos SSD locales adjuntos. Para comprar este ejemplo de compromiso con las reservas adjuntas, haga la siguiente solicitud POST . Tenga 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"
    }
  ]
}

nube de gcloud

Para reemplazar las reservas adjuntas a los compromisos, haga lo siguiente:

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

   • La reserva actual que desea reemplazar.

     Para recuperar los detalles de esta reserva, vea Vea los detalles de una reserva .

   • La nueva reserva de reemplazo.

   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
   
   

   Reemplace lo siguiente con las propiedades correspondientes de las reservas actuales y de reemplazo:

   Reserva actual

   Para la reserva actual, todas las siguientes propiedades deben ser exactamente las mismas que cuando vio la reserva. Omita los campos para cualquier propiedad que la reserva actual no tenga.

   • 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 correcta adjunta.
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS : el número de GPU 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 para cada VM reservado en la reserva adjunta actual. Las opciones válidas son: scsi y nvme . Cada disco SSD local es de 375 GB. Repita el parámetro local_ssd para todos los discos SSD locales reservados.
   • CURRENT_RESERVATION_PROJECT_ID : la ID del proyecto del proyecto actual que tiene el compromiso y la reserva adjunta. Especifique este campo si su reserva adjunta actual se comparte en múltiples proyectos de consumidores.
   • CURRENT_RESERVATION_SHARE_SETTING : el tipo de intercambio para la reserva actual. Especifique este campo con el valor como projects si su reserva adjunta actual se comparte en múltiples proyectos de consumo.
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 y CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2 : los ID de proyecto de los proyectos con los que comparte la reserva correcta adjunta con project-1 y project-2 .

   Reserva de reemplazo

   Para la reserva de reemplazo, establezca las siguientes propiedades según sea necesario. Asegúrese de cumplir con todos los requisitos cuando especifique estas propiedades. Omita cualquier campo adicional que no desee usar.

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

   • REPLACEMENT_RESERVATION_MACHINE_TYPE : el tipo de máquina que desea para las máquinas virtuales en su nueva reserva de reemplazo.

     • Para los tipos de máquinas predefinidas , use el formato MACHINE_FAMILY -standard- CPUS ; Por ejemplo, n2-standard-4 .
     • Para los tipos de máquinas personalizadas , use el formato MACHINE_FAMILY -custom- CPUS - MEMORY ; Por ejemplo n2-custom-4-5120 . Para obtener una lista completa de restricciones, lea las especificaciones para tipos de máquinas personalizadas.

     Reemplace lo siguiente:

     • MACHINE_FAMILY : la familia de tipos de máquinas; Por ejemplo, especifique n2 para VMS N2.
     • CPUS : el número de VCPU .
     • MEMORY : la memoria total para una VM reservada. La memoria debe ser un múltiplo de 256 MB y debe suministrarse en MB; Por ejemplo, para crear una VM N2 con 4 VCPU y 5 GB de memoria, que es 5120 MB, use n2-custom-4-5120 .

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS : el número de GPU que desea agregar, por vm, en la reserva de reemplazo.

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE : el tipo de acelerador que desea agregar en la reserva de reemplazo.

   • REPLACEMENT_RESERVATION_INTERFACE_1 y REPLACEMENT_RESERVATION_INTERFACE_2 : el tipo de interfaz que desea que use los discos SSD locales para cada VM reservada. Las opciones válidas son: scsi y nvme . Cada disco SSD local es de 375 GB. Repita el parámetro local_ssd para cada disco SSD local que desea agregar. Puede especificar hasta 24 discos SSD locales.

   • REPLACEMENT_RESERVATION_PROJECT_ID : la ID del proyecto del proyecto actual que tiene el compromiso y la reserva adjunta. Especifique este campo si desea compartir su reserva de reemplazo en múltiples proyectos de consumo.

   • REPLACEMENT_RESERVATION_SHARE_SETTING : el tipo de intercambio para la reserva de reemplazo. Especifique este campo con el valor como projects si desea compartir su reserva de reemplazo en múltiples proyectos de consumo.

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 y REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2 : los ID de proyecto de los proyectos que pueden compartir esta reserva, por ejemplo, project-1,project-2 . Puede incluir hasta 100 proyectos de consumo. Estos proyectos deben estar en la misma organización que el Proyecto del Propietario. No incluya el REPLACEMENT_RESERVATION_PROJECT_ID , que ya puede consumir esta reserva por defecto.

2. Ejecute el comando gcloud beta compute commitments update-reservations y especifique la ruta al archivo YAML utilizando el indicador --reservations-from-file .

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

   Reemplace lo siguiente:

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

Ejemplo para reemplazar una reserva adjunta a un compromiso

Para demostrar esto, esta sección muestra un compromiso de ejemplo con una reserva adjunta y cómo reemplazar el ejemplo de reserva adjunta .

Ejemplo de compromiso con una reserva adjunta

Por ejemplo, supongamos que desea actualizar las reservas adjuntas para el compromiso my-commitment-with-reservations , que se compró utilizando 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

Para este ejemplo, suponga que cuando se ejecutó este comando, one-reservation.yaml era un archivo en el directorio actual con los siguientes contenidos, que definen 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 y la reserva de reserva adjunta res-1 dio como resultado los siguientes recursos comprometidos y reservados:

^* Específicamente, el ejemplo de reserva adjunta, res-1 , reserva 4 n1-standard-4 VMS, cada una con 1 GPU P100 y 2 discos SSD locales del tipo de interfaz scsi . El tipo de máquina n1-standard-4 usa 4 VCPU y 15 GB para cada VM.

Reemplace el ejemplo de reserva adjunta

Supongamos que desea reemplazar la reserva de reserva adjunta res-1 para el nuevo con una nueva reserva adjunta res-2 y cambiar los recursos reservados a lo siguiente:

^* Específicamente, el ejemplo de reserva adjunta, res-1 , reserva 4 n1-standard-4 VMS, cada una con 1 GPU P100 y 2 discos SSD locales del tipo de interfaz scsi . El tipo de máquina n1-standard-4 usa 4 VCPU y 15 GB para cada VM.

^† Específicamente, la reserva adjunta de reemplazo define res-2 , que reserva 2 n1-standard-8 VMS N1, cada una con 1 GPU P100 y 4 discos SSD locales del tipo de interfaz scsi . Además, res-2 se comparte con otros 2 proyectos, project-1 y project-2 y propiedad del proyecto actual, my-project . El tipo de máquina n1-standard-8 usa 8 VCPU y 30 GB para cada VM.

Para reemplazar la reserva adjunta res-1 con res-2 para el my-commitment-with-reservations , haga lo siguiente:

1. Cree un archivo llamado two-reservations.yaml en el directorio actual que el archivo contiene el siguiente contenido:

   - 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. Ejecute el siguiente comando:

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

DESCANSAR

Para reemplazar las reservas que se adjuntan a los compromisos, haga una solicitud POST utilizando 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"
          }
         }
      }
    }
  ]
}

Reemplace lo siguiente con las propiedades correspondientes del compromiso, la reserva actual y la reserva de reemplazo:

Example for replacing a reservation that is attached to a commitment

To demonstrate this, this section shows an example commitment with an attached reservation and how to replace the example attached reservation .

Example commitment with an attached reservation

For example, suppose that you want to replace the attached reservation res-1 for the my-commitment-with-reservations commitment, that was purchased by making the following POST request:

  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"
  }

This my-commitment-with-reservations commitment and the attached reservation res-1 resulted in the following committed and reserved resources:

^* Specifically, the example attached reservation, res-1 , reserves 4 n1-standard-4 VMs, each with 1 P100 GPU and 2 Local SSD disks of scsi interface type. The n1-standard-4 machine type uses 4 vCPUs and 15 GB for each VM.

Replace the example attached reservation

Suppose you want to replace the attached reservation res-1 for the with a new attached reservation res-2 and change the reserved resources to the following:

^* Specifically, the example attached reservation, res-1 , reserves 4 n1-standard-4 VMs, each with 1 P100 GPU and 2 Local SSD disks of scsi interface type. The n1-standard-4 machine type uses 4 vCPUs and 15 GB for each VM.

^† Specifically, the replacement attached reservation defines res-2 , which reserves 2 n1-standard-8 VMs, each with 1 P100 GPU and 4 Local SSD disks of scsi interface type. Additionally, res-2 is shared with 2 other projects, project-1 and project-2 and owned by the current project, my-project . The n1-standard-8 machine type uses 8 vCPUs and 30 GB for each VM.

To replace the attached reservation res-1 with res-2 for the my-commitment-with-reservations commitment, make the following POST request by using the regionCommitments.updateReservations method:

  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"
      }
    ]
  }