Recomendador de proyectos sin actividad

El recomendador de proyectos sin actividad analiza la actividad de uso de los proyectos de tu organización y ofrece recomendaciones que te ayudan a descubrir, recuperar o eliminar proyectos sin actividad.

Información general

En las organizaciones que evolucionan rápidamente, no es raro que se olviden de los recursos de la nube, incluidos proyectos enteros. Estos recursos desatendidos pueden ser difíciles de identificar y suelen provocar un desperdicio innecesario y riesgos de seguridad.

El recomendador de proyectos sin actividad analiza la actividad de uso de todos los proyectos de tu organización y te ofrece las siguientes funciones para ayudarte a descubrir, recuperar y cerrar proyectos sin actividad:

  • Estadísticas de uso de cada proyecto (redes, APIs, propietario del proyecto, actividad del servicio y más).
  • Recomendaciones para desactivar proyectos con poca actividad de uso.
  • Recomendaciones para asignar un nuevo propietario a proyectos que tengan una actividad de uso alta, pero ningún propietario activo.

Cerrar o reclamar proyectos desatendidos puede tener los siguientes efectos y ventajas para tu organización:

  • Reducción de los riesgos de seguridad (SECURITY)
  • Reducción del gasto innecesario (COST)
  • Reducción de la huella de carbono asociada a tus cargas de trabajo (SUSTAINABILITY)
Google Cloud

Cómo funciona

El recomendador de proyectos sin actividad analiza el uso de los proyectos durante los últimos 30 días. En la siguiente tabla se enumeran las recomendaciones y las estadísticas que puede generar el recomendador de proyectos desatendidos en función de si la actividad de uso es baja o alta .

Uso o tipo de proyecto Subtipo de estadística Recomendación Subtipo de recomendación
Proyectos con:
  • Uso bajo en los últimos 30 días
 PROJECT_ACTIVITY Revisa o elimina el proyecto. CLEANUP_PROJECT
Proyectos con:
  • Uso elevado en los últimos 30 días
  • Propietarios de usuarios asignados, pero ninguno de ellos está activo en el proyecto.
 PROJECT_ACTIVITY Recupera el proyecto asignando un nuevo propietario. RECLAIM_PROJECT
Todos los demás proyectos que no sean de Apps Script. PROJECT_ACTIVITY - -

Las recomendaciones y las estadísticas están disponibles en diferentes niveles de la jerarquía de tu organización de Cloud. Para acceder a esas recomendaciones y estadísticas, se necesita un enlace de rol de gestión de identidades y accesos en el nivel correspondiente:

  • A nivel de proyecto: los propietarios de proyectos pueden descubrir estadísticas y recomendaciones de los proyectos a los que tienen acceso y tomar medidas al respecto.
  • A nivel de organización: los administradores de la organización pueden descubrir y aplicar las estadísticas y recomendaciones de los proyectos de una organización en la nube.
  • A nivel de cuenta de facturación, los administradores de facturación pueden descubrir y aplicar las estadísticas y las recomendaciones de los proyectos asociados a una cuenta de facturación concreta.

Clasificar la actividad de uso de un proyecto

Un proyecto puede clasificarse como de actividad de uso baja o alta en función de las recomendaciones que se proporcionen. La clasificación de la actividad de uso de un proyecto se calcula en función del contenido incluido en la estadística de utilización del proyecto.

En el caso de los proyectos que se identifiquen con una actividad de uso baja, se aplicarán las siguientes condiciones:

Clasificación del uso Condición
Organizaciones que tienen más de 50 proyectos
  • Los proyectos se clasifican en función del nivel de actividad de uso de todo el contenido incluido en la estadística de utilización del proyecto.
  • Un proyecto se clasifica como desatendido si se encuentra dentro del 10% de la actividad de uso en comparación con todos los demás proyectos de esa organización.
Organizaciones que tienen menos de 50 proyectos
  • La media diaria de llamadas a la API consumidas por un proyecto (consumedApiDailyCount) es inferior a 100.
  • Registro de Cloud es el único servicio que usa un proyecto.
  • El resto de las estadísticas de uso del proyecto tienen un valor igual a cero.

Prioridad e impacto de las recomendaciones

Las recomendaciones de proyectos sin atender contienen los siguientes campos, que ayudan a priorizar y estimar las ventajas de aplicarlas:

  • priority: valor de prioridad entre P1 y P4, donde P1 es la prioridad más alta.
  • primaryImpact - SECURITY. Número de recomendaciones de seguridad de alta prioridad en un proyecto sin actividad.
  • additionalImpact(s) - COST y SUSTAINABILITY. La reducción de costes (en dólares) y de emisiones de sostenibilidad (en kgCO2e) que se conseguiría si se retirara el proyecto.

Prioridad de la recomendación

La prioridad de la recomendación de proyectos sin actividad va de P1 a P4, siendo P1 la prioridad más alta.

El recomendador empieza revisando las recomendaciones de seguridad de cada proyecto sin supervisión. A partir de ahí, asigna a la recomendación de proyecto sin actividad la misma prioridad que la recomendación de mayor prioridad que se haya encontrado en el proyecto. Por ejemplo, si un proyecto sin actividad tiene 10 recomendaciones de seguridad, 8 de prioridad 2 y 2 de prioridad 1, a la recomendación del proyecto sin actividad se le asignaría un valor de prioridad 1.

Las recomendaciones de seguridad más frecuentes en proyectos desatendidos proceden del recomendador de gestión de identidades y accesos. Una recomendación de proyecto sin actividad con prioridad P1 probablemente significa que hay un segmento de Cloud Storage de acceso público en el proyecto sin actividad (consulta más información sobre cómo establece las prioridades el Recomendador de gestión de identidades y accesos).

Impacto en la seguridad

El campo primaryImpact - SECURITY ofrece un securityProjection igual al número de recomendaciones de seguridad de alta prioridad (P2 y superior) del proyecto desatendido. Por ejemplo, si un proyecto tiene una recomendación para sustituir el rol de editor general por un rol más específico, esa recomendación tiene una prioridad P2 y se incluye en el priorityRecommendationCount.

Impacto en los costes

El campo additionalImpact - COST ofrece una costProjection que es una estimación del ahorro de costes si se elimina el proyecto no atendido. Esto se basa en los costes incurridos por los recursos que se han ejecutado en el proyecto desatendido durante los últimos 30 días.

Impacto en la sostenibilidad

El campo additionalImpact - SUSTAINABILITY ofrece una sustainabilityProjection que es una estimación de las emisiones de carbono que han contribuido los recursos que se ejecutan en el proyecto sin asistente durante los últimos 30 días. La estimación se mide en kilogramos de dióxido de carbono equivalente (kgCO2e).

Contenido de una estadística de uso del proyecto

El contenido de las estadísticas de uso de un proyecto son valores de campo que se usan para clasificar la actividad de uso del proyecto y generar recomendaciones CLEANUP_PROJECT o RECLAIM_PROJECT.

En la siguiente tabla se enumeran los distintos campos que muestra el recomendador como parte de la PROJECT_ACTIVITY estadística:

Campo Descripción
Nivel de uso
usagePercentile Percentil del nivel de uso de este proyecto en comparación con otros proyectos de la misma organización.

Si el percentil es -1, significa que el valor no se ha calculado. El valor no se calcula cuando las organizaciones tienen menos de 50 proyectos.

Actividad de la API
activeServiceAccountDailyCount Media diaria de cuentas de servicio con actividad de autenticación en este proyecto.
apiClientDailyCount Media diaria de clientes distintos de llamadas a la API producidas por este proyecto.
consumedApiDailyCount Media diaria de llamadas a la API consumidas por este proyecto.
datastoreApiDailyCount Media diaria de llamadas a la API de Datastore consumidas por este proyecto
Actividad de redes
vpcEgressDailyBytes Media diaria de bytes de salida de VPC de este proyecto.
vpcIngressDailyBytes Media diaria de bytes de entrada de VPC en este proyecto
Uso de facturación
hasBillingAccount Comprueba si el proyecto tiene una cuenta de facturación al final de la observación.
serviceWithBillableUsage Nombres de los servicios facturables utilizados en los últimos 30 días.
Uso de los servicios en la nube
activeAppengineInstanceDailyCount: system/instance_count Media diaria del número de instancias de App Engine de este proyecto
activeCloudsqlInstanceDailyCount Media diaria del número de instancias de Cloud SQL activas de este proyecto.
activeGceInstanceDailyCount Media diaria del número de instancias de Compute Engine de este proyecto.
bigqueryInflightJobDailyCount Media diaria de tareas de BigQuery en curso de este proyecto.
bigqueryInflightQueryDailyCount Media diaria del número de consultas de BigQuery en curso de este proyecto.
bigqueryStorageDailyBytes Media diaria del almacenamiento de BigQuery de este proyecto.
bigqueryTableDailyCount Media diaria del número de tablas de BigQuery de este proyecto.
gcsObjectDailyCount Media diaria del número de objetos de Cloud Storage de este proyecto.
gcsRequestDailyCount Media diaria del número de APIs de Cloud Storage de este proyecto.
gcsStorageDailyBytes Media diaria de bytes de almacenamiento usados por Cloud Storage en este proyecto.
Actividad de los usuarios
numActiveUserOwners Número de propietarios de proyectos de tipo de usuario activo al final del periodo de observación. Activo significa que la cuenta de usuario no está inhabilitada y que se ha identificado alguna actividad en este proyecto durante el periodo de observación.
owners Lista de propietarios de proyectos y sus actividades
Otros campos
hasActiveOauthTokens Comprueba si el proyecto tiene algún token de OAuth activo que se haya usado en los últimos 180 días.
carbonFootprintDailyKgCO2 Media diaria de las emisiones de carbono que ha generado este proyecto en función de los datos disponibles de los últimos 30 días.
costProjection Ahorro de costes previsto durante el periodo especificado si se eliminara el proyecto. Se muestra un precio según catálogo o personalizado en función de los permisos de la cuenta de facturación. Es una estimación basada en los datos disponibles de los últimos 30 días y no constituye una factura.
severity El severity se define con el valor correspondiente de la estadística de seguridad de mayor gravedad encontrada en el proyecto. Por ejemplo, según cómo establece las gravedades IAM Recommender para sus estadísticas, una gravedad CRITICAL en la estadística de proyecto desatendido probablemente significa que hay un segmento de Cloud Storage accesible públicamente en el proyecto desatendido.

Recomendaciones para eliminar un proyecto

Se recomienda eliminar un proyecto cuando tiene un uso bajo en los últimos 30 días y no se han usado tokens de OAuth en los últimos 180 días.

Recomendaciones para asignar un nuevo propietario a un proyecto

Te recomendamos que asignes un nuevo propietario a un proyecto cuando cumpla todas las condiciones que se indican a continuación:

  • Todos los propietarios asignados han estado inactivos en el proyecto durante los últimos 90 días o ya no trabajan en la empresa.
  • El proyecto tiene una actividad de uso alta.

Precios

Para obtener más información sobre los precios de Active Assist, consulta los precios de las recomendaciones.

Antes de empezar

Para poder ver las estadísticas y las recomendaciones, debes hacer lo siguiente:

  • Debe habilitar la API Recommender. Solo tienes que habilitar la API en un proyecto de facturación. Después, puedes usar el mismo proyecto de facturación para consultar recomendaciones y estadísticas de otros proyectos, de toda la organización o de la cuenta de facturación mediante la --billing-projectfuncionalidad de gcloud o de la API.
  • Asegúrate de que tienes asignado uno de estos roles obligatorios:
Descripción Roles
Ver recomendaciones recommender.projectUtilViewer
Ver y actualizar recomendaciones recommender.projectUtilAdmin
Inhabilitar las estadísticas y las recomendaciones en el Centro de transparencia y control dataprocessing.admin

Estos roles proporcionan un conjunto de permisos que le permiten acceder a las estadísticas y las recomendaciones. Para obtener más información sobre los roles, consulta los artículos sobre la descripción de roles y la concesión de permisos de gestión de identidades y accesos.

Si asignas estos roles a nivel de organización, podrás acceder a las recomendaciones y las estadísticas de los proyectos de la organización de forma individual o colectiva (todos los proyectos desatendidos de la organización) mediante la API a nivel de organización.

Si asignas estos roles a nivel de cuenta de facturación, podrás acceder a las recomendaciones y las estadísticas de los proyectos que usen la cuenta de facturación especificada.

Para obtener más información sobre cómo inhabilitar esta función, consulta el artículo Inhabilitar estadísticas y recomendaciones.

ID de recomendador

Estos son el ID del recomendador de proyectos sin actividad y el tipo de estadística:

  • google.resourcemanager.projectUtilization.Recommender
  • google.resourcemanager.projectUtilization.Insight

Permisos de gestión de identidades y accesos necesarios

Para acceder a la lista de recomendaciones y estadísticas, se necesitan los siguientes permisos:

  • recommender.resourcemanagerProjectUtilizationRecommendations.get
  • recommender.resourcemanagerProjectUtilizationRecommendations.list
  • recommender.resourcemanagerProjectUtilizationInsights.get
  • recommender.resourcemanagerProjectUtilizationInsights.list

Para actualizar las recomendaciones y las estadísticas (por ejemplo, para rechazar una recomendación), se necesitan los siguientes permisos:

  • recommender.resourcemanagerProjectUtilizationRecommendations.update
  • recommender.resourcemanagerProjectUtilizationInsights.update

Ver recomendaciones de proyectos sin actividad

En esta sección se describe cómo comprobar las estadísticas y recomendaciones sin supervisión mediante gcloud y cómo usar curl para enviar solicitudes a la API Recommender.

gcloud

Para ver recomendaciones y estadísticas con gcloud, sigue estos pasos. Para obtener más información, consulta Usar la API: Estadísticas y Usar la API: Recomendaciones.

Recomendaciones

  1. Para enumerar las recomendaciones de proyectos sin actividad del proyecto en el que has habilitado la API Recommender, ejecuta el siguiente comando:

      gcloud recommender recommendations list \
  --project=PROJECT_ID \
  --location=global \
  --recommender=google.resourcemanager.projectUtilization.Recommender

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto.

  2. Para enumerar las recomendaciones de proyectos sin actividad en otro proyecto mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

      gcloud recommender recommendations list \
  --billing-project=BILLING_PROJECT_ID \
  --project=PROJECT_ID \
  --location=global \
  --recommender=google.resourcemanager.projectUtilization.Recommender

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (sería el mismo PROJECT_ID que se indica en el paso anterior).
    • PROJECT_ID: ID de otro proyecto del que quieras ver las recomendaciones de proyectos sin actividad.

  3. Para enumerar las recomendaciones de proyectos no atendidos de toda la organización, ejecuta el siguiente comando en un proyecto en el que hayas habilitado la API Recommender (como en el paso anterior):

      gcloud recommender recommendations list \
  --billing-project=BILLING_PROJECT_ID \
  --organization=ORGANIZATION_ID \
  --location=global \
  --recommender=google.resourcemanager.projectUtilization.Recommender

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • ORGANIZATION_ID: ID de la organización de la que quieres ver las recomendaciones de proyectos sin actividad.

  4. Para enumerar las recomendaciones de proyectos no atendidas que usan una cuenta de facturación específica, ejecuta el siguiente comando en un proyecto en el que hayas habilitado la API Recommender (como en el paso anterior):

      gcloud recommender recommendations list \
  --billing-project=BILLING_PROJECT_ID \
  --billing-account=BILLING_ACCOUNT_ID \
  --location=global \
  --recommender=google.resourcemanager.projectUtilization.Recommender

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • BILLING_ACCOUNT_ID: el ID de tu Google Cloud cuenta de facturación.

Estadísticas

  1. Para enumerar las estadísticas de uso de un proyecto concreto, ejecuta el siguiente comando:

      gcloud recommender insights list \
  --project=PROJECT_ID \
  --location=global \
  --insight-type=google.resourcemanager.projectUtilization.Insight

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto.

  2. Para consultar estadísticas de uso de otro proyecto, mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

      gcloud recommender insights list \
  --billing-project=BILLING_PROJECT_ID \
  --project=PROJECT_ID \
  --location=global \
  --insight-type=google.resourcemanager.projectUtilization.Insight

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • PROJECT_ID: ID de otro proyecto del que quieras ver las estadísticas del recomendador de proyectos sin actividad.

  3. Para consultar las estadísticas de uso de toda la organización, mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

      gcloud recommender insights list \
  --billing-project=BILLING_PROJECT_ID \
  --organization=ORGANIZATION_ID \
  --location=global \
  --insight-type=google.resourcemanager.projectUtilization.Insight

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • ORGANIZATION_ID: ID de la organización de la que quieres ver las estadísticas de uso.

  4. Para enumerar las estadísticas de uso que utilizan una cuenta de facturación específica, mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

      gcloud recommender insights list \
  --billing-project=BILLING_PROJECT_ID \
  --billing-account=BILLING_ACCOUNT_ID \
  --location=global \
  --insight-type=google.resourcemanager.projectUtilization.Insight

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • BILLING_ACCOUNT_ID: el ID de tu Google Cloud cuenta de facturación.

API

Para ver recomendaciones y estadísticas, puede usar curl para enviar una solicitud a las APIs de Recommender. Para autorizar solicitudes desde la línea de comandos, debes usar tokens de acceso de OAuth. Un token de acceso OAuth es una cadena que otorga acceso temporal a una API.

Recomendaciones

  1. Para enumerar las recomendaciones de proyectos sin actividad del proyecto en el que has habilitado la API Recommender, ejecuta el siguiente comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"

    Haz los cambios siguientes:

    • PROJECT_ID`: el ID del proyecto.

  2. Para enumerar las recomendaciones de proyectos sin actividad en otro proyecto mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)"  \
-H "x-goog-user-project: BILLING_PROJECT_ID" \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (sería el mismo PROJECT_ID que se indica en el paso anterior).
    • PROJECT_ID: ID de otro proyecto del que quieras ver las recomendaciones de proyectos sin actividad.

  3. Para enumerar las recomendaciones de proyectos no atendidos de toda la organización, ejecuta el siguiente comando en un proyecto en el que hayas habilitado la API Recommender (como en el paso anterior):

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)"  \
-H "x-goog-user-project: BILLING_PROJECT_ID" \
"https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • ORGANIZATION_ID: ID de la organización de la que quieres ver las recomendaciones de proyectos sin actividad.

  4. Para enumerar las recomendaciones de proyectos no atendidas que usan una cuenta de facturación específica, ejecuta el siguiente comando en un proyecto en el que hayas habilitado la API Recommender (como en el paso anterior):

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)"  \
-H "x-goog-user-project: BILLING_PROJECT_ID" \
"https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • BILLING_ACCOUNT_ID: el ID de tu Google Cloud cuenta de facturación.

Estadísticas

  1. Para enumerar las estadísticas de uso de un proyecto concreto, ejecuta el siguiente comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global\
/insightTypes/google.resourcemanager.projectUtilization.Insight/insights"

    Haz los cambios siguientes:

    • PROJECT_ID`: el ID del proyecto.

  2. Para consultar estadísticas de uso de otro proyecto, mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: BILLING_PROJECT_ID/" \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID//locations/global\
/insightTypes/google.resourcemanager.projectUtilization.Insight/insights"

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • PROJECT_ID: ID de otro proyecto del que quieras ver las estadísticas del recomendador de proyectos sin actividad.

  3. Para consultar las estadísticas de uso de toda la organización, mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)"  \
-H "x-goog-user-project: PROJECT_ID/" \
"https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
insightTypes/google.resourcemanager.projectUtilization.Insight/insights"

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • ORGANIZATION_ID: ID de la organización de la que quieres ver las recomendaciones de proyectos sin actividad.

  4. Para enumerar las estadísticas de uso que utilizan una cuenta de facturación específica, mientras usas un proyecto en el que has habilitado la API Recommender (como en el paso anterior), ejecuta el siguiente comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)"  \
-H "x-goog-user-project: PROJECT_ID/" \
"https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
insightTypes/google.resourcemanager.projectUtilization.Insight/insights"

    Haz los cambios siguientes:

    • BILLING_PROJECT_ID: el ID del proyecto en el que has habilitado la API Recommender (será el mismo PROJECT_ID que se ha indicado en el paso anterior).
    • BILLING_ACCOUNT_ID: el ID de tu Google Cloud cuenta de facturación.

Configurar parámetros de recomendación

En esta sección se describe cómo ver y configurar este recomendador con gcloud y curl.

En la siguiente tabla se enumeran varios parámetros que se pueden configurar:

Parámetro Descripción Valores esperados
minimum_observation_period El periodo de observación mínimo define el número de días de actividad del proyecto que se deben analizar antes de generar una recomendación.

Actualmente, solo se puede definir este valor a nivel de organización.

"P30D"[DEFAULT], "P60D", "P90D", "P180D", "P270D", "P365D"

gcloud

Para ver y actualizar las configuraciones de las recomendaciones con gcloud, sigue los pasos que se indican a continuación.

Ver configuraciones

  1. Para ver las configuraciones del recomendador de proyectos sin actividad de una organización concreta, ejecuta el siguiente comando desde un proyecto que pertenezca a esa organización y que tenga habilitada la API Recommender:

    gcloud beta recommender recommender-config describe \
google.resourcemanager.projectUtilization.Recommender \
--organization=ORGANIZATION_ID \
--location=global

    Haz los cambios siguientes:

    • ORGANIZATION_ID: el ID de la organización.

  2. Ejemplo: 

    etag: ETAG
name: organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
recommenderGenerationConfig:
  params:
    minimum_observation_period: P30D
revisionId: DEFAULT
updateTime: '2022-04-19T00:57:55Z'

    Anota el valor de ETAG:

    • ETAG: este valor se usará en recommender-config update.

Actualizando configuraciones

  1. Para actualizar las configuraciones de Recomendador de proyectos sin actividad de una organización, elige un proyecto de esa organización en el que hayas habilitado la API Recommender y crea un archivo config.gcloud:

    
{
 "params": {
    "minimum_observation_period": DURATION
  }
}

    Haz los cambios siguientes:

    • DURATION: uno de los valores "P30D", "P60D", "P90D", "P180D", "P270D" o "P365D"

  2. Ejecuta el siguiente comando:

    gcloud beta recommender recommender-config update \
google.resourcemanager.projectUtilization.Recommender \
--organization=ORGANIZATION_ID \
--location=global \
--config-file=config.gcloud \
--etag=ETAG

    Haz los cambios siguientes:

    • ORGANIZATION_ID: el ID de la organización.
    • ETAG: valor de etag que se ha devuelto de recommender-config describe.

API

Para ver y actualizar las configuraciones de los recomendadores, puede usar curl para enviar una solicitud a las APIs Recommender. Para autorizar solicitudes desde la línea de comandos, debes usar tokens de acceso de OAuth. Un token de acceso OAuth es una cadena que otorga acceso temporal a una API.

Ver configuraciones

  1. Para ver las configuraciones del recomendador de proyectos sin actividad de una organización concreta, ejecuta el siguiente comando desde un proyecto que pertenezca a esa organización y que tenga habilitada la API Recommender:

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto.
    • ORGANIZATION_ID: el ID de la organización.

  2. Ejemplo:

    
{
  "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "minimum_observation_period": "P60D"
    }
  },
  "etag": ETAG,
  "updateTime": "2022-04-21T18:51:17.407255Z",
  "revisionId": "75c3b0d7"
}

    Anota el valor de ETAG:

    • ETAG: este valor se usará en curl PATCH.

Actualizando configuraciones

  1. Para actualizar las configuraciones de Recomendador de proyectos sin actividad de una organización, elige un proyecto de esa organización en el que hayas habilitado la API Recommender y crea un archivo request.json:

    
{
  "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "minimum_observation_period": DURATION
    }
  },
"etag": ETAG,
}

    Haz los cambios siguientes:

    • DURATION: uno de los valores "P30D", "P60D", "P90D", "P180D", "P270D" o "P365D"
    • ETAG: valor de etag que se ha devuelto de CURL get.

  2. Ejecuta la siguiente línea de comandos:

    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" -d @request.json \
https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto.
    • ORGANIZATION_ID: el ID de la organización.

Siguientes pasos