Combiner les réservations et les remises sur engagement d'utilisation

Console

Avant de souscrire un engagement à l'aide de la console Google Cloud, sélectionnez le projet que vous souhaitez utiliser pour souscrire l'engagement. Si le partage de remises sur engagement d'utilisation est activé sur un compte de facturation Cloud, vous pouvez utiliser n'importe quel projet associé à ce compte de facturation Cloud pour souscrire l'engagement. Après avoir sélectionné le projet, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Remises sur les engagements d'utilisation.

   Accéder aux remises sur engagement d'utilisation

2. Pour souscrire un engagement, cliquez sur add_box Souscrire un engagement. La page Obtenir une remise sur engagement d'utilisation s'ouvre et affiche l'onglet Matériel.

3. Dans le champ Nom, saisissez le nom de votre engagement.

4. Dans le champ Région, sélectionnez la région dans laquelle vous souhaitez engager des dépenses pour les ressources Compute Engine.

5. Dans le champ Type d'engagement, sélectionnez la série de familles de machines de vos ressources comprises dans cet engagement. Les types d'engagements suivants fournissent des options pour les GPU, les disques SSD locaux ou les deux :

   • Optimisé pour l'accélérateur (A2) pour les ressources de type de machine A2
   • A3 optimisé pour l'accélérateur pour les ressources de type de machine A3 Edge et High
   • A3 Mega optimisé pour les accélérateurs pour les ressources de type de machine A3 Mega
   • Optimisé pour le calcul (C2) pour les ressources de type de machine C2
   • Optimisé pour le calcul (C2D) pour les ressources de type de machine C2D
   • Usage général (C3) pour les ressources de type de machine C3
   • Usage général (C3D) pour les ressources de type de machine C3D
   • Usage général (N1) pour les ressources de type de machine N1
   • Usage général (N2) pour les ressources de type de machine N2
   • Usage général (N2D) pour les ressources de machine N2D
   • Optimisé pour les graphiques (G2) pour les ressources de type de machine G2
   • Mémoire optimisée M3 pour les ressources de type de machine M3
   • Optimisé pour le stockage Z3 pour les ressources de type de machine Z3

6. Pour Durée, procédez comme suit:

   1. Pour spécifier le forfait de votre engagement, sélectionnez 1 an ou 3 ans. Ce paramètre détermine la durée prédéfinie de votre engagement.

   2. Facultatif. Pour spécifier une durée personnalisée pour votre engagement, cliquez sur l'option Prolonger la date de fin, puis, dans le champ Date, spécifiez une date de fin personnalisée. Pour en savoir plus, consultez la section Prolonger la durée des engagements.

7. Dans le champ Cœurs, indiquez le nombre de processeurs virtuels sur lequel vous souhaitez vous engager.

8. Dans le champ Mémoire, saisissez la quantité de mémoire (en Go) que vous souhaitez vous engager à utiliser.

9. Pour engager des dépenses pour des GPU, cliquez sur add Ajouter un GPU dans la section GPU, puis procédez comme suit :

   1. Dans le champ Type de GPU, sélectionnez le type de GPU.
   2. Dans le champ Nombre de GPU, saisissez le nombre de GPU.
   3. Facultatif : Si votre modèle de GPU est compatible avec les postes de travail virtuels NVIDIA RTX (vWS) pour les charges de travail graphiques et que vous prévoyez d'exécuter des charges de travail graphiques lourdes, cochez la case Activer le poste de travail virtuel (NVIDIA GRID).

10. Pour engager des dépenses pour des disques SSD locaux, cliquez sur add Ajouter un SSD dans la section Disques SSD locaux, puis spécifiez le nombre de disques dans le champ Nombre de disques SSD.

11. Pour associer une ou plusieurs réservations existantes à l'engagement, sélectionnez Associer des réservations existantes dans le champ Réservations.

    La console Google Cloud affiche la liste de toutes les réservations de votre projet dont la région, le type de machine et le type de GPU correspondent à l'engagement. Ensuite, procédez comme suit :

    1. Facultatif. Pour afficher des réservations avec des propriétés spécifiques, dans le menu Filtre, ajoutez ou supprimez des filtres correspondant aux propriétés souhaitées.
    2. Sélectionnez toutes les réservations que vous souhaitez associer à l'engagement.

12. Pour terminer la souscription de votre engagement avec les réservations associées, procédez comme suit :

    1. Cliquez sur Souscrire.
    2. Dans la boîte de dialogue Obtenir une remise sur engagement d'utilisation, si vous acceptez les conditions spécifiques du service, cliquez à nouveau sur Acheter.

gcloud

Pour souscrire un engagement en associant des réservations existantes, exécutez la commande gcloud compute commitments create. Dans votre commande, incluez l'option --existing-reservation pour spécifier une réservation existante que vous souhaitez associer à votre engagement. Incluez une nouvelle instance de cette option pour chaque réservation existante que vous souhaitez associer. Vous pouvez associer autant de réservations existantes que vous le souhaitez à votre engagement.

Par exemple, pour souscrire un engagement en lui associant deux réservations, exécutez la commande suivante:

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'

Remplacez les éléments suivants :

• COMMITMENT_NAME: nom de l'engagement.
• REGION : région où se trouve l'engagement.
• PROJECT_ID: ID du projet dans lequel vous souhaitez souscrire l'engagement avec les réservations associées.
• DURATION: durée de l'engagement, 12-month ou 36-month (12 mois ou 36 mois).
• CUSTOM_END_DATE : facultatif. Une date de fin personnalisée pour votre période, qui doit être au format YYYY-MM-DD. Par exemple, pour spécifier une date de fin personnalisée le 20 avril 2024, formatez-la sous la forme 2024-04-20.

• COMMITMENT_TYPE: type d'engagement. Les types d'engagements suivants fournissent des options pour les GPU, les disques SSD locaux ou les deux :

  • accelerator-optimized pour les ressources de type de machine A2
  • accelerator-optimized-a3 pour les ressources de type de machine A3 Edge et High
  • accelerator-optimized-a3-mega pour les ressources de type de machine A3 Mega
  • compute-optimized pour les ressources de type de machine C2
  • compute-optimized-c2d pour les ressources de type de machine C2D
  • compute-optimized-c3 pour les ressources de type de machine C3
  • compute-optimized-c3d pour les ressources de type de machine C3D
  • general-purpose pour les ressources de type de machine N1
  • general-purpose-n2 pour les ressources de type de machine N2
  • general-purpose-n2d pour les ressources de type de machine N2D
  • graphics-optimized pour les ressources de type de machine G2
  • memory-optimized-m3 pour les ressources de type de machine M3
  • storage-optimized-z3 pour les ressources de type de machine Z3

• COMMITTED_VCPUS: nombre de processeurs virtuels souhaité dans votre engagement. Il doit s'agit d'un nombre entier positif.

• COMMITTED_MEMORY: quantité de mémoire en Mo ou en Go que vous souhaitez dans votre engagement. Par exemple, 10240MB ou 10GB. Si vous ne spécifiez pas d'unité, Compute Engine utilise le gigaoctet comme unité. Vous pouvez acheter de la mémoire par incréments de 0,25 Go.

• COMMITTED_LOCAL_SSD: quantité, en Go, d'espace SSD local que vous souhaitez pour votre engagement. La capacité de chaque disque SSD local est de 375 Go.

• COMMITTED_ACCELERATOR_COUNT: nombre de GPU souhaité dans votre engagement.

• COMMITTED_ACCELERATOR_TYPE: type de GPU que vous souhaitez inclure dans votre engagement.

• RESERVATION_NAME_1 et RESERVATION_NAME_2: noms des réservations existantes que vous souhaitez associer à l'engagement.

• RESERVATION_ZONE_1 et RESERVATION_ZONE_2: zones des réservations existantes que vous souhaitez associer à l'engagement.

Exemple: Souscrire un engagement en associant des réservations existantes

Supposons que vous ayez deux réservations res-01 et res-02 dans les zones us-central1-a et us-central1-b du projet myproject. Supposons que ces réservations contiennent une capacité combinée pour quatre GPU NVIDIA P100 et quatre disques SSD locaux. Pour souscrire un nouvel engagement dans la région us-central1 de ce projet pour ces GPU et disques SSD locaux, et utiliser ces réservations existantes en tant que réservations associées, exécutez la commande suivante. Notez que l'exemple d'engagement contient également des processeurs virtuels et de la mémoire.

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

Pour souscrire un engagement en associant des réservations existantes, envoyez une requête POST à la méthode regionCommitments.insert. Dans votre requête, incluez le champ existingReservations pour spécifier la liste de toutes les réservations existantes que vous souhaitez associer à votre engagement (séparées par une virgule). Vous pouvez associer autant de réservations existantes que vous le souhaitez à votre engagement.

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

Remplacez les éléments suivants :

• COMMITMENT_NAME: nom de l'engagement.
• REGION : région où se trouve l'engagement.
• PROJECT_ID: ID du projet dans lequel vous souhaitez souscrire l'engagement avec les réservations associées.
• DURATION: durée de l'engagement, TWELVE_MONTH ou THIRTY_SIX_MONTH (12 mois ou 36 mois).

• COMMITMENT_TYPE : type d'engagement. Les types d'engagements suivants fournissent des options pour les GPU, les disques SSD locaux ou les deux :

  • ACCELERATOR_OPTIMIZED pour les ressources de type de machine A2
  • ACCELERATOR_OPTIMIZED_A3 pour les ressources de type de machine A3 Edge et High
  • ACCELERATOR_OPTIMIZED_A3_MEGA pour les ressources de type de machine A3 Mega
  • COMPUTE_OPTIMIZED pour les ressources de type de machine C2
  • COMPUTE_OPTIMIZED_C2D pour les ressources de type de machine C2D
  • COMPUTE_OPTIMIZED_C3 pour les ressources de type de machine C3
  • COMPUTE_OPTIMIZED_C3D pour les ressources de type de machine C3D
  • GENERAL_PURPOSE pour les ressources de type de machine N1
  • GENERAL_PURPOSE_N2 pour les ressources de type de machine N2
  • GENERAL_PURPOSE_N2D pour les ressources de type de machine N2D
  • GRAPHICS_OPTIMIZED pour les ressources de type de machine G2
  • MEMORY_OPTIMIZED_M3 pour les ressources de type de machine M3
  • STORAGE_OPTIMIZED_Z3 pour les ressources de type de machine Z3

• COMMITTED_VCPUS: nombre de processeurs virtuels souhaités dans votre engagement. Il doit s'agit d'un nombre entier positif.

• COMMITTED_MEMORY: quantité de mémoire en Mo que vous souhaitez pour votre engagement. Par exemple, 10240MB. Vous pouvez acheter de la mémoire par incréments de 256 Mo.

• COMMITTED_LOCAL_SSD: quantité, en Go, d'espace de stockage SSD local que vous souhaitez dans votre engagement. La capacité de chaque disque SSD local est de 375 Go.

• COMMITTED_ACCELERATOR_COUNT: nombre de GPU souhaité dans votre engagement.

• COMMITTED_ACCELERATOR_TYPE: type de GPU que vous souhaitez inclure dans votre engagement.

• CUSTOM_END_DATE : facultatif. Une date de fin personnalisée pour votre période, au format YYYY-MM-DD. Par exemple, pour spécifier une date de fin personnalisée au 20 avril 2024, utilisez le format 2024-04-20.

• END_TIME: minuit, heure du Pacifique des États-Unis et du Canada (UTC-8 ou UTC-7), en tant que décalage par rapport au temps universel coordonné (UTC). Spécifiez cette valeur uniquement si vous avez spécifié une date de fin personnalisée pour votre engagement. Spécifiez une des valeurs suivantes :

  • Pendant l'heure d'été: 07:00:00
  • À d'autres moments: 08:00:00

• RESERVATION_URLs: liste des URL des réservations existantes que vous souhaitez associer à l'engagement, séparées par une virgule. Par exemple, pour associer deux réservations, res-1 et res-2, spécifiez les éléments suivants:

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

Exemple : Souscrire un engagement en associant des réservations existantes

Supposons que vous ayez deux réservations res-01 et res-02 dans les zones us-central1-a et us-central1-b du projet myproject. Supposons que ces réservations contiennent une capacité combinée pour quatre GPU NVIDIA P100 et quatre disques SSD locaux. Pour souscrire un nouvel engagement dans la région us-central1 de ce projet pour ces GPU et disques SSD locaux, et pour utiliser ces réservations existantes en tant que réservations associées, effectuez la requête POST suivante. Notez que l'exemple d'engagement contient également des processeurs virtuels et de la mémoire.

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

Console

Avant de souscrire un engagement à l'aide de la console Google Cloud, sélectionnez le projet que vous souhaitez utiliser pour souscrire l'engagement. Si le partage de remises sur engagement d'utilisation est activé sur un compte de facturation Cloud, vous pouvez utiliser n'importe quel projet associé à ce compte de facturation Cloud pour souscrire l'engagement. Après avoir sélectionné le projet, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Remises sur les engagements d'utilisation.

   Accéder aux remises sur engagement d'utilisation

2. Pour souscrire un engagement, cliquez sur add_box Souscrire un engagement. La page Obtenir une remise sur engagement d'utilisation s'ouvre et affiche l'onglet Matériel.

3. Dans le champ Nom, saisissez le nom de votre engagement.

4. Dans le champ Région, sélectionnez la région dans laquelle vous souhaitez engager des dépenses pour les ressources Compute Engine.

5. Dans le champ Type d'engagement, sélectionnez la série de familles de machines de vos ressources comprises dans cet engagement. Les types d'engagements suivants fournissent des options pour les GPU, les disques SSD locaux ou les deux :

   • Optimisé pour l'accélérateur (A2) pour les ressources de type de machine A2
   • A3 optimisé pour l'accélérateur pour les ressources de type de machine A3 Edge et High
   • A3 Mega optimisé pour les accélérateurs pour les ressources de type de machine A3 Mega
   • Optimisé pour le calcul (C2) pour les ressources de type de machine C2
   • Optimisé pour le calcul (C2D) pour les ressources de type de machine C2D
   • Usage général (C3) pour les ressources de type de machine C3
   • Usage général (C3D) pour les ressources de type de machine C3D
   • Usage général (N1) pour les ressources de type de machine N1
   • Usage général (N2) pour les ressources de type de machine N2
   • Usage général (N2D) pour les ressources de machine N2D
   • Optimisé pour les graphiques (G2) pour les ressources de type de machine G2
   • Mémoire optimisée M3 pour les ressources de type de machine M3
   • Optimisé pour le stockage Z3 pour les ressources de type de machine Z3

6. Dans le champ Durée, choisissez 1 an ou 3 ans comme durée d'engagement.

7. Dans le champ Cœurs, indiquez le nombre de processeurs virtuels sur lequel vous souhaitez vous engager.

8. Dans le champ Mémoire, saisissez la quantité de mémoire (en Go) que vous souhaitez vous engager à utiliser.

9. Pour engager des dépenses pour des GPU, cliquez sur add Ajouter un GPU dans la section GPU, puis procédez comme suit :

   1. Dans le champ Type de GPU, sélectionnez le type de GPU.
   2. Dans le champ Nombre de GPU, saisissez le nombre de GPU.
   3. Facultatif : Si votre modèle de GPU est compatible avec les postes de travail virtuels NVIDIA RTX (vWS) pour les charges de travail graphiques et que vous prévoyez d'exécuter des charges de travail graphiques lourdes, cochez la case Activer le poste de travail virtuel (NVIDIA GRID).

10. Pour engager des dépenses pour des disques SSD locaux, cliquez sur add Ajouter un SSD dans la section Disques SSD locaux, puis spécifiez le nombre de disques dans le champ Nombre de disques SSD.

11. Pour créer une réservation et l'associer à l'engagement, sélectionnez Créer des réservations dans le champ Réservations, puis procédez comme suit. Répétez cette étape pour chaque nouvelle réservation que vous souhaitez créer et associer.

    1. Cliquez sur Ajouter une réservation. La section Nouvelle réservation s'affiche.
    2. Dans le champ Nom, saisissez le nom de la réservation associée.
    3. Dans le champ Région, sélectionnez la même région que votre engagement.
    4. Dans le champ Zone, sélectionnez la zone dans laquelle vous souhaitez réserver vos ressources.

    5. Dans la section Type de partage, spécifiez le mode de partage de cette réservation de l'une des manières suivantes :

       • Pour créer une réservation à un seul projet, sélectionnez Local.
       • Pour créer une réservation partagée avec plusieurs projets, sélectionnez Partagé. Ensuite, pour spécifier les projets avec lesquels partager cette réservation, cliquez sur add Ajouter des projets, puis sélectionnez les projets de votre choix dans l'organisation du projet actuel.

    6. Dans le champ Utiliser avec une instance de VM, sélectionnez la manière dont vous souhaitez que les VM utilisent votre réservation de l'une des manières suivantes :

       • Pour autoriser les VM ayant des propriétés correspondantes à utiliser automatiquement cette réservation, cliquez sur Utiliser automatiquement une réservation (par défaut).
       • Pour n'utiliser les ressources de cette réservation que lors de la création de VM avec des propriétés correspondantes qui ciblent spécifiquement cette réservation par son nom, cliquez sur Sélectionner une réservation spécifique.

    7. Dans la section Détails de la ressource, procédez comme suit :

       1. Dans le champ Nombre d'instances de VM, saisissez le nombre d'instances de VM que vous souhaitez réserver.

       2. Dans la section Configuration de la machine, spécifiez les propriétés de vos VM réservées de l'une des manières suivantes :

          1. Pour spécifier les propriétés de vos VM à partir d'un modèle d'instance existant, sélectionnez Utiliser un modèle d'instance.

             Dans le champ Modèle d'instance, sélectionnez un modèle d'instance qui spécifie la même série de familles de machines que votre engagement. Si vous sélectionnez un modèle d'instance régional, la région de ce modèle d'instance doit également correspondre à celle spécifiée dans votre engagement.

          2. Pour spécifier manuellement les propriétés de vos VM, sélectionnez Sélectionner le type de machine, puis procédez comme suit :

             1. Sélectionnez la famille de machines qui s'applique à la série de machines que vous avez spécifiée pour l'engagement :

                • Usage général pour les séries de machines à usage général
                • Optimisé pour le calcul pour les séries de machines optimisées pour le calcul
                • À mémoire optimisée pour les séries de machines à mémoire optimisée
                • GPU pour les séries de machines optimisées pour les accélérateurs

             2. Dans le tableau contenant la colonne Série, sélectionnez la même série de machines que celle spécifiée pour l'engagement.

             3. Dans le champ Type de machine, spécifiez un type de machine prédéfini ou personnalisé de l'une des manières suivantes :

                1. Pour choisir un type de machine prédéfini, sélectionnez Prédéfini, puis le type de machine souhaité.
                2. Pour choisir un type de machine personnalisé, sélectionnez Personnalisé, puis spécifiez les cœurs et la mémoire souhaités.

             4. Pour spécifier la configuration minimale de la plate-forme du CPU, des GPU ou des deux, développez le menu expand_more Plate-forme du CPU et GPU et procédez comme suit :

                1. Facultatif : pour spécifier une configuration minimale de plate-forme de processeur, sélectionnez une option dans la liste Plate-forme de processeur.

                2. Facultatif : Pour réserver des GPU, cliquez sur add Ajouter un GPU. Ensuite, dans les champs Type de GPU et Nombre de GPU, sélectionnez le type et le nombre de GPU pour chaque VM.

             5. Pour réserver des disques SSD locaux, procédez comme suit :

                1. Dans le champ Nombre de disques, sélectionnez le nombre de disques SSD locaux que vous souhaitez pour chaque VM.
                2. Dans le champ Type d'interface, sélectionnez l'interface des disques SSD locaux.

    8. Pour terminer la spécification des propriétés de cette réservation, cliquez sur OK.

12. Pour terminer la souscription de votre engagement avec les réservations associées, procédez comme suit :

    1. Cliquez sur Souscrire.
    2. Dans la boîte de dialogue Obtenir une remise sur engagement d'utilisation, si vous acceptez les conditions spécifiques du service, cliquez à nouveau sur Acheter.

gcloud

Pour créer vos réservations associées lors de la souscription de votre engagement, exécutez la commande gcloud compute commitments create.

Selon que vous souhaitez associer une ou plusieurs réservations, exécutez la commande de l'une des manières suivantes:

• Pour créer et associer une réservation unique à votre engagement, définissez les propriétés de la réservation associée en exécutant la commande suivante:

  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
  

• Pour créer et associer plusieurs réservations à votre engagement, définissez les propriétés de la réservation à l'aide d'un fichier YAML, puis spécifiez ce fichier YAML dans la commande que vous utilisez pour souscrire votre engagement. Vous pouvez également utiliser cette approche de fichier YAML pour créer et associer une réservation unique à votre engagement. Pour créer vos réservations associées à l'aide de cette approche, procédez comme suit:

  1. Créez le fichier YAML dans le répertoire actuel et spécifiez la configuration souhaitée pour chaque réservation associée. Par exemple, pour spécifier la configuration d'une réservation partagée avec deux projets qui spécifient les GPU, deux disques SSD locaux et une configuration minimale de la plate-forme du processeur, incluez le texte suivant dans votre fichier 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
     
     

     Pour spécifier la configuration de plusieurs réservations, répétez ces propriétés pour chaque réservation que vous souhaitez créer. Vous pouvez associer le nombre de réservations existantes que vous souhaitez à votre engagement.

  2. Exécutez la commande gcloud compute commitments create en incluant l'option --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
     

Remplacez les éléments suivants par les propriétés correspondantes de l'engagement et des réservations associées:

Compute Engine crée l'engagement avec les réservations associées uniquement s'il y a suffisamment de ressources du type de machine spécifié dans la zone cible et des quotas suffisants au moment de la requête. Si votre achat a bien été effectué, un message de réussite semblable à celui-ci s'affiche:

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

Exemples d'achat d'engagements en créant des réservations à associer

Les exemples de scénarios et de commandes suivants montrent comment souscrire un engagement pour des GPU, des disques SSD locaux ou les deux en créant des réservations à associer à cet engagement.

Exemple 1: Souscrire un engagement pour des GPU en associant une seule nouvelle réservation

Supposons que vous souhaitiez souscrire un engagement commitment-01 dans la région us-central1 qui inclut quatre GPU NVIDIA V100. Vous souhaitez créer une réservation reservation-01 en tant que réservation associée pour ces GPU. Supposons que vous souhaitiez également spécifier Compute Engine pour utiliser ces GPU réservés sur deux VM n1-standard-32 dans la zone us-central1-a. Pour souscrire cet exemple d'engagement avec la réservation associée, exécutez la commande suivante:

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

Exemple 2: Souscrire un engagement pour des GPU sans engagement de processeurs virtuels ni de mémoire

Pour souscrire un engagement et effectuer une réservation pour des GPU et des disques SSD locaux sans acheter de processeurs virtuels ni de mémoire, spécifiez 0 comme valeur pour les quantités de processeurs virtuels et de mémoire. Par exemple, supposons que vous souhaitiez souscrire un engagement commitment-02 pour un seul GPU NVIDIA P4 dans la région us-west2. Vous souhaitez également créer une réservation en tant que réservation associée et spécifier Compute Engine pour utiliser le GPU réservé sur une VM n1-standard-2 dans la zone us-west2-b. Pour souscrire cet exemple d'engagement avec la réservation associée, exécutez la commande suivante:

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

Exemple 3: Souscrire un engagement pour des GPU et des disques SSD locaux en associant plusieurs nouvelles réservations

Supposons que vous souhaitiez souscrire un engagement commitment-03 pour un GPU NVIDIA V100 et deux disques SSD locaux dans la région us-central1. Vous souhaitez également créer et associer deux réservations dans la zone us-central1-a. Dans la première réservation, res-01, vous souhaitez réserver une VM n1-standard-2 avec un GPU. Vous souhaitez faire de res-01 une réservation ciblée, ce qui signifie que vous devez cibler spécifiquement cette réservation par son nom pour utiliser ses VM réservées. Dans la deuxième réservation, res-02, vous souhaitez réserver une VM n1-standard-8 à laquelle deux types de disques SSD locaux sont associés.

Pour souscrire cet exemple d'engagement avec les réservations associées, commencez par créer le fichier YAML avec les propriétés des deux réservations.

- 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

Après avoir créé le fichier YAML, pour terminer la souscription de l'engagement avec les réservations associées, exécutez la commande suivante. Notez que l'exemple d'engagement contient également des ressources de processeur virtuel et de mémoire.

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

Pour créer vos réservations associées lors de la souscription de votre engagement, envoyez une requête POST à la méthode regionCommitments.insert. Dans votre requête, incluez le champ reservations pour définir la liste de toutes les nouvelles réservations que vous souhaitez créer et associer. Vous pouvez associer le nombre de réservations existantes que vous souhaitez à votre engagement.

• Pour créer votre réservation en spécifiant manuellement toutes les propriétés de la VM, incluez le champ instanceProperties et excluez le champ sourceInstanceTemplate.

  Par exemple, pour spécifier manuellement la configuration d'une réservation partagée avec deux projets qui spécifient des GPU, deux disques SSD locaux et une configuration minimale de plate-forme de processeur, envoyez la requête suivante:

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

• Pour créer votre réservation en spécifiant un modèle d'instance, incluez le champ sourceInstanceTemplate et excluez le champ 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"
          }
        }
      }
    }
  ]
  }
  
  

Remplacez les éléments suivants par les propriétés correspondantes de l'engagement et des réservations associées: 

Compute Engine crée l'engagement avec les réservations associées créées uniquement s'il y a suffisamment de ressources du type de machine spécifié dans la zone cible et des quotas suffisants au moment de la requête. Si votre achat a réussi, Compute Engine renvoie un état 200 pour votre requête API REST.

Exemples d'achat d'engagements en créant des réservations à associer

Les exemples de scénarios et de commandes suivants montrent comment souscrire un engagement pour des GPU, des disques SSD locaux ou les deux en créant des réservations à associer à cet engagement.

Exemple 1: Souscrire un engagement pour des GPU en associant une seule nouvelle réservation

Supposons que vous souhaitiez souscrire un engagement commitment-01 dans la région us-central1 qui inclut quatre GPU NVIDIA V100. Vous souhaitez créer une réservation reservation-01 en tant que réservation associée pour ces GPU. Supposons que vous souhaitiez également spécifier Compute Engine pour utiliser ces GPU réservés sur deux VM n1-standard-8 dans la zone us-central1-a. Pour souscrire cet exemple d'engagement avec la réservation associée, envoyez la requête POST suivante:

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

Exemple 2: Souscrire un engagement pour des GPU sans engagement de processeurs virtuels ni de mémoire

Pour souscrire un engagement et effectuer une réservation pour des GPU et des disques SSD locaux sans acheter de processeurs virtuels ni de mémoire, spécifiez 0 comme valeur pour les quantités de processeurs virtuels et de mémoire. Par exemple, supposons que vous souhaitiez souscrire un engagement commitment-02 pour un seul GPU NVIDIA P4 dans la région us-west2. Vous souhaitez également créer une réservation en tant que réservation associée et spécifier Compute Engine pour utiliser le GPU réservé sur une VM n1-standard-2 dans la zone us-west2-b. Pour souscrire cet exemple d'engagement avec la réservation associée, envoyez la requête POST suivante:

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

Exemple 3: Souscrire un engagement pour des GPU et des disques SSD locaux en associant plusieurs nouvelles réservations

Supposons que vous souhaitiez souscrire un engagement commitment-03 pour un GPU NVIDIA V100 et deux disques SSD locaux dans la région us-central1. Vous souhaitez également créer et associer deux réservations dans la zone us-central1-a. Dans la première réservation, res-01, vous souhaitez réserver une VM n1-standard-2 avec un GPU. Vous souhaitez faire de res-01 une réservation ciblée, ce qui signifie que vous devez cibler spécifiquement cette réservation par son nom pour utiliser ses VM réservées. Dans la deuxième réservation, res-02, vous souhaitez réserver une VM n1-standard-8 à laquelle deux types de disques SSD locaux sont associés. Pour souscrire cet exemple d'engagement avec les réservations associées, envoyez la requête POST suivante. Notez que l'exemple d'engagement contient également des ressources de processeur virtuel et de mémoire.

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

Pour remplacer les réservations auxquelles des engagements sont associés, procédez comme suit :

1. Créez un fichier YAML dans le répertoire actuel avec les configurations des réservations associées suivantes :

   • Réservation actuelle que vous souhaitez remplacer.

     Pour afficher les détails de cette réservation, consultez la section Afficher les détails d'une réservation.

   • La nouvelle réservation de remplacement.

   Le contenu du fichier YAML est similaire à ce qui suit :

   - 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
   
   

   Remplacez les éléments suivants par les propriétés correspondantes des réservations actuelles et de remplacement :

   Réservation actuelle

   Pour la réservation actuelle, toutes les propriétés suivantes doivent être exactement les mêmes que lorsque vous avez affiché la réservation. Omettez les champs pour toutes les propriétés que la réservation actuelle n'a pas déjà.

   • CURRENT_RESERVATION_NAME : nom de la réservation associée actuelle.
   • CURRENT_RESERVATION_ZONE : zone de la réservation associée actuelle.
   • CURRENT_RESERVATION_MACHINE_TYPE : type de machine de la réservation associée actuelle.
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS : nombre de GPU réservés dans la réservation associée actuelle.
   • CURRENT_RESERVATION_ACCELERATOR_TYPE : type d'accélérateur réservé dans la réservation associée actuelle.
   • CURRENT_RESERVATION_INTERFACE_1 et CURRENT_RESERVATION_INTERFACE_2 : le type d'interface que les disques SSD locaux utilisent pour chaque VM réservée dans la réservation associée actuelle. Les options valides sont : scsi et nvme. La capacité de chaque disque SSD local est de 375 Go. Répétez le paramètre local_ssd pour tous les disques SSD locaux réservés.
   • CURRENT_RESERVATION_PROJECT_ID : ID du projet contenant l'engagement et la réservation associée. Spécifiez ce champ si votre réservation associée actuelle est partagée entre plusieurs projets clients.
   • CURRENT_RESERVATION_SHARE_SETTING : type de partage pour la réservation actuelle. Spécifiez ce champ avec la valeur projects si votre réservation associée actuelle est partagée entre plusieurs projets clients.
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 et CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2 : ID des projets avec lesquels vous partagez la réservation associée actuelle, par exemple project-1 et project-2.

   Réservation de remplacement

   Pour la réservation de remplacement, définissez les propriétés suivantes comme nécessaire. Assurez-vous de répondre à toutes les exigences lorsque vous spécifiez ces propriétés. Omettez les champs supplémentaires que vous ne souhaitez pas utiliser.

   • REPLACEMENT_RESERVATION_NAME : nom de la nouvelle réservation de remplacement.
   • REPLACEMENT_RESERVATION_ZONE : zone de la nouvelle réservation de remplacement.
   • REPLACEMENT_RESERVATION_NUMBER_OF_VMS : nombre de VM que vous souhaitez réserver dans la nouvelle réservation de remplacement.

   • REPLACEMENT_RESERVATION_MACHINE_TYPE : type de machine que vous souhaitez utiliser pour les VM dans votre nouvelle réservation de remplacement.

     • Pour les types de machines prédéfinis, utilisez le format MACHINE_FAMILY-standard-CPUS (par exemple, n2-standard-4).
     • Pour les types de machines personnalisés, utilisez le format MACHINE_FAMILY-custom-CPUS-MEMORY (par exemple, n2-custom-4-5120). Pour afficher la liste complète des restrictions, lisez les spécifications qui s'appliquent aux types de machines personnalisés.

     Remplacez les éléments suivants :

     • MACHINE_FAMILY : la famille de types de machines. Par exemple, spécifiez n2 pour les VM N2.
     • CPUS : le nombre de processeurs virtuels.
     • MEMORY : la mémoire totale d'une VM réservée. La mémoire doit être un multiple de 256 Mo et doit être exprimée en Mo. Par exemple, pour créer une VM N2 avec 4 vCPU et 5 Go de mémoire (soit 5120 Mo), utilisez n2-custom-4-5120.

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS : le nombre de GPU que vous souhaitez ajouter, par VM, dans la réservation de remplacement.

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE : le type d'accélérateur que vous souhaitez ajouter dans la réservation de remplacement.

   • REPLACEMENT_RESERVATION_INTERFACE_1 et REPLACEMENT_RESERVATION_INTERFACE_2 : type d'interface que les disques SSD locaux doivent utiliser pour chaque VM réservée. Les options valides sont : scsi et nvme. La capacité de chaque disque SSD local est de 375 Go. Répétez le paramètre local_ssd pour chaque disque SSD local que vous souhaitez ajouter. Vous pouvez spécifier jusqu'à 24 disques SSD locaux.

   • REPLACEMENT_RESERVATION_PROJECT_ID : ID du projet contenant l'engagement et la réservation associée. Spécifiez ce champ si vous souhaitez partager votre réservation de remplacement entre plusieurs projets clients.

   • REPLACEMENT_RESERVATION_SHARE_SETTING : type de partage pour la réservation de remplacement. Spécifiez ce champ avec la valeur projects si vous souhaitez partager votre réservation de remplacement entre plusieurs projets clients.

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 et REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2 : ID des projets pouvant partager cette réservation, par exemple project-1,project-2. Vous pouvez inclure jusqu'à 100 projets clients. Ces projets doivent appartenir à la même organisation que le projet propriétaire. N'incluez pas REPLACEMENT_RESERVATION_PROJECT_ID, qui est déjà par défaut autorisé à utiliser cette réservation.

2. Exécutez la commande gcloud beta compute commitments update-reservations et spécifiez le chemin d'accès au fichier YAML à l'aide de l'option --reservations-from-file.

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

   Remplacez les éléments suivants :

   • COMMITMENT_NAME : nom de l'engagement avec la réservation associée.
   • PROJECT_ID : ID du projet de l'engagement avec la réservation associée.
   • REGION : région où se trouve l'engagement.
   • YAML_FILE : chemin d'accès au fichier YAML contenant la configuration des réservations actuelles et de remplacement.

Exemple pour remplacer une réservation associée à un engagement

Pour illustrer cela, cette section montre un exemple d'engagement avec une réservation associée et explique comment remplacer l'exemple de réservation associée.

Exemple d'engagement avec une réservation associée

Par exemple, supposons que vous souhaitiez mettre à jour les réservations associées à l'engagement my-commitment-with-reservations, qui ont été achetées à l'aide de la commande suivante :

  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

Pour cet exemple, supposons que lorsque cette commande a été exécutée, one-reservation.yaml était un fichier du répertoire actuel avec le contenu suivant, qui définit une réservation associée nommée 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

Cet engagement my-commitment-with-reservations et la réservation associée res-1 ont donné lieu aux ressources validées et réservées suivantes :

^*Plus précisément, l'exemple de réservation associé res-1, réserve 4 VM n1-standard-4, chacune avec 1 GPU P100 et deux disques SSD locaux de type d'interface scsi. Le type de machine n1-standard-4 utilise 4 processeurs virtuels et 15 Go pour chaque VM.

Remplacer l'exemple de réservation associée

Supposons que vous souhaitiez remplacer la réservation associée res-1 par une nouvelle réservation associée res-2 et modifier les ressources réservées comme suit :

^*Plus précisément, l'exemple de réservation associé res-1, réserve 4 VM n1-standard-4, chacune avec 1 GPU P100 et deux disques SSD locaux de type d'interface scsi. Le type de machine n1-standard-4 utilise 4 processeurs virtuels et 15 Go pour chaque VM.

^† Plus précisément, la réservation associée de remplacement définit res-2, qui réserve deux VM n1-standard-8, chacune avec 1 GPU P100 et 4 disques SSD locaux avec le type d'interface scsi. En outre, res-2 est partagé avec deux autres projets, project-1 et project-2, et appartient au projet actuel, my-project. Le type de machine n1-standard-8 utilise 8 processeurs virtuels et 30 Go pour chaque VM.

Pour remplacer la réservation associée res-1 par res-2 pour l'engagement my-commitment-with-reservations, procédez comme suit :

1. Créez un fichier nommé two-reservations.yaml dans le répertoire actuel qui contient le contenu suivant :

   - 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. Exécutez la commande ci-dessous.

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

REST

Pour remplacer des réservations auxquelles des engagements sont associés, envoyez une requête POST à l'aide de la méthode 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"
          }
         }
      }
    }
  ]
}

Remplacez les éléments suivants par les propriétés correspondantes de l'engagement, de la réservation actuelle et de la réservation de remplacement :

Exemple pour remplacer une réservation associée à un engagement

Pour illustrer cela, cette section montre un exemple d'engagement avec une réservation associée et explique comment remplacer l'exemple de réservation associée.

Exemple d'engagement avec une réservation associée

Par exemple, supposons que vous souhaitiez remplacer la réservation associée res-1 pour l'engagement my-commitment-with-reservations, acheté en effectuant la requête POST suivante :

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

Cet engagement my-commitment-with-reservations et la réservation associée res-1 ont donné lieu aux ressources validées et réservées suivantes :

^*Plus précisément, l'exemple de réservation associé res-1, réserve 4 VM n1-standard-4, chacune avec 1 GPU P100 et deux disques SSD locaux de type d'interface scsi. Le type de machine n1-standard-4 utilise 4 processeurs virtuels et 15 Go pour chaque VM.

Remplacer l'exemple de réservation associée

Supposons que vous souhaitiez remplacer la réservation associée res-1 par une nouvelle réservation associée res-2 et modifier les ressources réservées comme suit :

^*Plus précisément, l'exemple de réservation associé res-1, réserve 4 VM n1-standard-4, chacune avec 1 GPU P100 et deux disques SSD locaux de type d'interface scsi. Le type de machine n1-standard-4 utilise 4 processeurs virtuels et 15 Go pour chaque VM.

^† Plus précisément, la réservation associée de remplacement définit res-2, qui réserve deux VM n1-standard-8, chacune avec 1 GPU P100 et 4 disques SSD locaux avec le type d'interface scsi. En outre, res-2 est partagé avec deux autres projets, project-1 et project-2, et appartient au projet actuel, my-project. Le type de machine n1-standard-8 utilise 8 processeurs virtuels et 30 Go pour chaque VM.

Pour remplacer la réservation associée res-1 par res-2 pour l'engagement my-commitment-with-reservations, envoyez la requête POST suivante à l'aide de la méthode 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"
      }
    ]
  }