Modifier les réservations

Ce document explique comment modifier une réservation existante.

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

    1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init
    2. 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.

      Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      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

Vous pouvez apporter les modifications suivantes à une réservation existante :

Si vous souhaitez modifier d'autres propriétés d'une réservation qui n'est pas associée à un engagement, 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, utilisez la console Google Cloud, la gcloud CLI ou REST.

Console

Pour modifier la suppression automatique d'une réservation, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Réservations.

    Accéder à la page "Réservations"

  2. 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.

  3. Sur la ligne Heure de suppression automatique, cliquez sur Modifier l'heure de suppression automatique.

  4. 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 :

      1. Si l'option de suppression automatique n'est pas déjà activée, cliquez sur le bouton Activer la suppression automatique pour l'activer.

      2. 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.

  5. 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écifiez Z.

    • 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écifiez 30m pour 30 minutes ou 1d2h3m4s 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éthode beta.reservations.update avec le paramètre de requête paths défin sur deleteAtTime.

    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écifiez Z.

  • Pour supprimer la réservation après une certaine durée, envoyez une requête PATCH à la méthode beta.reservations.update avec le paramètre de requête paths défini sur deleteAfterDuration.

    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écifiez 86400 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 pouvez modifier les projets clients d'une réservation partagée existante. Les projets client sont des projets avec lesquels une réservation partagée est partagée et qui peuvent utiliser la réservation.

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, utilisez la console Google Cloud, la gcloud CLI ou REST.

Console

Pour modifier les projets clients d'une réservation partagée, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Réservations.

    Accéder à la page "Réservations"

  2. 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.

  3. Cliquez sur Modifier.

  4. 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 :

      1. Cliquez sur  Ajouter des projets.

      2. Cochez la case correspondant à chaque projet de l'organisation du projet propriétaire avec lequel vous souhaitez partager la réservation.

      3. Cliquez sur Sélectionner.

  5. 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écifiez project-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écifiez 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 compute reservations update avec l'option --share-with.

    gcloud 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écifiez project-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éthode reservations.update. Dans l'URL de la requête, incluez le paramètre de requête paths=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 et CONSUMER_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éthode reservations.update. Dans l'URL de la requête, incluez le paramètre de requête paths=shareSettings.projectMap.PROJECT_ID pour chaque projet avec lequel vous souhaitez cesser de partager la réservation. En outre, vous devez omettre le champ shareSetting 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 et CONSUMER_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 des erreurs.

Pour modifier le nombre de VM réservées dans une réservation, utilisez la console Google Cloud, la gcloud CLI ou REST.

Console

Pour modifier le nombre de VM réservées dans une réservation, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Réservations.

    Accéder à la page "Réservations"

  2. 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.

  3. Cliquez sur Modifier.

  4. Dans le champ Nombre d'instances de VM, saisissez le nouveau nombre de VM à réserver.

  5. 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

Pour modifier les autres propriétés d'une réservation existante, procédez comme suit :

  1. Créez une réservation à projet unique ou une réservation partagée avec des propriétés mises à jour.

  2. Supprimez la réservation existante.

Résoudre les problèmes

Découvrez comment résoudre les problèmes liés aux mises à jour des réservations.

Étapes suivantes