Configurare Gemini Cloud Assist in Fatturazione Cloud

Per configurare Gemini Cloud Assist in Cloud Billing, segui questi passaggi:

  1. Abilita l'API Gemini Cloud Assist in un progetto Google Cloud . In genere questo passaggio viene eseguito da un amministratore.

  2. Nel progetto Google Cloud , concedi ruoli Identity and Access Management (IAM) agli stessi utenti che accedono ai dati di costo e utilizzo del fatturazione Cloud. In genere questo passaggio viene eseguito da un amministratore.

  3. Per gli utenti che hanno bisogno di accedere ai dati di fatturazione Cloud e a Gemini Cloud Assist in fatturazione Cloud, concedi i ruoli IAM nell'account di fatturazione Cloud collegato al progetto in cui è abilitata l'API Gemini Cloud Assist. In genere, questo passaggio viene eseguito da un amministratore.

Abilita l'API Gemini Cloud Assist in un progetto Google Cloud

Questa sezione descrive i passaggi necessari per abilitare l'API Gemini Cloud Assist in un progetto Google Cloud .

Console

  1. Per abilitare l'API Gemini Cloud Assist, vai alla pagina API Gemini Cloud Assist.

    Vai all'API Gemini Cloud Assist

  2. Nel selettore dei progetti, seleziona il progetto che vuoi utilizzare come progetto "Gemini".

    Puoi abilitare l'API Gemini Cloud Assist in più di un progetto. Per gli utenti della fatturazione Cloud che dispongono di autorizzazioni a livello di account di fatturazione sull'account di fatturazione Cloud, ti consigliamo di utilizzare un progetto di amministrazione FinOps per contenere l'API.

  3. Fai clic su Attiva.

    La pagina si aggiorna e mostra lo stato API abilitata.

gcloud

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

    Activate Cloud Shell

  2. Nel menu del selettore dei progetti, seleziona il progetto che vuoi utilizzare come progetto "Gemini".

    Puoi abilitare l'API Gemini Cloud Assist in più di un progetto. Per gli utenti della fatturazione Cloud che dispongono di autorizzazioni a livello di account di fatturazione sull'account di fatturazione Cloud, ti consigliamo di utilizzare un progetto di amministrazione FinOps per contenere l'API.

  3. Abilita l'API Gemini Cloud Assist utilizzando il comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com
    

    Se vuoi abilitare l'API Gemini Cloud Assist in un altro progettoGoogle Cloud , aggiungi il parametro --project:

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

    Sostituisci PROJECT_ID con l'ID progetto Google Cloud .

    L'output è simile al seguente:

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

Dopo aver abilitato l'API Gemini Cloud Assist nel progettoGoogle Cloud specificato, Gemini Cloud Assist è ora disponibile per tutti gli utenti che dispongono dei ruoli IAM richiesti nel progetto specificato.

Concedi ruoli IAM in un progetto Google Cloud

Questa sezione descrive i passaggi per concedere le autorizzazioni di progetto richieste per utilizzare Gemini Cloud Assist. Nel progetto Google Cloud in cui hai abilitato l'API Gemini Cloud Assist, concedi i seguenti ruoli IAM agli utenti (principal) del progetto:

  • Gemini Cloud Assist User
  • Service Usage Consumer

Console

  1. Per concedere i ruoli IAM necessari per utilizzare Gemini Cloud Assist, vai alla pagina IAM e amministrazione.

    Vai a IAM e amministrazione

  2. Nella colonna Entità, individua un'entità per cui vuoi attivare l'accesso a Gemini Cloud Assist, quindi fai clic su Modifica entità in quella riga.

  3. Nel riquadro Modifica accesso, fai clic su Aggiungi un altro ruolo.

  4. In Seleziona un ruolo, seleziona Utente Gemini Cloud Assist.

  5. Fai clic su Aggiungi un altro ruolo e seleziona Service Usage Consumer.

  6. Fai clic su Salva.

gcloud

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

    Activate Cloud Shell

  2. Nel menu del selettore dei progetti, seleziona un progetto.

  3. Concedi il ruolo Gemini Cloud Assist User:

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo progettoGoogle Cloud ,ad esempio 1234567890.
    • PRINCIPAL: l'identificatore del principal, ad esempio user:cloudysanfrancisco@gmail.com.

    L'output è un elenco di associazioni di criteri che include quanto segue:

    - members:
      - user:PRINCIPAL
      role: roles/geminicloudassist.user
    
  4. Ripeti il passaggio precedente per il ruolo roles/serviceusage.serviceUsageConsumer.

Per ulteriori informazioni, vedi Concedere un singolo ruolo e gcloud projects add-iam-policy-binding.

Tutti gli utenti (principal) a cui vengono concessi questi ruoli possono accedere alle funzionalità di Gemini Cloud Assist nella console Google Cloud all'interno del progetto specificato. Se gli utenti del progetto hanno anche accesso alla visualizzazione dei dati di fatturazione Cloud, possono utilizzare Gemini Cloud Assist in Report di fatturazione Cloud e in FinOps Hub per ricevere assistenza basata sull'AI per creare report sui costi e per riepilogare gli approfondimenti chiave sui costi del cloud e i suggerimenti per l'ottimizzazione. Per saperne di più, vedi Panoramica di Gemini Cloud Assist in Fatturazione Cloud.

Attività di configurazione IAM avanzata per i progetti

Anziché utilizzare la console Google Cloud o gcloud CLI per concedere ruoli IAM predefiniti a un progetto, puoi eseguire una delle seguenti operazioni:

  • Utilizza le API REST IAM o le librerie client IAM per concedere i ruoli.

    Se utilizzi queste interfacce, utilizza i nomi dei ruoli completi:

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

    Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

  • Crea e concedi ruoli personalizzati.

    Tutti i ruoli personalizzati per le autorizzazioni progetto che crei devono disporre delle seguenti autorizzazioni per accedere a Gemini Cloud Assist:

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

Concedi ruoli IAM in un account di fatturazione Cloud

Per gli utenti che devono accedere ai dati sui costi di fatturazione Cloud, devi concedere autorizzazioni sull'account di fatturazione Cloud adeguate per accedere alla pagina Report e all'hub FinOps. Per utilizzare Gemini Cloud Assist in Cloud Billing, concedi agli utenti l'accesso all'account di fatturazione Cloud che è collegato al progetto in cui è abilitata l'API Gemini Cloud Assist.

Passaggi successivi