Cette page a été traduite par l'API Cloud Translation.

Prolongez la durée d'engagement

Ce document fournit des informations sur la prolongation de la durée de vos engagements basés sur les ressources matérielles Compute Engine au-delà des options prédéfinies d'un an et de trois ans.

Les extensions de durée vous permettent de prolonger la durée d'un engagement au-delà des options prédéfinies d'un an ou de trois ans, et de spécifier une durée personnalisée de votre choix (par exemple, deux, trois ans et demi ou cinq ans et demi). En prolongeant la durée de votre engagement, vous pouvez l'adapter à vos besoins d'utilisation des ressources et continuer à recevoir les remises sur engagement d'utilisation (CUD) qui en résultent pour cette période plus longue et personnalisée. Vous pouvez prolonger la durée des engagements d'un an et de trois ans comme suit:

Engagements d'un an: vous pouvez spécifier des durées d'engagement personnalisées supérieures à un an et inférieures à trois ans.
Engagements de trois ans: vous pouvez spécifier des durées d'engagement personnalisées supérieures à trois ans et inférieures à six ans.

Pour découvrir d'autres façons de maintenir vos engagements actifs plus longtemps, consultez les alternatives suivantes:

Si vous avez un engagement d'un an et que vous souhaitez un pourcentage de remise différent en plus d'une durée plus longue, mettez à niveau la durée de votre engagement.
Si vous souhaitez prolonger la durée de votre engagement d'une ou plusieurs périodes complètes, activez le renouvellement automatique de votre engagement.

Fonctionnement de la prolongation de la durée d'engagement

Vous pouvez prolonger la durée de votre engagement et définir une durée personnalisée en spécifiant une date de fin future de votre choix pour la durée de cet engagement. Votre engagement devient alors un engagement à durée personnalisée. Pour les engagements d'un an, la date de fin personnalisée peut être comprise entre un et trois ans (mais pas exactement trois ans) après la date de début de la période en cours. Pour les engagements de trois ans, la date de fin personnalisée peut être comprise entre trois et six ans (mais pas exactement six ans) après la date de début de la période en cours.

Vous pouvez prolonger la durée d'engagement pour les engagements nouveaux et existants comme suit:

Nouveaux engagements: vous pouvez spécifier une date de fin personnalisée lorsque vous souscrivez l'engagement.
Engagements existants: une fois votre engagement activé, vous pouvez spécifier ou modifier la date de fin personnalisée en mettant à jour les propriétés de l'engagement.

Une fois que vous avez envoyé une demande de prolongation de la durée de votre engagement, les modifications prennent effet le lendemain à minuit (heure du Pacifique des États-Unis et du Canada, UTC-8 ou UTC-7 pendant l'heure d'été). Votre engagement reste actif jusqu'à la nouvelle date de fin personnalisée, et sa durée est ajustée en conséquence. L'allongement de la durée de votre engagement n'a pas d'incidence sur les autres propriétés de l'engagement:

Nom
Date de début
Région
Projet
Type d'engagement
Forfait
État du renouvellement automatique
Ressources engagées

Prolonger la durée de votre engagement n'a pas d'incidence sur le pourcentage de remise sur l'utilisation que vous recevez en échange de cet engagement.

Toutes les réservations associées à votre engagement continuent d'exister pendant toute la durée de vie de votre durée prolongée, sauf si vous les remplacez manuellement.

Période d'éligibilité à l'extension de la période

Une fois la période d'engagement commencée, vous disposez d'un délai limité pour demander une prolongation de la période d'engagement. Cette période est appelée "fenêtre d'éligibilité à l'extension de la période".

Pour les engagements de durées prédéfinies et personnalisées, la période d'éligibilité à l'extension de la durée dépend de l'opération la plus récente que vous avez effectuée sur un engagement et se comporte comme suit:

Engagements nouvellement souscrits: pour les engagements d'un an, la période d'éligibilité reste ouverte jusqu'à quatre mois après l'activation de l'engagement. Pour les engagements de trois ans, la période d'éligibilité reste ouverte jusqu'à un an après l'activation de l'engagement.
Engagements renouvelés automatiquement: si votre engagement est renouvelé automatiquement pour une nouvelle période, la période d'éligibilité est actualisée au début de la période renouvelée. Pour les engagements d'un an, la période d'éligibilité reste ouverte jusqu'à quatre mois à compter du début de la période renouvelée. Pour les engagements de trois ans, la période d'éligibilité reste ouverte jusqu'à un an à compter du début de la période renouvelée.
Engagements fusionnés: si vous fusionnez des engagements dont les périodes d'éligibilité sont différentes, Compute Engine utilise la période d'éligibilité qui se termine le plus tôt pour l'engagement fusionné.
Engagements fractionnés: lorsque vous fractionnez un engagement, la période d'éligibilité reste la même pour l'engagement source redimensionné et le nouvel engagement fractionné.
Engagements mis à niveau: lorsque vous passez d'un engagement d'un an à un engagement de trois ans, Compute Engine met également à jour la période d'éligibilité de l'engagement. La période d'attribution mise à jour reste ouverte jusqu'à un an à compter du début de la période en cours.

Par exemple, supposons que la date de début de votre engagement d'un an soit le 1er janvier 2024. La période d'éligibilité de votre abonnement d'un an d'origine reste ouverte jusqu'au 1er mai 2024. Supposons que vous ayez ensuite converti cet engagement en engagement de trois ans le 1er avril 2024. Après la mise à niveau de la durée, la période d'éligibilité de votre engagement reste ouverte jusqu'au 1er janvier 2025.

Effectuer plusieurs extensions de durée

Vous pouvez prolonger la durée de votre engagement autant de fois que vous le souhaitez pendant la période d'éligibilité à la prolongation. Chaque jour, pour chaque engagement actif, vous pouvez envoyer plusieurs demandes de prolongation de la durée jusqu'à minuit (heure du Pacifique des États-Unis et du Canada, UTC-8 ou UTC-7) du jour suivant, à condition de spécifier une date de fin ultérieure à chaque fois. Toutefois, Google vous recommande de limiter le nombre de demandes d'extension de durée que vous envoyez pour un même engagement un même jour.

Une fois que la prolongation de la période d'engagement pour une date de fin spécifique est appliquée et qu'une nouvelle date de fin personnalisée est définie pour votre engagement, vous ne pouvez plus annuler la prolongation ni réduire la durée de votre engagement. Vous ne pouvez effectuer les opérations d'extension suivantes que pour les dates de fin ultérieures à la date de fin la plus récente.

Impact des demandes de mise à jour d'engagement en attente

Pour les engagements existants et actifs pour lesquels une demande de modification est déjà en attente, vous ne pouvez envoyer une nouvelle demande de prolongation que si la demande en attente concerne également une prolongation. Si des demandes de mise à jour sont en attente pour les engagements (fusion, fractionnement, mise à niveau des conditions ou mise à jour du paramètre de renouvellement automatique, par exemple), vous devez attendre que les opérations en attente soient terminées et que les mises à jour prennent effet pour demander des extensions de durée. Après minuit le jour suivant, lorsque les mises à jour prendront effet, vous pourrez demander une prolongation de la période pour cet engagement.

Implications en termes de tarification

Vos frais d'engagement correspondent à la somme des tarifs réduits de toutes vos ressources comprises dans cet engagement. Lorsque vous prolongez la durée de votre engagement, les prix réduits de vos ressources restent les mêmes pendant toute la durée de votre engagement personnalisé, même si les tarifs à la demande changent. Pour en savoir plus sur les tarifs des ressources, consultez la page Tarifs de Compute Engine.

À savoir sur les quotas

Pour spécifier une date de fin personnalisée lors de l'achat d'un engagement, vous devez disposer d'un quota suffisant pour l'engagement et les ressources comprises dans cet engagement. En règle générale, vous n'avez pas besoin de demander de quota supplémentaire pour spécifier une date de fin personnalisée pour un engagement existant.

Impact de la prolongation de la durée d'engagement sur les futures opérations d'engagement

Si la durée de votre engagement est personnalisée, effectuer des opérations de gestion des engagements ultérieures sur votre engagement à durée personnalisée peut avoir une incidence sur sa date de fin et sa période d'éligibilité personnalisées. Les sections suivantes expliquent le comportement d'un engagement à terme personnalisé lors d'autres opérations d'engagement:

Engagements avec renouvellement automatique des conditions personnalisées

La durée de renouvellement d'un engagement renouvelé automatiquement correspond toujours à la durée prédéfinie définie par le forfait de l'engagement, qui est d'un an ou de trois ans. Vous bénéficiez également du même pourcentage de remise. Même si votre engagement a une durée personnalisée, Compute Engine ne le renouvelle que pour sa durée prédéfinie de un ou trois ans. Le renouvellement automatique d'un engagement de durée personnalisée ne sera pas pour une autre période de cette durée personnalisée. Pour obtenir des exemples, consultez les éléments suivants:

Un engagement avec une durée personnalisée de 1,5 an ne sera renouvelé que pour une année supplémentaire.
Un engagement avec une durée personnalisée de 5,5 ans ne sera renouvelé que pour trois ans supplémentaires.

Si vous souhaitez qu'un engagement de durée personnalisée reste actif pendant une période plus longue que la durée renouvelée, vous pouvez demander une autre prolongation de la durée après son renouvellement. La période d'éligibilité à l'extension de votre abonnement est également actualisée au début de votre abonnement renouvelé. Pour un engagement d'un an, la période d'éligibilité pendant la période de renouvellement reste ouverte jusqu'à quatre mois après le renouvellement. Pour les engagements de trois ans, cette période reste ouverte jusqu'à un an après le renouvellement.

Par exemple, supposons que la date de début de votre engagement d'un an soit le 1er janvier 2024. Vous prolongez la durée de cet engagement et spécifiez une date de fin personnalisée au 30 juin 2025. Si vous avez également activé le renouvellement automatique de votre engagement, il sera renouvelé pour une autre période d'un an le 1er juillet 2025. La date de fin de la période de renouvellement est fixée au 30 juin 2026. La période d'éligibilité à la prolongation de la période de validité de ce renouvellement reste ouverte jusqu'au 1er novembre 2025.

Pour en savoir plus sur le renouvellement automatique des engagements, consultez la section Renouveler automatiquement des engagements.

Fusionner des engagements avec des conditions personnalisées

La fusion d'engagements dont la durée est personnalisée fonctionne de la même manière que les engagements dont la durée est prédéfinie. L'engagement fusionné hérite des propriétés suivantes:

Date de fin la plus éloignée dans le futur parmi les engagements sources, que la date de fin soit personnalisée ou non.
Période d'éligibilité qui se termine le plus tôt parmi les engagements sources.

Par exemple, supposons que vous souhaitiez fusionner deux engagements personnalisés d'un an. La première obligation a une date de début fixée au 1er janvier 2024 et une date de fin personnalisée fixée au 30 juin 2025. La période d'éligibilité au premier engagement reste ouverte jusqu'au 1er mai 2024. La date de début du deuxième engagement est le 1er février 2024 et la date de fin personnalisée est le 30 juillet 2025. La période d'éligibilité au deuxième engagement reste ouverte jusqu'au 1er juin 2024. Si vous fusionnez ces engagements le 1er avril 2024, la date de fin de l'engagement fusionné sera le 30 juillet 2025. La période d'éligibilité de l'engagement fusionné reste ouverte jusqu'au 1er mai 2024.

Pour en savoir plus sur la fusion d'engagements, consultez la section Fusionner des engagements.

Fractionner les engagements de durée personnalisée

Le fractionnement des engagements dont la durée est personnalisée fonctionne de la même manière que les engagements dont la durée est prédéfinie. L'engagement source redimensionné et les nouveaux engagements fractionnés conservent la même date de fin personnalisée et la même période d'éligibilité à l'extension de la période.

Par exemple, supposons que la date de début de votre engagement d'un an soit le 1er janvier 2024 et que la date de fin personnalisée soit le 30 juin 2025. La période d'éligibilité de votre engagement reste ouverte jusqu'au 1er mai 2024. Supposons que vous ayez divisé cet engagement en deux engagements distincts le 1er mars 2024. Les engagements nouvellement dissociés héritent de la date de fin personnalisée du 30 juin 2025, et leurs périodes d'éligibilité restent ouvertes jusqu'au 1er mai 2024.

Pour en savoir plus sur la division des engagements, consultez la section Diviser des engagements.

Mettre à niveau les engagements de durée personnalisée

La mise à niveau des engagements d'un an dont la durée est personnalisée fonctionne de la même manière que les engagements dont la durée est prédéfinie. Après la mise à niveau, Compute Engine repousse la date de fin de la période en cours de l'engagement de deux ans.

Par exemple, supposons que votre engagement d'un an ait une date de début fixée au 1er janvier 2024 et une date de fin personnalisée fixée au 30 juin 2025. La période d'éligibilité pour votre abonnement d'un an d'origine reste ouverte jusqu'au 1er mai 2024. Supposons que vous ayez ensuite converti cet engagement en engagement de trois ans le 1er avril 2024. Après la mise à niveau de la période, votre engagement devient un engagement de trois ans avec une date de fin fixée au 30 juin 2027. La période d'éligibilité de l'engagement est désormais ouverte jusqu'au 1er janvier 2025. Vous commencez également à recevoir le pourcentage de remise sur engagement d'utilisation applicable à l'engagement de trois ans.

Pour en savoir plus sur la mise à niveau des engagements, consultez la section Mettre à niveau la durée d'engagement.

Limites

Les limites suivantes s'appliquent aux extensions de durée des engagements basés sur les ressources:

Vous ne pouvez prolonger la durée que des engagements de ressources matérielles.
Vous ne pouvez pas prolonger la durée des engagements inactifs ou expirés.
Vous ne pouvez pas prolonger la durée d'un engagement de trois ans de trois ans complets. Envisagez plutôt d'activer le renouvellement automatique de votre engagement.
Vous ne pouvez renouveler les engagements à durée personnalisée que pour la durée prédéfinie définie par leurs forfaits d'engagement, soit un ou trois ans.
Pour les engagements actifs existants pour lesquels une demande de modification de l'engagement est déjà en attente, vous ne pouvez envoyer une nouvelle demande de prolongation de la durée que si la demande en attente concerne également une prolongation de la durée. Si les engagements comportent d'autres demandes de mise à jour en attente (fusion, fractionnement, mise à niveau des conditions ou mise à jour des paramètres de renouvellement automatique, par exemple), vous devez attendre minuit le jour suivant pour que les opérations en attente soient finalisées et que les mises à jour prennent effet.

Conditions requises

Pour prolonger la durée d'un engagement, vous devez remplir les conditions suivantes:

La demande d'extension de la période doit être envoyée pendant la période d'éligibilité à l'extension de la période de l'engagement.
Pour les engagements d'un an, la date de fin personnalisée doit se situer entre un et trois ans (mais pas exactement trois ans) à compter de la date de début de la période en cours.
Pour les engagements de trois ans, la date de fin personnalisée doit se situer entre trois et six ans (mais pas exactement six ans) à compter de la date de début de la période en cours.
Vous ne devez pas avoir d'autres opérations de fusion, de fractionnement, de mise à niveau ou de renouvellement en cours ou en attente pour cet engagement.

Bonnes pratiques

Google vous recommande de suivre ces bonnes pratiques lorsque vous prolongez la durée d'un engagement:

Avant de demander une extension de durée, attendez que toutes les autres opérations d'engagement en attente soient terminées et que les mises à jour prennent effet.
Réduisez le nombre de demandes de prolongation de délai que vous envoyez pour un même engagement le même jour.

Prolonger la durée d'engagement lors de l'achat d'un engagement

Lorsque vous souscrivez un engagement, vous pouvez spécifier une date de fin personnalisée pour prolonger la durée prédéfinie de un ou trois ans.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

compute.commitments.create sur le projet ou l'organisation.

Pour prolonger la durée d'un engagement lors de son achat, utilisez l'une des options suivantes:

Console

Avant de souscrire votre engagement, dans 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.

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

Accéder aux remises sur engagement d'utilisation

La page Liste des engagements s'ouvre et affiche l'onglet Engagements matériels.
Cliquez sur Souscrire un engagement.

La page Obtenir une remise sur engagement d'utilisation s'ouvre et affiche l'onglet Matériel.
Dans le champ Nom, saisissez le nom de votre engagement.
Dans le champ Région, sélectionnez la région dans laquelle vous souhaitez engager des dépenses pour l'achat de ressources Compute Engine.
Dans le champ Type d'engagement, sélectionnez la série de familles de machines de vos ressources comprises dans cet engagement. Les options de type d'engagement suivantes sont disponibles:
- 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
- Optimisé pour le calcul (H3) pour les ressources de type de machine H3
- 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 (C4) pour les ressources de type de machine C4
- C4A à usage général pour les ressources de type de machine C4A
- Usage général (E2) pour les ressources de type de machine E2
- 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
- Usage général (N4) pour les ressources de type de machine N4
- Usage général (T2D) pour les ressources de type de machine Tau T2D
- Optimisé pour les graphiques (G2) pour les ressources de type de machine G2
- Mémoire optimisée M1/M2 pour les ressources de type de machine M1 et M2
- 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
Dans la section Durée, procédez comme suit:
1. Pour spécifier la durée prédéfinie de votre engagement, sélectionnez 1 an ou 3 ans.
2. Pour spécifier une date de fin personnalisée pour votre engagement, activez l'option Prolonger la date de fin, puis, dans le champ Date, indiquez une date de fin personnalisée.
Dans le champ Cœurs, saisissez le nombre de processeurs virtuels que vous souhaitez acheter.
Dans le champ Mémoire, saisissez la quantité de mémoire (en Go) que vous souhaitez acheter.
Pour vous engager à acheter des GPU, cliquez sur 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).
Pour vous engager à acheter des disques SSD locaux, dans la section Disques SSD locaux, cliquez sur Ajouter un SSD, puis spécifiez le nombre de disques dans le champ Nombre de disques SSD.
Si vous avez spécifié des GPU ou des disques SSD locaux dans votre engagement, associez des réservations correspondantes pour ces ressources de l'une des manières suivantes. Répétez cette étape pour chaque nouvelle réservation que vous souhaitez associer.
1. Pour associer une ou plusieurs réservations existantes à l'engagement, sélectionnez Associer des réservations existantes dans le champ Réservations, puis suivez la procédure décrite dans la section Associer des réservations existantes.
2. Pour créer une réservation et l'associer à l'engagement, sélectionnez Créer des réservations dans le champ Réservations, puis suivez les étapes indiquées dans la section Créer des réservations à associer.
Pour finaliser l'achat de votre engagement, 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 avec une durée personnalisée et prolongée, exécutez la commande gcloud compute commitments create et incluez l'option --custom-end-time.

Par exemple, pour souscrire un engagement pour des processeurs virtuels, de la mémoire ou les deux, utilisez la commande suivante:

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=COMMITMENT_PLAN \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --custom-end-time=CUSTOM_END_DATE

Remplacez les éléments suivants :

COMMITMENT_NAME: nom de l'engagement
REGION: région de l'engagement et région dans laquelle vous souhaitez vous engager à acheter des ressources Compute Engine.
PROJECT_ID : ID du projet
COMMITMENT_PLAN: durée minimale prédéfinie pour laquelle vous souhaitez vous engager à acheter des ressources. Spécifiez une des valeurs suivantes :
- Pour un engagement d'un an: 12-month
- Pour un engagement de trois ans: 36-month.
COMMITMENT_TYPE: série de machines pour laquelle vous souhaitez vous engager à acheter des ressources. Les options suivantes sont disponibles:
- 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
- compute-optimized-h3 pour les ressources de type de machine H3
- general-purpose pour les ressources de type de machine N1
- general-purpose-c4 pour les ressources de type de machine C4
- general-purpose-c4a pour les ressources de type de machine C4A
- general-purpose-e2 pour les ressources de type de machine E2
- general-purpose-n2 pour les ressources de type de machine N2
- general-purpose-n2d pour les ressources de type de machine N2D
- general-purpose-n4 pour les ressources de type de machine N4
- general-purpose-t2d pour les ressources de type de machine Tau T2D
- graphics-optimized pour les ressources de type de machine G2
- memory-optimized pour les ressources de type de machine M1 ou M2
- memory-optimized-m3 pour les ressources de type de machine M3
- storage-optimized-z3 pour les ressources de type de machine Z3
Si vous ne spécifiez pas l'option --type, Compute Engine utilise general-purpose comme valeur par défaut.
NUMBER_VCPUS: nombre de processeurs virtuels que vous souhaitez acheter.
MEMORY: quantité de mémoire en Mo ou en Go que vous souhaitez vous engager à acheter (par exemple, 1000MB ou 100GB). Si vous ne spécifiez pas d'unité, Compute Engine utilise GB comme unité par défaut. Vous pouvez spécifier cette valeur par incréments de 0,25 Go.
CUSTOM_END_DATE: date de fin personnalisée de 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.

Pour connaître la syntaxe détaillée permettant de prolonger la durée de l'engagement lors de la souscription d'un engagement pour des GPU, des disques SSD locaux ou les deux, consultez la section Souscrire des engagements avec des réservations associées.

Prenons l'exemple d'un engagement d'un an appelé example-commitment pour quatre processeurs virtuels N1 et 9 Go de mémoire dans la région us-central1. Supposons que vous souhaitiez souscrire cet engagement le 1er janvier 2024 et que vous souhaitiez une durée personnalisée qui se termine le 30 juin 2025. Pour souscrire cet engagement, exécutez la commande suivante:

gcloud compute commitments create example-commitment \
    --region=us-central1 \
    --project=my-project
    --plan=12-month \
    --type=general-purpose
    --resources=memory=9GB,vcpu=4 \
    --custom-end-time=2025-07-01

REST

Pour souscrire un engagement avec une durée personnalisée et prolongée, envoyez une requête POST à la méthode regionCommitments.insert. Dans le corps de la requête, incluez le champ customEndTimestamp.

Par exemple, pour souscrire un engagement pour des processeurs virtuels, de la mémoire ou les deux, utilisez le corps de requête POST suivant:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
    "name": "COMMITMENT_NAME",
    "plan": "COMMITMENT_PLAN",
    "type": "COMMITMENT_TYPE",
    "resources":
    [
        {
            "amount": "NUMBER_VCPUS",
            "type": "VCPU"
        },
        {
            "amount": "MEMORY",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
}

Remplacez les éléments suivants :

COMMITMENT_NAME: nom de l'engagement
REGION: région de l'engagement et région dans laquelle vous souhaitez vous engager à acheter des ressources Compute Engine.
PROJECT_ID : ID du projet
COMMITMENT_PLAN: durée minimale prédéfinie pour laquelle vous souhaitez vous engager à acheter des ressources. Spécifiez l'une des valeurs suivantes:
- Pour un engagement d'un an: TWELVE_MONTH
- Pour un engagement de trois ans: THIRTY_SIX_MONTH.
COMMITMENT_TYPE: série de machines pour laquelle vous souhaitez vous engager à acheter des ressources. Les options suivantes sont disponibles:
- 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
- COMPUTE_OPTIMIZED_H3 pour les ressources de type de machine H3
- GENERAL_PURPOSE pour les ressources de type de machine N1
- GENERAL_PURPOSE_C4 pour les ressources de type de machine C4
- GENERAL_PURPOSE_C4A pour les ressources de type de machine C4A
- GENERAL_PURPOSE_E2 pour les ressources de type de machine E2
- GENERAL_PURPOSE_N2 pour les ressources de type de machine N2
- GENERAL_PURPOSE_N2D pour les ressources de type de machine N2D
- GENERAL_PURPOSE_N4 pour les ressources de type de machine N4
- GENERAL_PURPOSE_T2D pour les ressources de type de machine Tau T2D
- GRAPHICS_OPTIMIZED pour les ressources de type de machine G2
- MEMORY_OPTIMIZED pour les ressources de type de machine M1 ou M2
- MEMORY_OPTIMIZED_M3 pour les ressources de type de machine M3
- STORAGE_OPTIMIZED_Z3 pour les ressources de type de machine Z3
NUMBER_VCPUS: nombre de processeurs virtuels que vous souhaitez acheter.
MEMORY: quantité de mémoire en Mo que vous souhaitez vous engager à acheter (par exemple, 10240MB). Vous pouvez spécifier cette valeur par incréments de 256 Mo.
CUSTOM_END_DATE: date de fin personnalisée de 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 une des valeurs suivantes :
- Pendant l'heure d'été: 07:00:00
- À d'autres moments: 08:00:00

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments
{
    "name": "example-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE",
    "resources":
    [
        {
            "amount": "4",
            "type": "VCPU"
        },
        {
            "amount": "9216",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "2025-07-01T07:00:00Z",
}

Prolonger la durée d'un engagement existant

Vous pouvez prolonger la durée de l'engagement actif existant en mettant à jour ses propriétés pour spécifier ou mettre à jour la date de fin personnalisée.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

compute.commitments.update sur le projet ou l'organisation.

Pour prolonger la durée d'un engagement existant, utilisez l'une des options suivantes:

Console

Avant de lancer l'opération d'extension de la durée, dans la console Google Cloud, sélectionnez le projet dans lequel vous souhaitez prolonger la durée de votre engagement.

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

Accéder aux remises sur engagement d'utilisation

La page Liste des engagements s'ouvre et affiche l'onglet Engagements matériels.
Pour lancer l'opération de prolongation de la durée d'un engagement, sélectionnez un engagement actif dans l'onglet Engagements matériels, puis cliquez sur Prolonger.

Vous pouvez également procéder comme suit:
1. Dans l'onglet Engagements matériels de la page Liste des engagements, cliquez sur le nom de l'engagement actif que vous souhaitez prolonger.
2. Sur la page Détails de l'engagement matériel de l'engagement sélectionné, cliquez sur Prolonger.
Le volet Prolonger s'affiche pour l'engagement sélectionné.
Pour effectuer l'opération d'extension de la période, dans le volet Extend (Prolonger) de l'engagement, procédez comme suit:
1. Consultez les détails de votre engagement.
2. Dans le champ Sélectionner une date de fin, spécifiez une date de fin personnalisée pour votre engagement.
3. Dans la section Calendrier de l'engagement, examinez le champ Nouvelle date de fin.
4. Pour confirmer la demande d'extension du terme, cliquez sur Prolonger.

gcloud

Pour prolonger la durée d'un engagement actif existant, exécutez la commande gcloud compute commitments update et incluez l'option --custom-end-time.

gcloud compute commitments update COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --custom-end-time=CUSTOM_END_DATE

Remplacez les éléments suivants :

COMMITMENT_NAME: nom de l'engagement
PROJECT_ID : ID du projet
REGION: région de l'engagement et région dans laquelle vous souhaitez vous engager à acheter des ressources Compute Engine.
CUSTOM_END_DATE: date de fin personnalisée que vous souhaitez pour votre période, au format YYYY-MM-DD, où YYYY correspond à l'année, MM au mois et DD au jour. Par exemple, pour spécifier une date de fin personnalisée le 20 avril 2024, formatez-la sous la forme 2024-04-20.

Prenons l'exemple de l'engagement personnalisé d'un an, example-commitment, souscrit pour quatre processeurs virtuels N1 et neuf Go de mémoire dans la région us-central1. Cet engagement a été souscrit le 1er janvier 2024 et expire le 30 juin 2025. Pour prolonger la durée de validité jusqu'au 30 juin 2026, exécutez la commande suivante:

gcloud compute commitments update example-commitment \
    --region=us-central1 \
    --project=my-project \
    --custom-end-time=2026-07-01

REST

Pour prolonger la durée d'un engagement actif existant, envoyez une requête PATCH à la méthode regionCommitments.update. Dans le corps de la requête, incluez le champ customEndTimestamp.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
{
    "name": "COMMITMENT_NAME",
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
}

Remplacez les éléments suivants :

COMMITMENT_NAME: nom de l'engagement
REGION: région de l'engagement et région dans laquelle vous souhaitez vous engager à acheter des ressources Compute Engine.
PROJECT_ID : ID du projet
CUSTOM_END_DATE: date de fin personnalisée que vous souhaitez pour votre période, au format YYYY-MM-DD, où YYYY correspond à l'année, MM au mois et DD au jour. Par exemple, pour spécifier une date de fin personnalisée le 20 avril 2024, formatez-la sous la forme 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 une des valeurs suivantes :
- Pendant l'heure d'été: 07:00:00
- À d'autres moments: 08:00:00

PATCH https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments/example-commitment
{
    "name": "example-commitment",
    "customEndTimestamp": "2026-07-01T07:00:00Z",
}

Étape suivante

Découvrez comment renouveler automatiquement les engagements basés sur les ressources.
Découvrez comment prolonger la durée des engagements basés sur les ressources.
Découvrez comment analyser l'efficacité de vos remises sur engagement d'utilisation basées sur les ressources.