Modifier les réservations

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 :

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

    1. 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.update sur le projet
  • Pour modifier le nombre d'instances Compute Engine 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. 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.

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 :

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

    • Supprimer des instances de calcul

    • Arrêtez ou suspendez des instances de calcul.

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

Console

  1. Dans la console Cloud de Confiance , 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. Une page contenant les détails de la réservation s'ouvre.

  3. Cliquez sur Modifier.

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

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

  • 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-with et --share-setting=projects :

    gcloud compute reservations update RESERVATION_NAME \
        --add-share-with=CONSUMER_PROJECT_IDS \
        --share-setting=projects \
        --zone=ZONE
    
  • Pour 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_NUMBER pour 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_1 et CONSUMER_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

  1. Dans la console Cloud de Confiance , 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. Vous pouvez partager une réservation partagée avec un maximum de 100 projets clients.

      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. 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 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, 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 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, 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, 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éthode reservations.update. Dans l'URL de la requête, incluez le paramètre de requête paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER pour 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 PATCH comme 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_1 et CONSUMER_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éthode reservations.update. Dans l'URL de la requête, incluez le paramètre de requête paths=shareSettings.projectMap.PROJECT_NUMBER 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 une requête PATCH comme 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_1 et CONSUMER_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

  1. Dans la console Cloud de Confiance , 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 de GPU que vous souhaitez modifier. Une page indiquant les détails de la réservation 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 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.

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

    • Pour 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_ALL

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

  1. Dans la console Cloud de Confiance , 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 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 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é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.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é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.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é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.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