Modifier les réservations

Ce document explique comment modifier des réservations. Pour modifier les réservations auxquelles des engagements sont associés, consultez plutôt la section Remplacer les réservations auxquelles des engagements sont associés.

Modifiez une réservation lorsque, par exemple, vos besoins en capacité changent ou que vous souhaitez modifier les charges de travail pouvant consommer une réservation.

Limites

Avant de modifier une réservation, tenez compte des points suivants:

  • Vous ne pouvez modifier une réservation partagée que dans le même projet que celui dans lequel vous l'avez créée.

  • Vous ne pouvez modifier une réservation créée automatiquement pour une réservation future qu'après la fin de la période de réservation.

Avant de commencer

  • 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 Google Cloud services et aux API. 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:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

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

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

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 la page 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 dans une réservation, les projets clients dans une réservation partagée ou si les jobs Vertex AI peuvent consommer une réservation d'instances avec des GPU associés : compute.reservations.update sur le projet
  • Pour modifier le nombre d'instances 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

En fonction des propriétés que vous souhaitez modifier dans une réservation, utilisez l'une des méthodes suivantes :

Pour modifier des propriétés non mentionnées dans cette liste, vous devez créer une nouvelle réservation. Pour obtenir des instructions, consultez la section Modifier d'autres propriétés d'une réservation de ce 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

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

    Accéder à la page "Réservations"

  2. Dans l'onglet Réservations à la demande (par défaut), cliquez sur le nom de la réservation que vous souhaitez modifier dans la colonne Nom.

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

    • 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 \
    --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.

    • 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 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. Dans l'URL de la requête, incluez le paramètre de requête paths défini 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.

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

    PATCH https://compute.googleapis.com/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é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 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

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

    Accéder à la page "Réservations"

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

  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 \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Remplacez 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, 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 \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Remplacez 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, 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 beta compute reservations update avec l'option --share-with.

    gcloud beta compute reservations update RESERVATION_NAME \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Remplacez 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, 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 d'instances 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, tenez compte des points suivants pour éviter toute erreur:

  • Pour augmenter le nombre d'instances dans une réservation, assurez-vous de respecter les conditions suivantes:

  • Pour réduire le nombre d'instances dans une réservation spécifique, assurez-vous que le nombre d'instances qui consomment la réservation ne dépasse pas le nouveau nombre inférieur. Si c'est le cas, effectuez l'une des opérations suivantes avec les instances en trop:

    • Supprimer des instances

    • Arrêtez ou suspendez les instances.

Pour modifier le nombre d'instances réservées dans une réservation, sélectionnez l'une des options suivantes:

Console

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

    Accéder à la page "Réservations"

  2. 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 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 d'instances à réserver.

  5. Pour confirmer, cliquez sur Enregistrer.

    La modification de votre réservation peut prendre quelques secondes.

gcloud

Pour modifier le nombre d'instances 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 d'une réservation existante.

  • NUMBER_OF_VMS: nouveau nombre d'instances à réserver.

  • ZONE : zone où se trouve la réservation.

REST

Pour modifier le nombre d'instances 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: nouveau nombre d'instances à réserver.

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 pouvez autoriser ou interdire aux jobs d'entraînement ou de prédiction personnalisés dans Vertex AI de consommer la réservation.

Si vous souhaitez empêcher Vertex AI d'utiliser une réservation, assurez-vous qu'aucun job d'entraînement ou de prédiction personnalisé n'utilise la réservation avant de la modifier. Sinon, vous rencontrerez des erreurs.

Pour modifier la règle de partage d'une réservation d'instances GPU, sélectionnez l'une des options suivantes:

Console

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

    Accéder à la page "Réservations"

  2. Dans l'onglet Réservations à la demande (par défaut), dans la colonne Nom, cliquez sur le nom de la réservation d'instances GPU que vous souhaitez modifier.

    La page d'informations de la réservation sélectionnée s'affiche.

  3. Dans la ligne Partager avec d'autres services Google Cloud, cliquez sur Modifier les paramètres de partage de services.

  4. Dans le volet Partage de réservation, effectuez l'une des opérations suivantes :

    • Pour autoriser Vertex AI à utiliser la réservation, sélectionnez Partager la réservation.

    • Pour empêcher Vertex AI d'utiliser la réservation, sélectionnez Ne pas partager la réservation.

  5. 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 Vertex AI à utiliser la réservation : ALLOW_ALL

    • Pour empêcher 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 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.googleapis.com/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 Vertex AI à utiliser la réservation : ALLOW_ALL

    • Pour empêcher Vertex AI d'utiliser la réservation : DISALLOW_ALL

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 :

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

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