Se usó la API de Cloud Translation para traducir esta página.

Configura las recomendaciones de reservas infrautilizadas

En esta página, se describe cómo ver y cambiar la configuración de tus recomendaciones de reservas infrautilizadas según demanda. 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 tomar medidas cuando recibes recomendaciones sobre reservas inactivas o infrautilizadas, consulta Visualiza y aplica las recomendaciones de reservas inactivas o Visualiza y aplica las recomendaciones de reservas infrautilizadas.

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 API de Google Cloud. 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
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.

Configura tus recomendaciones

Para configurar las recomendaciones de reservas infrautilizadas, 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 infrautilizadas de tu proyecto mediante Google Cloud CLI o REST.

Permisos necesarios para esta tarea

Para hacer esta tarea, debes tener los siguientes permisos:

recommender.computeRightSizeResourceRecommender.get en el proyecto.

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 usa google.compute.RightSizeResourceRecommender como el ID del recomendador:

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

Reemplaza lo siguiente:

Reemplaza ZONE por la zona que contiene reservas para enumerar las recomendaciones.
BILLING_ACCOUNT_ID por el ID de tu cuenta de facturación.

Por ejemplo:

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

El comando muestra la configuración del recomendador, incluidos los subcampos params.under_utilized_reservation_lookback_period y params.under_utilized_reservation_utilization_threshold modificables.

{
  "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

Para recuperar la configuración actual, usa el método recommenders.getConfig y especifica google.compute.RightSizeResourceRecommender como el ID del recomendador:

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

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.

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

El comando muestra la configuración del recomendador, incluidos los subcampos que puedes modificar: params.under_utilized_reservation_lookback_period y 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"
}

Actualiza la configuración de un proyecto

Para actualizar la configuración de las recomendaciones de VMs infrautilizadas, modifica el valor de under_utilized_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 y 30 máximo), seguido de D, 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".

Del mismo modo, establece el umbral de uso que activa una recomendación de reserva infrautilizada modificando el valor de under_utilized_reservation_utilization_threshold y sube la configuración nueva de tu proyecto, por ejemplo:

Para un umbral del 80%, "0.8".

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.

Permisos necesarios para esta tarea

Para hacer esta tarea, debes tener los siguientes permisos:

recommender.computeRightSizeResourceRecommender.get en el proyecto para ver la configuración.
recommender.computeRightSizeResourceRecommender.update en el proyecto para cambiar la configuración.

Completa esta tarea con uno de los siguientes métodos.

gcloud

Para actualizar los parámetros de configuración, usa el comando gcloud recommender recommender-config update y usa google.compute.RightSizeResourceRecommender como el ID del recomendador:

gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\
  --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 actual
CONFIG_FILE_PATH: Es la ruta al archivo JSON con la configuración actual
ETAG: El valor de etag de la configuración actual
BILLING_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 y el umbral de reserva infrautilizada en un 80%, usa el siguiente archivo de configuración:

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

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

Para actualizar la configuración, realiza una solicitud PATCH al método recommenders.updateConfig y especifica google.compute.RightSizeResourceRecommender como el ID del recomendador:

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\""
}

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.RightSizeResourceRecommender/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.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"
}

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