Configurer les recommandations de réservations sous-utilisées

Cette page explique comment afficher et modifier la configuration de vos recommandations de réservations à la demande sous-utilisées. 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.

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Configurer vos recommandations

Pour configurer vos recommandations de réservations sous-utilisées, procédez comme suit:

  1. Obtenez la configuration actuelle pour obtenir le fichier JSON de la configuration.
  2. Modifiez le fichier de configuration au format JSON.
  3. 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 sous-utilisées pour votre projet à l'aide de Google Cloud CLI ou de REST.

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.RightSizeResourceRecommender comme ID de l'outil de recommandation :

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

Remplacez les éléments suivants :

  • Remplacez ZONE par la zone contenant les réservations pour lesquelles vous souhaitez afficher les recommandations.
  • BILLING_ACCOUNT_ID par l'ID de votre compte de facturation.

Exemple :

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

La commande renvoie la configuration de l'outil de recommandation, y compris les sous-champs modifiables params.under_utilized_reservation_lookback_period et params.under_utilized_reservation_utilization_threshold.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "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.RightSizeResourceRecommender comme ID de l'outil de recommandation :

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

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

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.RightSizeResourceRecommender/config

La commande renvoie la configuration de l'outil de recommandation, y compris les sous-champs que vous pouvez modifier: params.under_utilized_reservation_lookback_period et params.under_utilized_reservation_utilization_threshold.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "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 sous-utilisées, modifiez la valeur de under_utilized_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".

De même, définissez le seuil d'utilisation qui déclenche une recommandation de réservation sous-utilisée en modifiant la valeur de under_utilized_reservation_utilization_threshold et en important la nouvelle configuration pour votre projet, par exemple:

  • Pour un seuil de 80%, "0.8".

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.

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

gcloud

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

gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\
  --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 et définir le seuil de réservation sous-utilisée sur 80%, utilisez le fichier de configuration suivant:

{
  "params": {
    "under_utilized_reservation_lookback_period": "P21D",
    "under_utilized_reservation_utilization_threshold": "0.8"
  }
}

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.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "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.RightSizeResourceRecommender comme ID de l'outil de recommandation :

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "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.RightSizeResourceRecommender/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.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

Étape suivante