Cette page explique comment afficher et modifier la configuration de vos recommandations pour les VM inactives. Vous pouvez envisager de modifier la configuration pour augmenter le nombre de recommandations que vous recevez ou pour éviter de classer par erreur des VM ayant des charges de travail volontairement petites en tant que VM inactives.
- 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 VM inactives et les actions à effectuer, consultez la page Afficher et appliquer les recommandations de VM 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 Trusted Cloud 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 :
Select the tab for how you plan to use the samples on this page:
gcloud
-
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
- Set a default region and zone.
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.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Trusted Cloud .
Tarifs
Les recommandations configurables sont disponibles sans frais. Les recommandations permettant de réduire votre utilisation des ressources peuvent vous permettre de réduire les coûts.
Configurer vos recommandations
Pour configurer vos recommandations pour les VM 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 VM inactives pour votre projet à l'aide de Google Cloud CLI ou de REST.
gcloud
Pour obtenir les paramètres de configuration actuels, utilisez la commande
gcloud recommender recommender-config describe
et utilisezgoogle.compute.instance.IdleResourceRecommender
comme ID de l'outil de recommandation :gcloud recommender recommender-config describe google.compute.instance.IdleResourceRecommender \ --project=PROJECT_ID \ --location=ZONE
Remplacez les éléments suivants :
PROJECT_ID
: ID de votre projetZONE
: zone pour laquelle vous souhaitez obtenir la configuration actuelle
Exemple :
gcloud recommender recommender-config describe google.compute.instance.IdleResourceRecommender \ --project=my-project \ --location=us-central1-c
La commande renvoie la configuration de l'outil de recommandation, y compris le sous-champ modifiable
params.observation_period
.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "1209600s" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2021-02-03T04:41:15.330351Z" }
REST
Pour récupérer la configuration actuelle, utilisez la méthode
recommenders.getConfig
et spécifiezgoogle.compute.instance.IdleResourceRecommender
comme ID de l'outil de recommandation :GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet pour lequel vous souhaitez récupérer 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.instance.IdleResourceRecommender/config
La commande renvoie la configuration de l'outil de recommandation, y compris le sous-champ
params.observation_period
que vous pouvez modifier.{ "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "1209600s" } }, "etag": "\"2f3c9b65cda6a4ba\"", "updateTime": "2021-02-03T04:41:15.330351Z" }
Mettre à jour la configuration d'un projet
Pour mettre à jour la configuration de vos recommandations pour les VM inactives, modifiez la valeur de
observation_period
et importez la nouvelle configuration pour votre projet.Vous pouvez définir la période d'observation sur une valeur comprise entre un jour et 14 jours, en utilisant une chaîne contenant le nombre total de secondes, suivie de la lettre
s
.- Pour une période d'observation d'un jour, utilisez
"86400s"
. - Pour une période d'observation de 14 jours, utilisez
"1209600s"
.
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.
gcloud
Pour mettre à jour les paramètres de configuration, exécutez la commande
gcloud recommender recommender-config update
et utilisezgoogle.compute.instance.IdleResourceRecommender
comme ID de l'outil de recommandation :gcloud recommender recommender-config update google.compute.instance.IdleResourceRecommender\ --project=PROJECT_ID \ --location=ZONE \ --config-file=CONFIG_FILE_PATH \ --etag=ETAG
Remplacez les éléments suivants :
PROJECT_ID
: ID de votre projetZONE
: zone pour laquelle vous souhaitez obtenir la configuration actuelleCONFIG_FILE_PATH
: chemin d'accès au fichier JSON contenant la configuration actuelleETAG
: valeur etag de la configuration actuelle
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 cinq jours, utilisez le fichier de configuration suivant :{ "params": { "observation_period": "432000s" } }
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.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "432000s" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2021-02-03T05:00:05Z" }
REST
Pour mettre à jour la configuration, utilisez la méthode
recommenders.updateConfig
et spécifiezgoogle.compute.instance.IdleResourceRecommender
comme ID de l'outil de recommandation :PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config { "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "1209600s" } }, "etag": "\"2f3c9b65cda6a4ba\"" }
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet pour lequel vous souhaitez modifier la configuration de l'outil de recommandationZONE
: 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.instance.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.instance.IdleResourceRecommender/config", "recommenderGenerationConfig": { "params": { "observation_period": "432000s" } }, "etag": "\"1245f9435cd01ea8\"", "updateTime": "2021-02-03T05:00:05Z" }
Étapes suivantes
- Découvrez comment afficher et appliquer des recommandations de VM inactives.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/19 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/19 (UTC)."],[[["This document outlines the process for viewing and modifying the configuration of idle VM recommendations, allowing users to customize these settings to better suit their needs."],["Idle VM recommendations are available as a Pre-GA offering, which means they are provided \"as is\" with potentially limited support, subject to the \"Pre-GA Offerings Terms\"."],["Users can adjust the `observation_period` parameter to determine the time frame used to identify idle VMs, with a range from 1 to 14 days."],["Configuring recommendations involves retrieving the current settings, editing the configuration file in JSON format, and then uploading the modified file, which takes up to 48 hours to implement."],["Authentication through gcloud CLI is required to interact with REST API samples, by installing, initializing and setting a region and zone for the project."]]],[]] -