Configurer Gemini Cloud Assist dans Cloud Billing

Pour configurer Gemini Cloud Assist dans la facturation Cloud, procédez comme suit:

  1. Activez l'API Gemini Cloud Assist dans un projet Google Cloud. Cette étape est généralement effectuée par un administrateur.

  2. Dans le projet Google Cloud, attribuez des rôles IAM (Identity and Access Management) aux mêmes utilisateurs qui accèdent aux rapports Cloud Billing. Cette étape est généralement effectuée par un administrateur.

  3. Pour les utilisateurs qui ont besoin d'accéder aux rapports Cloud Billing et à Gemini Cloud Assist dans Cloud Billing, attribuez des rôles IAM dans le compte de facturation Cloud associé au projet où l'API Gemini Cloud Assist est activée. Cette étape est généralement effectuée par un administrateur.

Activer l'API Gemini Cloud Assist dans un projet Google Cloud

Cette section décrit les étapes requises pour activer l'API Gemini Cloud Assist dans un projet Google Cloud.

Console

  1. Pour activer l'API Gemini Cloud Assist, accédez à la page API Gemini Cloud Assist.

    Accéder à l'API Gemini Cloud Assist

  2. Dans le sélecteur de projet, sélectionnez un projet.

    Pour les utilisateurs de Cloud Billing disposant d'autorisations au niveau du compte de facturation sur le compte de facturation Cloud, nous vous recommandons d'utiliser un projet d'administration FinOps pour contenir l'API.

  3. Cliquez sur Activer.

    La page est mise à jour et affiche l'état API activée.

gcloud

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

    Activate Cloud Shell

  2. Dans le menu de sélection du projet, sélectionnez un projet.

    Pour les utilisateurs de Cloud Billing disposant d'autorisations au niveau du compte de facturation sur le compte de facturation Cloud, nous vous recommandons d'utiliser un projet d'administration FinOps pour contenir l'API.

  3. Activez l'API Gemini Cloud Assist à l'aide de la commande gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    Si vous souhaitez activer l'API Gemini Cloud Assist dans un autre projet Google Cloud, ajoutez le paramètre --project:

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

    Remplacez PROJECT_ID par l'ID de votre projet Google Cloud.

    Le résultat ressemble à ce qui suit :

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

Une fois que vous avez activé l'API Gemini Cloud Assist dans le projet Google Cloud spécifié, Gemini Cloud Assist est disponible pour tous les utilisateurs disposant des rôles IAM requis pour le projet spécifié.

Attribuer des rôles IAM dans un projet Google Cloud

Cette section décrit les étapes à suivre pour accorder les autorisations de projet requises pour utiliser Gemini Cloud Assist. Dans le projet Google Cloud dans lequel vous avez activé l'API Gemini Cloud Assist, attribuez les rôles IAM suivants aux utilisateurs (principaux) du projet:

  • Utilisateur Gemini Cloud Assist
  • Consommateur Service Usage

Console

  1. Pour attribuer les rôles IAM requis pour utiliser Gemini Cloud Assist, accédez à la page IAM et administration.

    Accéder à IAM et administration

  2. Dans la colonne Compte principal, recherchez un compte principal pour lequel vous souhaitez activer l'accès à Gemini Cloud Assist, puis cliquez sur Modifier le compte principal sur cette ligne.

  3. Dans le volet Modifier les accès, cliquez sur Ajouter un autre rôle.

  4. Dans Sélectionner un rôle, sélectionnez Utilisateur de Gemini Cloud Assist.

  5. Cliquez sur Ajouter un autre rôle, puis sélectionnez Consommateur Service Usage.

  6. Cliquez sur Enregistrer.

gcloud

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

    Activate Cloud Shell

  2. Dans le menu de sélection du projet, sélectionnez un projet.

  3. Attribuez le rôle Utilisateur de Gemini Cloud Assist:

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

    Remplacez PRINCIPAL par l'identifiant du compte principal. L'identifiant se présente sous la forme user|group|serviceAccount:email ou domain:domain (par exemple, user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com ou domain:example.domain.com.

    Le résultat est une liste de liaisons de stratégie qui incluent les éléments suivants :

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

  4. Attribuez le rôle Consommateur Service Usage:

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

    Le résultat est une liste de liaisons de stratégie qui incluent les éléments suivants :

    - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

Pour en savoir plus, consultez les sections Attribuer un rôle unique et gcloud projects add-iam-policy-binding.

Tous les utilisateurs (principaux) auxquels ces rôles sont attribués peuvent accéder aux fonctionnalités Gemini Cloud Assist dans la console Google Cloud du projet spécifié. Si les utilisateurs du projet ont également accès aux rapports Cloud Billing, ils peuvent utiliser Gemini Cloud Assist dans les rapports Cloud Billing pour obtenir une assistance par IA pour créer des rapports sur les coûts et résumer les principaux insights issus de ces rapports. Pour en savoir plus, consultez la présentation de Gemini Cloud Assist dans Cloud Billing.

Tâches de configuration IAM avancées pour les projets

Au lieu d'utiliser la console Google Cloud ou la CLI gcloud pour attribuer des rôles IAM prédéfinis à un projet, vous pouvez effectuer l'une des opérations suivantes:

  • Utilisez les API REST IAM ou les bibliothèques clientes IAM pour accorder des rôles.

    Si vous utilisez ces interfaces, utilisez les noms de rôle complets:

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

    Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

  • Créez et accordez des rôles personnalisés.

    Les rôles personnalisés que vous créez pour les autorisations de projet ont besoin des autorisations suivantes pour accéder à Gemini Cloud Assist:

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

Attribuer des rôles IAM dans un compte Cloud Billing

Pour les utilisateurs qui ont besoin d'accéder aux rapports Cloud Billing, vous devez accorder des autorisations sur le compte de facturation Cloud suffisantes pour accéder à la page Rapports. Pour utiliser Gemini Cloud Assist dans le rapport de facturation, accordez un accès au compte de facturation Cloud associé au projet sur lequel l'API Gemini Cloud Assist est activée.

Étape suivante