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

Configurer les recommandations de réservations inactives

Cette page explique comment afficher et modifier la configuration de vos recommandations de réservations à la demande inactives. Vous pouvez modifier la configuration pour augmenter le nombre de recommandations que vous recevez ou pour recevoir moins de recommandations afin de supprimer les réservations que vous prévoyez d'utiliser.

Pour en savoir plus sur les paramètres que vous pouvez utiliser afin de personnaliser les recommandations, consultez la section Choisir les paramètres de configuration appropriés.
Pour en savoir plus sur l'identification des réservations inactives à la demande et les mesures à prendre, consultez la page Afficher et appliquer les recommandations de réservations inactives.

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

Configurer vos recommandations

Pour configurer vos recommandations pour les réservations inactives, procédez comme suit :

Obtenez la configuration actuelle pour obtenir le fichier JSON de la configuration.
Modifiez le fichier de configuration au format JSON.
Importez le nouveau fichier de configuration pour appliquer les modifications.

Obtenir la configuration actuelle

Vous pouvez obtenir la configuration actuelle des recommandations de réservations disponibles pour votre projet à l'aide de Google Cloud CLI ou de REST.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

recommender.computeIdleResourceRecommendations.get sur le projet.

Pour ce faire, utilisez l'une des méthodes suivantes.

gcloud

Pour obtenir les paramètres de configuration actuels, utilisez la commande gcloud recommender recommender-config describe et utilisez google.compute.IdleResourceRecommender comme ID de l'outil de recommandation :

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=ZONE --billing-account=BILLING_ACCOUNT_ID

Remplacez ZONE par la zone pour laquelle vous souhaitez obtenir la configuration actuelle.

Exemple :

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=us-central1-c --billing-account=my-billing-account-id

La commande renvoie la configuration de l'outil de recommandation, y compris le sous-champ modifiable params.idle_reservation_lookback_period.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

REST

Pour récupérer la configuration actuelle, utilisez la méthode recommenders.getConfig et spécifiez google.compute.IdleResourceRecommender comme ID de l'outil de recommandation :

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

Remplacez ZONE par la zone contenant votre projet.

Depuis la ligne de commande, exécutez la commande suivante pour obtenir la configuration de l'outil de recommandation pour un projet :

PROJECT_ID=PROJECT_ID
ZONE=ZONE
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: ${PROJECT_ID}" \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

La commande renvoie la configuration de l'outil de recommandation, y compris le sous-champ params.idle_reservation_lookback_period que vous pouvez modifier.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P7D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

Mettre à jour la configuration d'un projet

Pour mettre à jour la configuration de vos recommandations de réservations inactives, modifiez la valeur de idle_reservation_lookback_period et importez la nouvelle configuration pour votre projet.

Vous pouvez définir la période d'observation sur une valeur comprise entre 7 et 30 jours, en utilisant une chaîne commençant par P, puis un entier pour le nombre de jours (7 minimum et 30 maximum), suivi de D, par exemple :

Pour une période d'observation de 7 jours, utilisez "P7D".
Pour une période d'observation de 30 jours, utilisez "P30D".

Une fois la nouvelle configuration importée, la prise en compte de la modification prend environ 48 heures. Pendant ce temps, toutes les recommandations générées utilisent la configuration précédente.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

recommender.computeIdleResourceRecommenderConfig.get sur le projet pour afficher la configuration
recommender.computeIdleResourceRecommenderConfig.update sur le projet pour modifier la configuration

gcloud

Pour mettre à jour les paramètres de configuration, exécutez la commande gcloud recommender recommender-config update et utilisez google.compute.IdleResourceRecommender comme ID de l'outil de recommandation :

gcloud recommender recommender-config update google.compute.IdleResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG \
  --billing-account=BILLING_ACCOUNT_ID

Remplacez les éléments suivants :

ZONE : zone pour laquelle vous souhaitez obtenir la configuration actuelle
CONFIG_FILE_PATH : chemin d'accès au fichier JSON contenant la configuration actuelle
ETAG : valeur etag de la configuration actuelle
BILLING_ACCOUNT_ID : ID du compte de facturation

Dans votre fichier de configuration, spécifiez uniquement l'objet recommenderGenerationConfig avec les paramètres de configuration mis à jour. Par exemple, pour spécifier une période d'observation de 21 jours, utilisez le fichier de configuration suivant :

{
  "params": {
    "idle_reservation_lookback_period": "P21D"
  }
}

Si la commande aboutit, elle renvoie un corps de réponse semblable à celui-ci, qui indique la nouvelle configuration avec les paramètres que vous venez de modifier.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

Pour mettre à jour la configuration, envoyez une requête PATCH à la méthode recommenders.updateConfig et spécifiez google.compute.IdleResourceRecommender comme ID de l'outil de recommandation :

PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

Remplacez les éléments suivants :

PROJECT_ID : ID du projet pour lequel vous souhaitez modifier la configuration de l'outil de recommandation
ZONE : zone contenant votre projet

Enregistrez le corps de la requête dans un fichier, par exemple, config.json. Vous pouvez ensuite référencer ce fichier, lorsque vous mettez à jour la configuration de l'outil de recommandation pour votre projet, à l'aide d'une commande semblable à celle-ci :

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "x-goog-user-project: ${PROJECT_ID}" \
-d @config.json \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

La commande POST renvoie un corps de réponse semblable à celui-ci, qui affiche la nouvelle configuration avec les paramètres que vous venez de modifier.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "idle_reservation_lookback_period": "P21D"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

Étape suivante

Découvrez comment afficher et appliquer des recommandations de réservations inactives.
Découvrez comment afficher et appliquer des recommandations de réservations sous-utilisées.