En esta página, se describe cómo ver y cambiar la configuración de tus recomendaciones de reservas inactivas a pedido. Te recomendamos cambiar la configuración para aumentar la cantidad de recomendaciones que recibes o si deseas obtener menos recomendaciones para borrar las reservas que planeas usar.
- Si deseas obtener más información sobre los parámetros que puedes usar para personalizar las recomendaciones, consulta Elige los parámetros de configuración adecuados.
- Para obtener más información sobre cómo identificar la reserva según demanda inactiva y tomar medidas, consulta Visualiza y aplica las recomendaciones de reservas inactivas.
Antes de comenzar
-
Si aún no lo hiciste, configura la autenticación.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Trusted Cloud by S3NS .
Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
gcloud
-
Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando:
gcloud init
- Set a default region and zone.
REST
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a gcloud CLI.
Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando:
gcloud init
Si deseas obtener más información, consulta Autentica para usar REST en la Trusted Cloud documentación de autenticación.
Configura tus recomendaciones
Para configurar las recomendaciones de reservas inactivas, haz lo siguiente:
- Obtén la configuración actual para obtener el archivo JSON de la configuración.
- Cambia el archivo de configuración en formato JSON.
- Sube el archivo de configuración nuevo para aplicar los cambios.
Obtén la configuración actual
Puedes obtener la configuración actual para las recomendaciones de VMs inactivas de tu proyecto mediante Google Cloud CLI o REST.
Completa esta tarea con uno de los siguientes métodos.
gcloud
Para obtener los parámetros de configuración actuales, usa el comando
gcloud recommender recommender-config describe
y usagoogle.compute.IdleResourceRecommender
como el ID del recomendador:gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \ --location=ZONE --billing-account=BILLING_ACCOUNT_ID
Reemplaza
ZONE
por la zona para la que deseas obtener la configuración actual.Por ejemplo:
gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \ --location=us-central1-c --billing-account=my-billing-account-id
Con el comando, se muestra la configuración del recomendador, incluido el subcampo modificable
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
Para recuperar la configuración actual, usa el método
recommenders.getConfig
y especificagoogle.compute.IdleResourceRecommender
como el ID del recomendador:GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config
Reemplaza
ZONE
por la zona que contiene tu proyecto.En la línea de comandos, ejecuta el siguiente comando para obtener la configuración del recomendador para un proyecto:
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
Con el comando, se muestra la configuración del recomendador, incluido el subcampo que puedes cambiar:
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" }
Actualiza la configuración de un proyecto
Para actualizar la configuración de las recomendaciones de VMs inactivas, modifica el valor de
idle_reservation_lookback_period
y sube la configuración nueva del proyecto.Puedes configurar el período de observación en un valor de 7 días hasta 30 días, mediante una cadena que comienza con
P
, luego un número entero para la cantidad de días (7
mínimo y30
máximo), seguido deD
, por ejemplo:- Para un período de observación de 7 días, usa
"P7D"
. - Para un período de observación de 30 días, usa
"P30D"
.
Después de subir la configuración nueva, lleva alrededor de 48 horas para que se aplique. Hasta ese momento, las recomendaciones generadas usan la configuración anterior.
gcloud
Para actualizar los parámetros de configuración, usa el comando
gcloud recommender recommender-config update
y usagoogle.compute.IdleResourceRecommender
como el ID del recomendador:gcloud recommender recommender-config update google.compute.IdleResourceRecommender\ --location=ZONE \ --config-file=CONFIG_FILE_PATH \ --etag=ETAG \ --billing-account=BILLING_ACCOUNT_ID
Reemplaza lo siguiente:
ZONE
: La zona para la que deseas obtener la configuración actualCONFIG_FILE_PATH
: Es la ruta al archivo JSON con la configuración actualETAG
: El valor de etag de la configuración actualBILLING_ACCOUNT_ID
: El ID de la cuenta de facturación
En el archivo de configuración, especifica solo el objeto
recommenderGenerationConfig
con los parámetros de configuración actualizados. Por ejemplo, para especificar un período de observación de 21 días, usa el siguiente archivo de configuración:{ "params": { "idle_reservation_lookback_period": "P21D" } }
Si el comando se ejecuta de forma correcta, muestra un cuerpo de respuesta similar al siguiente, que muestra la configuración nueva con los parámetros que acabas de cambiar.
{ "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
Para actualizar la configuración, realiza una solicitud
PATCH
al métodorecommenders.updateConfig
y especificagoogle.compute.IdleResourceRecommender
como el ID del recomendador: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\"" }
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID del proyecto para el que deseas cambiar la configuración del recomendador.ZONE
: La zona que contiene tu proyecto.
Guarda el cuerpo de la solicitud en un archivo, por ejemplo,
config.json
. Luego, puedes hacer referencia al archivo cuando actualizas la configuración del recomendador de tu proyecto mediante un comando similar al siguiente: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
El comando
POST
muestra un cuerpo de respuesta similar al siguiente y muestra la configuración nueva con los parámetros que acabas de cambiar.{ "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" }
¿Qué sigue?
- Obtén más información para ver y aplicar recomendaciones de reservas inactivas.
- Obtén más información para ver y aplicar recomendaciones de reservas inactivas.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-18 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-18 (UTC)"],[[["\u003cp\u003eThis document explains how to view and modify the configuration for idle, on-demand reservation recommendations, which is a pre-GA offering subject to specific terms and limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can adjust the number of idle reservation recommendations you receive by modifying the configuration parameters, with detailed instructions provided on selecting the right parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe configuration process involves obtaining the current configuration, editing the JSON file to change the \u003ccode\u003eidle_reservation_lookback_period\u003c/code\u003e parameter within the 7 to 30 day range, and then uploading the new configuration.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication is required, and this can be done via the gcloud CLI or the REST API, with specific instructions for each method included in this document.\u003c/p\u003e\n"],["\u003cp\u003eAfter updating the configuration, it takes about 48 hours for the changes to take effect on generated recommendations, and the \u003ccode\u003eetag\u003c/code\u003e value changes each time you update the configuration.\u003c/p\u003e\n"]]],[],null,[]] -