Configurar Gemini Cloud Assist en Facturación de Cloud

Para configurar Gemini Cloud Assist en Facturación de Cloud, sigue estos pasos:

  1. Habilita la API Gemini Cloud Assist en un Google Cloud proyecto. Normalmente, un administrador lleva a cabo este paso.

  2. En el proyecto, concede roles de Gestión de Identidades y Accesos (IAM) Google Cloud a los mismos usuarios que acceden a los datos de costes y uso de la facturación de Cloud. Normalmente, un administrador lleva a cabo este paso.

  3. En el caso de los usuarios que necesiten acceder a los datos de Facturación de Cloud y a Gemini Cloud Assist en Facturación de Cloud, asigna roles de IAM en la cuenta de Facturación de Cloud que esté vinculada al proyecto en el que esté habilitada la API de Gemini Cloud Assist. Normalmente, un administrador lleva a cabo este paso.

Habilita la API Gemini Cloud Assist en un Google Cloud proyecto

En esta sección se describen los pasos necesarios para habilitar la API Gemini Cloud Assist en un proyecto de Google Cloud .

Consola

  1. Para habilitar la API de Gemini Cloud Assist, ve a la página de la API de Gemini Cloud Assist.

    Ir a la API Gemini Cloud Assist

  2. En el selector de proyectos, elige el proyecto que quieras usar como proyecto de Gemini.

    Puedes habilitar la API de Gemini Cloud Assist en más de un proyecto. Si eres usuario de Facturación de Cloud y tienes permisos a nivel de cuenta de facturación en la cuenta de facturación de Cloud, te recomendamos que uses un proyecto de administración de FinOps para contener la API.

  3. Haz clic en Enable (Habilitar).

    La página se actualiza y muestra el estado API habilitada.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. En el menú de selección de proyectos, elige el proyecto que quieras usar como proyecto de Gemini.

    Puedes habilitar la API de Gemini Cloud Assist en más de un proyecto. Si eres usuario de Facturación de Cloud y tienes permisos a nivel de cuenta de facturación en la cuenta de facturación de Cloud, te recomendamos que uses un proyecto de administración de FinOps para contener la API.

  3. Habilita la API Gemini Cloud Assist con el comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    Si quieres habilitar la API Gemini Cloud Assist en otro proyecto, añade el parámetroGoogle Cloud project--project:

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID

    Sustituye PROJECT_ID por el ID de tu proyecto. Google Cloud

    El resultado debería ser similar al siguiente:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Una vez que hayas habilitado la API de Gemini Cloud Assist en elGoogle Cloud proyecto especificado, Gemini Cloud Assist estará disponible para todos los usuarios que tengan los roles de IAM necesarios en ese proyecto.

Asignar roles de gestión de identidades y accesos en un Google Cloud proyecto

En esta sección se describen los pasos para conceder los permisos de proyecto necesarios para usar Gemini Cloud Assist. En el Google Cloud proyecto en el que hayas habilitado la API Gemini Cloud Assist, asigna los siguientes roles de IAM a los usuarios (principales) del proyecto:

  • Usuario de Gemini Cloud Assist
  • Consumidor del uso del servicio

Consola

  1. Para conceder los roles de gestión de identidades y accesos necesarios para usar Gemini Cloud Assist, ve a la página IAM y administración.

    Ir a IAM y administración

  2. En la columna Principal, busca un principal al que quieras dar acceso a Gemini Cloud Assist y, a continuación, haz clic en Editar principal en esa fila.

  3. En el panel Editar acceso, haz clic en Añadir otro rol.

  4. En Seleccionar un rol, selecciona Usuario de Gemini Cloud Assist.

  5. Haz clic en Añadir otro rol y selecciona Consumidor de uso de servicios.

  6. Haz clic en Guardar.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. En el menú de selección de proyectos, elige un proyecto.

  3. Asigna el rol Usuario de Gemini Cloud Assist:

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/geminicloudassist.user

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu Google Cloud proyecto, por ejemplo,1234567890.
    • PRINCIPAL: el identificador de la entidad principal. Por ejemplo, user:cloudysanfrancisco@gmail.com.

    El resultado es una lista de enlaces de políticas que incluye lo siguiente:

    - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.user

  4. Repite el paso anterior para el rol roles/serviceusage.serviceUsageConsumer.

    5. Para obtener más información, consulta los artículos Asignar un rol concreto y gcloud projects add-iam-policy-binding.

Todos los usuarios (principales) a los que se les concedan estos roles podrán acceder a las funciones de Gemini Cloud Assist en la consola de Google Cloud del proyecto especificado. Si los usuarios del proyecto también tienen acceso para ver los datos de Facturación de Cloud, pueden usar Gemini Cloud Assist en los informes de Facturación de Cloud y en FinOps Hub para obtener asistencia de la IA a la hora de crear informes de costes y resumir las estadísticas clave sobre los costes de la nube y las recomendaciones de optimización. Para obtener más información, consulta la descripción general de Gemini Cloud Assist en Facturación de Cloud.

Tareas de configuración avanzada de gestión de identidades y accesos para proyectos

En lugar de usar la Google Cloud consola o la CLI de gcloud para conceder roles de gestión de identidades y accesos predefinidos en un proyecto, puedes hacer lo siguiente:

  • Usa las APIs REST de IAM o las bibliotecas de cliente de IAM para asignar roles.

    Si utilizas estas interfaces, usa los nombres de rol completos:

    • roles/geminicloudassist.user
    • roles/serviceusage.serviceUsageConsumer

    Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

  • Crear y conceder roles personalizados.

    Los roles personalizados para los permisos de proyecto que crees deben tener los siguientes permisos para acceder a Gemini Cloud Assist:

    • geminicloudassist.companions.generateChat
    • geminicloudassist.companions.generateCode
    • serviceusage.services.use

Conceder roles de IAM en una cuenta de facturación de Cloud

Para los usuarios que necesiten acceder a los datos de costes de Facturación de Cloud, debes conceder permisos en la cuenta de Facturación de Cloud que sean adecuados para acceder a la página Informes y al centro de FinOps. Para usar Gemini Cloud Assist en Facturación de Cloud, concede acceso a los usuarios a la cuenta de facturación de Cloud que esté vinculada al proyecto en el que esté habilitada la API de Gemini Cloud Assist.

Siguientes pasos