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

Modifier les réservations

Ce document explique comment modifier une réservation existante.

La modification d'une réservation est utile lorsque, par exemple, vos besoins en capacité changent ou que vous souhaitez autoriser ou interdire à des projets d'utiliser une réservation partagée. Si vous souhaitez modifier une réservation partagée, vous ne pouvez le faire qu'à l'aide du 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

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 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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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

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

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.
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 augmenter ou diminuer le nombre d'instances de machines virtuelles (VM) réservées dans une réservation, modifiez le nombre de VM réservées dans une réservation.
Pour autoriser ou non une réservation de VM GPU à être utilisée par des tâches d'entraînement personnalisées ou des tâches de prédiction dans Vertex AI, modifiez la règle de partage d'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

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

Accéder à 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 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 :
  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.
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

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

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

Accéder à 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 :
  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.
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.

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.
```
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 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, assurez-vous que les conditions suivantes sont remplies :

Si vous souhaitez augmenter le nombre de VM réservées dans une réservation, assurez-vous de respecter les conditions suivantes :
- Il doit y avoir suffisamment de ressources dans la zone où se trouve la réservation.
- Vous devez disposer d'un quota suffisant, à savoir un quota de processeur et un quota de GPU, pour les ressources supplémentaires que vous réservez. Pour augmenter le quota, consultez la section Afficher et gérer les quotas dans la documentation sur les quotas Cloud.
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 :
- Supprimer des VM
- Mettez à jour la propriété reservationAffinity dans les VM.

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

Console

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

Accéder à 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 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 \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Remplacez les éléments suivants :

RESERVATION_NAME : nom d'une réservation existante.
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.

En modifiant la règle de partage d'une réservation de VM GPU, vous pouvez autoriser ou non les jobs d'entraînement personnalisés ou les jobs de prédiction dans Vertex AI à utiliser la réservation.

Si vous ne souhaitez pas autoriser Vertex AI à utiliser une réservation, assurez-vous qu'aucun job d'entraînement personnalisé ou de prédiction ne l'utilise avant de modifier la réservation. Sinon, vous rencontrerez des erreurs.

Pour modifier la stratégie de partage d'une réservation de VM GPU, sélectionnez l'une des options suivantes:

Console

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

Accéder à 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 de VM GPU que vous souhaitez modifier.

La page d'informations de la réservation sélectionnée 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 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.
Cliquez sur Enregistrer.

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

gcloud

Pour modifier la stratégie de partage d'une réservation de VM avec GPU, exécutez la commande gcloud beta compute reservations update avec l'option --reservation-sharing-policy.

gcloud beta 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 stratégie de partage d'une réservation de VM avec GPU, 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 reservationSharingPolicy.serviceShareType.

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

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.

Modifier les réservations

Avant de commencer

Console

gcloud

REST

Rôles requis

Autorisations requises

Modifier les réservations

Modifier la suppression automatique d'une réservation

Console

gcloud

REST

Modifier les projets clients d'une réservation partagée

Console

gcloud

REST

Modifier le nombre de VM réservées dans une réservation

Console

gcloud

REST

Modifier la règle de partage d'une réservation

Console

gcloud

REST

Modifier d'autres propriétés d'une réservation

Résoudre les problèmes

Étapes suivantes