Ce document explique comment modifier une réservation existante.
Si vous souhaitez modifier une réservation partagée, vous devez utiliser le projet propriétaire.
Si vous souhaitez modifier une réservation associée à un engagement, consultez plutôt la section Remplacer les réservations associées à des engagements.
Avant de commencer
- Consultez les exigences et restrictions applicables aux réservations.
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud.
Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :
Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
Console
Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Définissez une région et une zone par défaut.
REST
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
Rôles requis
Pour obtenir les autorisations nécessaires pour afficher des réservations partagées, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Compute (roles/compute.admin
) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Ce rôle prédéfini contient les autorisations requises pour modifier les réservations. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour modifier des réservations :
-
Pour modifier l'option de suppression automatique dans une réservation ou les projets clients dans une réservation partagée :
compute.reservations.update
sur le projet -
Pour modifier le nombre de VM dans une réservation :
compute.reservations.resize
sur le projet
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Modifier les réservations
Pour modifier directement une réservation existante, vous pouvez effectuer l'une ou plusieurs des opérations suivantes :
Modifier la suppression automatique d'une réservation
Vous pouvez activer l'option de suppression automatique pour une réservation, modifier la date et l'heure de suppression automatique d'une réservation par Compute Engine, ou désactiver la suppression automatique de la réservation.
Modifier les projets clients dans une réservation partagée
Vous pouvez ajouter ou supprimer les projets clients pouvant consommer une réservation partagée.
Modifier le nombre de VM réservées dans une réservation
Vous pouvez augmenter ou diminuer le nombre d'instances de machines virtuelles (VM) réservées dans une réservation.
Si vous souhaitez modifier des propriétés non mentionnées dans cette liste, reportez-vous à la section Modifier d'autres propriétés d'une réservation du présent document.
Modifier la suppression automatique d'une réservation
Vous pouvez modifier la date à laquelle Compute Engine supprime automatiquement une réservation existante en effectuant l'une des opérations suivantes :
Activez l'option de suppression automatique ou modifiez le moment où la réservation est supprimée automatiquement.
Désactivez l'option de suppression automatique.
Pour modifier la suppression automatique d'une réservation, sélectionnez l'une des options suivantes :
Console
Pour modifier la suppression automatique d'une réservation, procédez comme suit :
Dans la console Google Cloud, accédez à la page Réservations.
Dans la colonne Nom, cliquez sur le nom de la réservation que vous souhaitez modifier.
La page d'informations de la réservation sélectionnée s'affiche.
Sur la ligne Heure de suppression automatique, cliquez sur
Modifier l'heure de suppression automatique.Dans le volet Mettre à jour la réservation, effectuez l'une des opérations suivantes :
Pour supprimer la réservation à une date et une heure spécifiques, procédez comme suit :
Si l'option de suppression automatique n'est pas déjà activée, cliquez sur le bouton Activer la suppression automatique pour l'activer.
Dans le champ Heure de suppression automatique, saisissez une date et une heure auxquelles Compute Engine supprime automatiquement la réservation.
Sinon, cliquez sur le bouton Activer la suppression automatique pour la désactiver.
Cliquez sur Submit (Envoyer).
La modification de votre réservation peut prendre quelques secondes.
gcloud
Lorsque vous activez l'option de suppression automatique dans une réservation, vous pouvez spécifier une date et une heure auxquelles la réservation doit être supprimée, ou spécifier une durée après laquelle la réservation doit être supprimée.
Pour activer la suppression automatique ou modifier le moment où la réservation doit être supprimée, effectuez l'une des opérations suivantes :
Pour supprimer la réservation à une date et une heure spécifiques, utilisez la commande
gcloud beta compute reservations update
avec l'option--delete-at-time
.gcloud beta compute reservations update RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --project=PROJECT_ID \ --zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME
: nom d'une réservation existante.DELETE_AT_TIME
: date et heure au format de code temporel RFC 3339 comme suit :YYYY-MM-DDTHH:MM:SSOFFSET
Remplacez les éléments suivants :
YYYY-MM-DD
: date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-
).HH:MM:SS
: heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 chiffres, séparés par des signes deux-points (:
).OFFSET
: fuseau horaire mis en forme en tant que décalage par rapport au temps universel coordonné (UTC). Par exemple, pour utiliser l'heure normale du Pacifique (PST), spécifiez-08:00
. Sinon, pour n'utiliser aucun décalage, spécifiezZ
.
PROJECT_ID
: ID du projet dans lequel se trouve la réservation.ZONE
: zone où se trouve la réservation.
Pour supprimer la réservation après une certaine durée, exécutez la commande
gcloud beta compute reservations update
avec l'option--delete-after-duration
.gcloud beta compute reservations update RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --project=PROJECT_ID \ --zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME
: nom d'une réservation existante.DELETE_AFTER_DURATION
: durée en jours, en heures, en minutes ou en secondes avant la suppression automatique de la réservation. Par exemple, spécifiez30m
pour 30 minutes ou1d2h3m4s
pour 1 jour, 2 heures, 3 minutes et 4 secondes.PROJECT_ID
: ID du projet dans lequel se trouve la réservation.ZONE
: zone où se trouve la réservation.
Pour désactiver l'option de suppression automatique, utilisez la commande gcloud beta compute reservations update
avec l'option --disable-auto-delete
.
gcloud beta compute reservations update RESERVATION_NAME \
--disable-auto-delete \
--project=PROJECT_ID \
--zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME
: nom d'une réservation existante.PROJECT_ID
: ID du projet dans lequel se trouve la réservation.ZONE
: zone où se trouve la réservation.
REST
Lorsque vous activez l'option de suppression automatique dans une réservation, vous pouvez spécifier une date et une heure auxquelles la réservation doit être supprimée, ou spécifier une durée après laquelle la réservation doit être supprimée.
Pour activer la suppression automatique ou modifier le moment où la réservation doit être supprimée, effectuez l'une des opérations suivantes :
Pour supprimer la réservation à une date et une heure spécifiques, envoyez une requête
PATCH
à la méthodebeta.reservations.update
avec le paramètre de requêtepaths
défin surdeleteAtTime
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime { "name": "RESERVATION_NAME", "deleteAtTime": "DELETE_AT_TIME" }
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet dans lequel se trouve la réservation.ZONE
: zone où se trouve la réservation.RESERVATION_NAME
: nom d'une réservation existante.DELETE_AT_TIME
: date et heure au format de code temporel RFC 3339 comme suit :YYYY-MM-DDTHH:MM:SSOFFSET
Remplacez les éléments suivants :
YYYY-MM-DD
: date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-
).HH:MM:SS
: heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 chiffres, séparés par des signes deux-points (:
).OFFSET
: fuseau horaire mis en forme en tant que décalage par rapport au temps universel coordonné (UTC). Par exemple, pour utiliser l'heure normale du Pacifique (PST), spécifiez-08:00
. Sinon, pour n'utiliser aucun décalage, spécifiezZ
.
Pour supprimer la réservation après une certaine durée, envoyez une requête
PATCH
à la méthodebeta.reservations.update
avec le paramètre de requêtepaths
défini surdeleteAfterDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration { "name": "RESERVATION_NAME", "deleteAfterDuration": { "seconds": "DELETE_AFTER_DURATION" } }
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet dans lequel se trouve la réservation.ZONE
: zone où se trouve la réservation.RESERVATION_NAME
: nom d'une réservation existante.DELETE_AFTER_DURATION
: durée en secondes avant la suppression automatique de la réservation. Par exemple, spécifiez86400
pour 86 400 secondes (1 jour).
Pour désactiver l'option de suppression automatique, envoyez une requête PATCH
à la méthode beta.reservations.update
.
Dans la requête, spécifiez le paramètre de requête paths=deleteAtTime&paths=deleteAfterDuration
et omettez le corps de la requête.
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet dans lequel se trouve la réservation.ZONE
: zone où se trouve la réservation.RESERVATION_NAME
: nom d'une réservation existante.
Modifier les projets clients d'une réservation partagée
Vous ne pouvez autoriser des projets à consommer une réservation partagée que s'ils se trouvent dans la même organisation que le projet propriétaire. Pour savoir comment migrer un projet vers l'organisation du projet propriétaire, consultez la section Migrer des projets entre des ressources d'organisation dans la documentation de Resource Manager.
Une fois que vous avez modifié les projets clients pouvant consommer une réservation partagée, la consommation de cette réservation peut changer. Par exemple, tout projet client supprimé cesse de consommer des ressources à partir de la réservation. En outre, si la réservation a été configurée pour être automatiquement consommée par une VM correspondant aux propriétés de la réservation (comportement par défaut), tout projet client ajouté peut commencer à consommer des ressources à partir de la réservation. Si vous souhaitez surveiller la consommation de cette réservation, consultez la section Vérifier la consommation des réservations.
Pour modifier les projets clients pouvant consommer une réservation partagée, sélectionnez l'une des options suivantes :
Console
Pour modifier les projets clients d'une réservation partagée, procédez comme suit :
Dans la console Google Cloud, accédez à la page Réservations.
Dans la colonne Nom, cliquez sur le nom de la réservation que vous souhaitez décrire.
La page de détails de la réservation s'affiche.
Cliquez sur
Modifier.Dans la section Projets sélectionnés, effectuez l'une des opérations suivantes :
Pour arrêter de partager la réservation avec un projet client spécifique, cliquez sur
Supprimer.Pour commencer à partager la réservation avec un ou plusieurs projets spécifiques, procédez comme suit :
Cliquez sur
Ajouter des projets.Cochez la case correspondant à chaque projet de l'organisation du projet propriétaire avec lequel vous souhaitez partager la réservation.
Cliquez sur Sélectionner.
Pour confirmer vos modifications, cliquez sur Enregistrer.
La modification de votre réservation peut prendre quelques secondes.
gcloud
Lorsque vous modifiez les projets clients d'une réservation partagée, vous devez spécifier une liste d'ID de projets séparés par une virgule que vous souhaitez autoriser ou cesser d'autoriser à utiliser la réservation partagée. Ces projets doivent appartenir à la même organisation que le projet propriétaire. Ne spécifiez pas le projet propriétaire dans la liste. Par défaut, il est déjà autorisé à utiliser la réservation partagée.
Pour modifier les projets clients d'une réservation partagée, sélectionnez l'une des méthodes suivantes :
Pour permettre à un ou plusieurs projets de consommer une réservation partagée, exécutez la commande
gcloud compute reservations update
avec l'option--add-share-with
.gcloud compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --add-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME
: nom d'une réservation partagée existante.PROJECT_ID
: ID du projet propriétaire, qui est le projet utilisé pour créer la réservation partagée.CONSUMER_PROJECT_IDS
: liste d'ID de projets avec lesquels partager la réservation, séparés par une virgule. Par exemple, spécifiezproject-1,project-2
.ZONE
: zone dans laquelle se situe la réservation partagée.
Pour cesser d'autoriser un ou plusieurs projets à consommer une réservation partagée, exécutez la commande
gcloud compute reservations update
avec l'option--remove-share-with
.gcloud compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --remove-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME
: nom d'une réservation partagée existante.PROJECT_ID
: ID du projet propriétaire, qui est le projet utilisé pour créer la réservation partagée.CONSUMER_PROJECT_IDS
: liste des ID des projets avec lesquels vous souhaitez cesser de partager la réservation, séparés par une virgule. Par exemple, spécifiezproject-1,project-2
.ZONE
: zone dans laquelle se situe la réservation partagée.
Pour remplacer la liste des projets pouvant consommer une réservation partagée, exécutez la commande
gcloud beta compute reservations update
avec l'option--share-with
.gcloud beta compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME
: nom d'une réservation partagée existante.PROJECT_ID
: ID du projet propriétaire, qui est le projet utilisé pour créer la réservation partagée.ZONE
: zone dans laquelle se situe la réservation partagée.CONSUMER_PROJECT_IDS
: liste d'ID de projets avec lesquels partager la réservation, séparés par une virgule. Par exemple, spécifiezproject-1,project-2
.
REST
Lorsque vous modifiez les projets clients d'une réservation partagée, vous devez spécifier les ID des projets que vous souhaitez autoriser ou cesser d'autoriser pour utiliser la réservation partagée. Ces projets doivent appartenir à la même organisation que le projet propriétaire. N'incluez pas le projet propriétaire. Par défaut, il est déjà autorisé à utiliser la réservation partagée.
Pour modifier les projets clients d'une réservation partagée, sélectionnez l'une des méthodes suivantes :
Pour permettre à un ou plusieurs projets de consommer une réservation partagée, envoyez une requête
PATCH
à la méthodereservations.update
. Dans l'URL de la requête, incluez le paramètre de requêtepaths=shareSettings.projectMap.PROJECT_ID
pour chaque projet avec lequel vous souhaitez partager la réservation.Par exemple, pour autoriser deux projets à consommer une réservation partagée, envoyez la requête
PATCH
suivante :PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2 { "name": "RESERVATION_NAME", "shareSetting": { "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } } }
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet propriétaire, qui est le projet utilisé pour créer la réservation partagée.ZONE
: zone dans laquelle se situe la réservation partagée.RESERVATION_NAME
: nom d'une réservation partagée existante.CONSUMER_PROJECT_ID_1
etCONSUMER_PROJECT_ID_2
: ID des deux projets avec lesquels vous souhaitez partager la réservation.
Pour arrêter de permettre à un ou plusieurs projets de consommer une réservation partagée, envoyez une requête
PATCH
à la méthodereservations.update
. Dans l'URL de la requête, incluez le paramètre de requêtepaths=shareSettings.projectMap.PROJECT_ID
pour chaque projet avec lequel vous souhaitez cesser de partager la réservation. En outre, vous devez omettre le champshareSetting
du corps de la requête.Par exemple, pour arrêter de permettre à deux projets de consommer une réservation partagée, envoyez la requête
PATCH
suivante :PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2 { "name": "RESERVATION_NAME" }
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet propriétaire, qui est le projet utilisé pour créer la réservation partagée.ZONE
: zone dans laquelle se situe la réservation partagée.RESERVATION_NAME
: nom d'une réservation partagée existante.CONSUMER_PROJECT_ID_1
etCONSUMER_PROJECT_ID_2
: ID des deux projets avec lesquels vous souhaitez cesser de partager la réservation.
Modifier le nombre de VM réservées dans une réservation
Vous pouvez modifier une réservation existante afin d'augmenter ou de réduire le nombre de VM réservées.
Avant de modifier le nombre de VM réservées dans une réservation, vérifiez les points suivants :
Si vous souhaitez augmenter le nombre de VM réservées dans une réservation, les restrictions suivantes s'appliquent :
Il doit y avoir suffisamment de ressources dans la zone où se trouve la réservation.
Vous devez avoir un quota suffisant pour les ressources supplémentaires que vous réservez.
Si le type de consommation de votre réservation est spécifique et que vous souhaitez réduire le nombre de VM réservées dans la réservation, assurez-vous que le nombre de VM qui consomment la réservation ne dépasse pas la taille de la réservation souhaitée. Pour ce faire, utilisez les méthodes suivantes :
Sinon, vous rencontrerez deserreurs.
Pour modifier le nombre de VM réservées dans une réservation, sélectionnez l'une des options suivantes :
Console
Pour modifier le nombre de VM réservées dans une réservation, procédez comme suit :
Dans la console Google Cloud, accédez à la page Réservations.
Dans la colonne Nom, cliquez sur le nom de la réservation que vous souhaitez modifier.
La page de détails de la réservation s'affiche.
Cliquez sur
Modifier.Dans le champ Nombre d'instances de VM, saisissez le nouveau nombre de VM à réserver.
Pour confirmer, cliquez sur Enregistrer.
La modification de votre réservation peut prendre quelques secondes.
gcloud
Pour modifier le nombre de VM réservées dans une réservation, utilisez la commande gcloud compute reservations update
.
gcloud compute reservations update RESERVATION_NAME \
--project=PROJECT_ID \
--vm-count=NUMBER_OF_VMS \
--zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME
: nom d'une réservation existante.PROJECT_ID
: ID du projet dans lequel se trouve la réservation.NUMBER_OF_VMS
: nombre de VM à réserver.ZONE
: zone où se trouve la réservation.
REST
Pour modifier le nombre de VM réservées dans une réservation, envoyez une requête POST
à la méthode reservations.resize
.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize
{
"specificSkuCount": "NUMBER_OF_VMS"
}
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet dans lequel se trouve la réservation.ZONE
: zone où se trouve la réservation.RESERVATION_NAME
: nom d'une réservation existante.NUMBER_OF_VMS
: nombre de VM à réserver.
Modifier d'autres propriétés d'une réservation
Si vous souhaitez modifier une propriété qui n'est pas mentionnée dans la section Modifier les réservations, vous devez créer une réservation de remplacement.
Pour remplacer une réservation sans risquer une réduction inattendue de votre capacité réservée, procédez comme suit :
Créez une réservation à projet unique ou une réservation partagée avec des propriétés mises à jour.
Si vous n'avez plus besoin de la réservation d'origine, supprimez-la.
Résoudre les problèmes
Découvrez comment résoudre les problèmes liés aux mises à jour des réservations.
Étapes suivantes
Découvrez comment afficher vos réservations.
Découvrez comment consommer des réservations.
Découvrez comment supprimer des réservations.