Ce document explique comment modifier des réservations dans Compute Engine. Pour modifier les réservations associées à des engagements, consultez Remplacer les réservations associées à des engagements.
Modifiez une réservation lorsque vos besoins en capacité changent ou lorsque vous souhaitez mettre à jour les charges de travail qui peuvent consommer la capacité réservée.
Limites
Lorsque vous modifiez une réservation, les limites suivantes s'appliquent :
Vous ne pouvez modifier une réservation partagée que depuis le projet dans lequel elle existe.
Vous pouvez modifier une réservation créée automatiquement (créée automatiquement) pour une réservation future en mode Agenda ou une réservation future pour des blocs de capacité à tout moment, et uniquement comme suit :
Vous ne pouvez modifier une réservation créée automatiquement pour une réservation future que comme suit :
Après l'heure de début, vous pouvez effectuer les opérations suivantes :
Après l'heure de fin, vous pouvez effectuer les opérations suivantes :
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification permet de valider votre identité pour accéder aux services et aux API Cloud de Confiance by S3NS . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
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 Cloud de Confiance pour accéder aux services et aux API Cloud de Confiance by S3NS , vous n'avez pas besoin de configurer l'authentification.
gcloud
-
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud init
-
- Définissez une région et une zone par défaut.
REST
Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Cloud de Confiance .
Rôles requis
Pour obtenir les autorisations nécessaires pour modifier des réservations, 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 Gérer l'accès aux projets, aux dossiers et aux organisations.
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, le type de consommation ou le type de partage dans une réservation, ou pour indiquer si les jobs Vertex AI peuvent consommer une réservation d'instances de calcul avec GPU associés :
compute.reservations.updatesur le projet -
Pour modifier le nombre d'instances Compute Engine dans une réservation :
compute.reservations.resizesur 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
En fonction des propriétés que vous souhaitez modifier dans une réservation, utilisez l'une des méthodes suivantes. Si vous souhaitez modifier une propriété qui n'est pas mentionnée dans la liste suivante, vous devez créer une réservation avec les modifications de votre choix, puis supprimer la réservation d'origine si vous n'en avez plus besoin.
Pour augmenter ou diminuer le nombre d'instances de calcul réservées dans une réservation, modifiez le nombre d'instances de calcul réservées dans une réservation.
Pour passer d'une réservation pour un seul projet à une réservation partagée, modifiez le type de partage d'une réservation.
Pour ajouter ou supprimer des projets clients pouvant utiliser une réservation partagée, modifiez les projets clients dans une réservation partagée.
Pour autoriser ou interdire l'utilisation d'une réservation d'instances de GPU par des jobs d'entraînement ou de prédiction personnalisés dans Vertex AI, modifiez la règle de partage d'une réservation.
Pour activer ou désactiver la suppression automatique d'une réservation, ou pour modifier la date et l'heure auxquelles Compute Engine supprime automatiquement la réservation, modifiez la suppression automatique d'une réservation.
Modifier le nombre d'instances de calcul réservées dans une réservation
Vous pouvez augmenter ou diminuer le nombre d'instances de calcul réservées dans une réservation. Toutefois, avant de modifier le nombre d'instances de calcul, tenez compte des points suivants pour éviter les erreurs :
Pour augmenter le nombre d'instances de calcul dans une réservation, vérifiez que vous pouvez remplir les conditions suivantes :
Vous ne pouvez pas dépasser le nombre maximal d'instances de calcul pour une réservation.
Vous devez disposer d'un quota inutilisé suffisant dans votre projet pour les ressources supplémentaires à réserver. Pour augmenter le quota, consultez Afficher et gérer les quotas.
Il doit y avoir suffisamment de ressources disponibles dans la zone de la réservation. Sinon, votre demande de modification échoue et une erreur de disponibilité des ressources s'affiche. Pour résoudre ce type d'erreur, consultez Dépannage des erreurs de disponibilité des ressources.
Pour réduire le nombre d'instances de calcul dans une réservation spécifiquement ciblée, vérifiez que le nombre d'instances de calcul qui consomment la réservation ne dépasse pas le nouveau nombre, plus petit. Si tel est le cas, effectuez l'une des opérations suivantes avec les instances de calcul dépassant le nouveau nombre :
Pour modifier le nombre d'instances de calcul réservées dans une réservation, sélectionnez l'une des options suivantes :
Console
Dans la console Cloud de Confiance , accédez à la page Réservations.
Dans l'onglet Réservations à la demande (par défaut), cliquez sur le nom de la réservation à modifier dans la colonne Nom. Une page contenant les détails de la réservation s'ouvre.
Cliquez sur Modifier.
Dans le champ Nombre d'instances de VM, saisissez le nouveau nombre d'instances de calcul à réserver.
Pour confirmer, cliquez sur Enregistrer.
gcloud
Pour modifier le nombre d'instances de calcul réservées dans une réservation, utilisez la commande gcloud compute reservations update.
gcloud compute reservations update RESERVATION_NAME \
--vm-count=NUMBER_OF_VMS \
--zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME: nom de la réservation.NUMBER_OF_VMS: nouveau nombre d'instances de calcul à réserver.ZONE: zone où se trouve la réservation.
REST
Pour modifier le nombre d'instances de calcul réservées dans une réservation, envoyez une requête POST à la méthode reservations.resize.
POST https://compute.s3nsapis.fr/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 de la réservation.NUMBER_OF_VMS: nouveau nombre d'instances de calcul à réserver.
Modifier le type de partage d'une réservation
Vous pouvez convertir une réservation monoprojet en réservation partagée, ou une réservation partagée en réservation monoprojet. Lorsque vous modifiez le type de partage d'une réservation, vous pouvez partager les ressources réservées avec un maximum de 100 projets de votre organisation ou limiter l'accès au seul projet propriétaire.
Pour éviter les erreurs lorsque vous modifiez le type de partage d'une réservation, tenez compte des points suivants avant de commencer la modification :
Pour convertir une réservation monoprojet en réservation partagée, vérifiez les points suivants :
Autorisations du projet : vérifiez que votre projet peut créer des réservations partagées. Pour obtenir des instructions, consultez Autoriser ou restreindre la création de réservations partagées pour des projets.
Limites de quota : si le type de réservation nécessite un quota, vous aurez peut-être besoin d'un quota supplémentaire pour vos ressources réservées. Les réservations partagées et les réservations à projet unique sont soumises à des exigences de quota différentes. Pour en savoir plus, consultez la section Exigences supplémentaires relatives aux quotas pour les réservations partagées.
Pour convertir une réservation partagée en réservation à un seul projet, vérifiez les points suivants :
Instances de calcul client : pour modifier une réservation spécifiquement ciblée, vous devez arrêter, suspendre ou supprimer toutes les instances de calcul qui utilisent la réservation dans chaque projet client avec lequel la réservation est partagée. Cette exigence ne s'applique pas aux instances de calcul du projet propriétaire.
Pour modifier le type de partage d'une réservation, sélectionnez l'une des options suivantes :
gcloud
Pour modifier le type de partage d'une réservation, utilisez la commande gcloud compute reservations update.
Selon la façon dont vous souhaitez modifier votre réservation, incluez l'un des flags suivants :
Pour convertir une réservation monoprojet en réservation partagée, incluez les options
--add-share-withet--share-setting=projects:gcloud compute reservations update RESERVATION_NAME \ --add-share-with=CONSUMER_PROJECT_IDS \ --share-setting=projects \ --zone=ZONEPour convertir une réservation partagée en réservation monoprojet, incluez l'option
--share-setting=local:gcloud compute reservations update RESERVATION_NAME \ --share-setting=local \ --zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME: nom de la réservation que vous souhaitez modifier.CONSUMER_PROJECT_IDS: liste d'ID de projets avec lesquels partager la réservation, séparés par une virgule (par exemple,project-1,project-2). Vous pouvez partager une réservation avec un maximum de 100 projets appartenant à la même organisation que le projet propriétaire.ZONE: zone où se trouve la réservation.
REST
Pour modifier le type de partage d'une réservation, envoyez une requête PATCH à la méthode reservations.update.
Selon la manière dont vous souhaitez modifier votre réservation, effectuez l'une des requêtes suivantes :
Pour convertir une réservation à un seul projet en réservation partagée, envoyez une requête comme suit. Dans l'URL de la requête, incluez le paramètre de requête
paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBERpour chaque projet avec lequel vous souhaitez partager la réservation.Par exemple, pour partager une réservation avec deux projets, envoyez une requête comme suit. Vous pouvez partager une réservation avec un maximum de 100 projets qui se trouvent dans la même organisation que le projet propriétaire.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2 { "name": "RESERVATION_NAME", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_OR_NUMBER_1": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1" }, "CONSUMER_PROJECT_ID_OR_NUMBER_2": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2" } } } }Pour convertir une réservation partagée en réservation monoprojet, envoyez une requête comme suit :
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType { "name": "RESERVATION_NAME", "shareSettings": { "shareType": "LOCAL" } }
Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel la réservation existe (le projet propriétaire).ZONE: zone où se trouve la réservation.RESERVATION_NAME: nom de la réservation que vous souhaitez modifier.CONSUMER_PROJECT_ID_OR_NUMBER_1etCONSUMER_PROJECT_ID_OR_NUMBER_2: ID ou numéro des deux projets avec lesquels vous souhaitez partager la réservation.
Modifier les projets clients d'une réservation partagée
Pour éviter les erreurs lorsque vous modifiez les projets clients pouvant consommer une réservation partagée, tenez compte des points suivants :
Suppression de projets : vous ne pouvez interdire aux projets clients de consommer une réservation partagée que si aucune instance de calcul de ces projets ne consomme la réservation. Pour empêcher les instances de calcul de consommer une réservation, arrêtez, suspendez ou supprimez les instances de calcul.
Ajout de projets : vous ne pouvez autoriser des projets clients à utiliser 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 Migrer des projets entre des ressources d'organisation.
Une fois que vous avez modifié les projets clients d'une réservation partagée, la consommation de cette réservation peut changer. Par exemple, si vous avez configuré la réservation pour permettre à toutes les instances de calcul correspondantes de la consommer (configuration par défaut), tous les projets client nouvellement ajoutés peuvent immédiatement commencer à consommer la réservation. Pour en savoir plus sur les projets correspondants qui consomment les réservations en premier, consultez l'ordre de consommation des réservations.
Pour modifier les projets clients pouvant consommer une réservation partagée, sélectionnez l'une des options suivantes :
Console
Dans la console Cloud de Confiance , accédez à la page Réservations.
Dans l'onglet Réservations à la demande (par défaut), cliquez sur le nom de la réservation que vous souhaitez décrire dans la colonne Nom.
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. Vous pouvez partager une réservation partagée avec un maximum de 100 projets clients.
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. Tous les projets clients doivent appartenir à la même organisation que le projet propriétaire. N'incluez pas le projet propriétaire. Par défaut, le projet propriétaire d'une réservation partagée peut toujours l'utiliser.
Pour modifier les projets clients d'une réservation partagée, procédez comme suit :
Pour permettre à un ou plusieurs projets de consommer une réservation partagée, exécutez la commande
gcloud compute reservations updateavec l'option--add-share-with.gcloud compute reservations update RESERVATION_NAME \ --add-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONERemplacez les éléments suivants :
RESERVATION_NAME: nom d'une réservation partagée existante.CONSUMER_PROJECT_IDS: liste d'ID de projets avec lesquels partager la réservation, séparés par une virgule (par exemple,project-1,project-2). Vous pouvez partager une réservation partagée avec un maximum de 100 projets clients.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 updateavec l'option--remove-share-with.gcloud compute reservations update RESERVATION_NAME \ --remove-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONERemplacez les éléments suivants :
RESERVATION_NAME: nom d'une réservation partagée existante.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,project-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 updateavec l'option--share-with.gcloud beta compute reservations update RESERVATION_NAME \ --share-with=CONSUMER_PROJECT_IDS \ --zone=ZONERemplacez les éléments suivants :
RESERVATION_NAME: nom d'une réservation partagée existante.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,project-1,project-2). Vous pouvez partager une réservation partagée avec un maximum de 100 projets clients.
REST
Lorsque vous modifiez les projets clients d'une réservation partagée, vous devez spécifier les projets que vous souhaitez ajouter ou supprimer. Pour autoriser un projet à utiliser la réservation, spécifiez l'ID du projet ou le numéro du projet. Pour interdire à un projet d'utiliser la réservation, vous devez spécifier le numéro du projet. Tous les projets consommateurs doivent appartenir à la même organisation que le projet propriétaire. N'incluez pas le projet propriétaire. Par défaut, le projet propriétaire d'une réservation partagée peut toujours l'utiliser.
Pour modifier les projets clients d'une réservation partagée, procédez comme suit :
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_OR_NUMBERpour chaque projet avec lequel vous souhaitez partager la réservation.Par exemple, pour autoriser deux projets à consommer une réservation partagée, envoyez une requête
PATCHcomme suit. Vous pouvez partager une réservation partagée avec un maximum de 100 projets clients.PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2 { "name": "RESERVATION_NAME", "shareSetting": { "projectMap": { "CONSUMER_PROJECT_ID_OR_NUMBER_1": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1" }, "CONSUMER_PROJECT_ID_OR_NUMBER_2": { "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2" } } } }Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel la réservation partagée existe (le projet propriétaire).ZONE: zone dans laquelle se situe la réservation partagée.RESERVATION_NAME: nom d'une réservation partagée existante.CONSUMER_PROJECT_ID_OR_NUMBER_1etCONSUMER_PROJECT_ID_OR_NUMBER_2: ID ou numéro 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_NUMBERpour chaque projet avec lequel vous souhaitez cesser de partager la réservation. En outre, vous devez omettre le champshareSettingdu corps de la requête.Par exemple, pour arrêter de permettre à deux projets de consommer une réservation partagée, envoyez une requête
PATCHcomme suit :PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2 { "name": "RESERVATION_NAME" }Remplacez les éléments suivants :
PROJECT_ID: ID du projet dans lequel la réservation partagée existe (le projet propriétaire).ZONE: zone dans laquelle se situe la réservation partagée.RESERVATION_NAME: nom d'une réservation partagée existante.CONSUMER_PROJECT_NUMBER_1etCONSUMER_PROJECT_NUMBER_2: numéros des deux projets avec lesquels vous souhaitez cesser de partager la réservation.
Modifier la règle de partage d'une réservation
Lorsque vous modifiez la règle de partage d'une réservation d'instances de calcul GPU, vous contrôlez si les jobs d'entraînement ou de prédiction Vertex AI consomment la réservation.
Avant d'empêcher les jobs Vertex AI d'utiliser une réservation, arrêtez tous les jobs Vertex AI qui l'utilisent. Sinon, vous rencontrerez des erreurs.
Pour modifier la règle de partage d'une réservation d'instances de GPU, sélectionnez l'une des options suivantes :
Console
Dans la console Cloud de Confiance , accédez à la page Réservations.
Dans l'onglet Réservations à la demande (par défaut), dans la colonne Nom, cliquez sur le nom de la réservation d'instances de GPU que vous souhaitez modifier. Une page indiquant les détails de la réservation s'affiche.
Dans la ligne Partager avec d'autres services Google Cloud, cliquez sur Modifier les paramètres de partage de services.
Dans le volet Partage de réservation, effectuez l'une des opérations suivantes :
Pour autoriser les jobs Vertex AI à utiliser la réservation, sélectionnez Partager la réservation.
Pour empêcher les jobs Vertex AI d'utiliser la réservation, sélectionnez Ne pas partager la réservation.
Cliquez sur Enregistrer.
La modification de votre réservation peut prendre quelques secondes.
gcloud
Pour modifier la règle de partage d'une réservation d'instances GPU, exécutez la commande gcloud compute reservations update avec l'option --reservation-sharing-policy.
gcloud compute reservations update RESERVATION_NAME \
--reservation-sharing-policy=SHARING_POLICY \
--zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME: nom d'une réservation existante.SHARING_POLICY: règle de partage de la réservation. Spécifiez une des valeurs suivantes :Pour autoriser les jobs Vertex AI à utiliser la réservation :
ALLOW_ALLPour empêcher les jobs Vertex AI d'utiliser la réservation :
DISALLOW_ALL
ZONE: zone où se trouve la réservation.
REST
Pour modifier la règle de partage d'une réservation d'instances de GPU, envoyez une requête PATCH à la méthode reservations.update.
Dans l'URL de la requête, incluez le paramètre de requête paths défini sur reservationSharingPolicy.serviceShareType.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType
{
"name": "RESERVATION_NAME",
"reservationSharingPolicy": {
"serviceShareType": "SHARING_POLICY"
}
}
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.SHARING_POLICY: règle de partage de la réservation. Spécifiez une des valeurs suivantes :Pour autoriser les jobs Vertex AI à utiliser la réservation :
ALLOW_ALLPour empêcher les jobs Vertex AI d'utiliser la réservation :
DISALLOW_ALL
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
Dans la console Cloud de Confiance , accédez à la page Réservations.
Dans l'onglet Réservations à la demande (par défaut), cliquez sur le nom de la réservation à modifier dans la colonne Nom.
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 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 updateavec l'option--delete-at-time.gcloud beta compute reservations update RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --zone=ZONERemplacez 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.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 updateavec l'option--delete-after-duration.gcloud beta compute reservations update RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --zone=ZONERemplacez 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écifiez30mpour 30 minutes ou1d2h3m4spour 1 jour, 2 heures, 3 minutes et 4 secondes.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 \
--zone=ZONE
Remplacez les éléments suivants :
RESERVATION_NAME: nom d'une réservation existante.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 la durée de validité d'une réservation avant sa suppression.
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. Dans l'URL de la requête, incluez le paramètre de requêtepathsdéfini surdeleteAtTime.PATCH https://compute.s3nsapis.fr/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.
Pour supprimer la réservation après une certaine durée, envoyez une requête
PATCHà la méthodebeta.reservations.update. Dans l'URL de la requête, incluez le paramètre de requêtepathsdéfini surdeleteAfterDuration.seconds.PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds { "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écifiez86400pour 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.s3nsapis.fr/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.
Étapes suivantes
Découvrez comment afficher vos réservations.
Découvrez comment résoudre les problèmes liés aux mises à jour des réservations.
Découvrez comment consommer des réservations.
Découvrez comment supprimer des réservations.