Recomendaciones de uso de la API

En esta página, se explica cómo ver y administrar recomendaciones en el recomendador mediante los comandos de gcloud o la API de REST.

La siguiente es una interacción de recomendación típica con la API del recomendador:

  1. Enumera las recomendaciones para un proyecto específico.

  2. Marca como claimed una recomendación que deseas aplicar o como dismissed una que no deseas aplicar.

  3. Aplica la recomendación. Puedes hacerlo automáticamente con Active Assist en la Google Cloud consola o de forma manual con los comandos de la Google Cloud CLI, las llamadas a la API de REST o cualquier otra herramienta.

    Cuando aplicas la recomendación de forma manual, los comandos o las llamadas que usas son específicos para el tipo de recurso. Por ejemplo, para cambiar el tamaño de una instancia de VM en respuesta a una recomendación del recomendador de tamaño de instancia de VM, usa los comandos gcloudde Compute Engine o las llamadas a la API de REST de Compute Engine.

    Cuando realizas estas operaciones, identificas el recurso de destino con el valor del campo resource en el array OperationsGroup de la entidad que se muestra Recommendation. Este campo tiene el siguiente formato:

    //API_NAME/RESOURCE_PATH

    Por ejemplo:

    //compute.googleapis.com/projects/example-project/zones/us-central1-a/instances/instance-1

  4. Marca la recomendación como succeeded o failed.

Ten en cuenta que las recomendaciones recuperadas con la API solo pueden interactuar a través de la API o BigQuery Export.

Para obtener información sobre cómo cambiar el estado de las recomendaciones en la Google Cloud consola, consulta la documentación de Active Assist o el recomendador apropiado.

Configura el proyecto predeterminado

Configura el proyecto predeterminado si aún no lo hiciste:

gcloud config set project PROJECT_ID

En el ejemplo anterior, PROJECT_ID es el ID de tu proyecto.

Configure las variables de entorno

Configura las variables de entorno para las interacciones del Recomendador:

PROJECT=TARGET_PROJECT_ID
LOCATION=LOCATION_ID
RECOMMENDER=RECOMMENDER_ID

Donde:

  • TARGET_PROJECT_ID es el proyecto cuyas recomendaciones deseas enumerar. Este puede ser un proyecto diferente del actual.

    • Para los comandos de gcloud, debes usar el ID del proyecto
    • Para las solicitudes a la API, puedes usar el número o el ID del proyecto. Se recomienda usar el número del proyecto.

    El número de proyecto se muestra en las respuestas de la API y los comandos de gcloud.

  • LOCATION_ID es la Google Cloud ubicación en la que se encuentran los recursos asociados con las recomendaciones (por ejemplo, global o us-central1-a).

  • RECOMMENDER_ID es el ID del recomendador completamente calificado (por ejemplo, google.compute.instance.MachineTypeRecommender).

Consulta