Configurar o Gemini Cloud Assist no Cloud Billing

Para configurar o Gemini Cloud Assist no Cloud Billing, siga estas etapas:

  1. Ative a API Gemini Cloud Assist em um Google Cloud projeto. Geralmente, essa etapa é realizada por um administrador.

  2. No Google Cloud projeto, conceda papéis do Identity and Access Management (IAM) aos mesmos usuários que acessam os dados de custo e utilização do Cloud Billing data. Geralmente, essa etapa é realizada por um administrador.

  3. Para usuários que precisam acessar os dados do Cloud Billing e o Gemini Cloud Assist no Cloud Billing, conceda papéis do IAM na conta do Cloud Billing que está vinculada ao projeto em que a API Gemini Cloud Assist está ativada. Geralmente, essa etapa é realizada por um administrador.

Ativar a API Gemini Cloud Assist em um Google Cloud projeto

Esta seção descreve as etapas necessárias para ativar a API Gemini Cloud Assist em um Google Cloud projeto.

Console

  1. Para ativar a API Gemini Cloud Assist, acesse a página API Gemini Cloud Assist.

    Acessar a API Gemini Cloud Assist

  2. No seletor de projetos, escolha o projeto que você quer usar como um projeto "Gemini".

    É possível ativar a API Gemini Cloud Assist em mais de um projeto. Para usuários do Cloud Billing que têm permissões no nível da conta de faturamento na conta do Cloud Billing, recomendamos que você use um projeto de administração do FinOps para conter a API.

  3. Clique em Ativar.

    A página é atualizada e mostra o status API ativada.

gcloud

  1. No Google Cloud console, ative o Cloud Shell.

    Ativar o Cloud Shell

  2. No menu do seletor de projetos, escolha o projeto que você quer usar como um projeto "Gemini".

    É possível ativar a API Gemini Cloud Assist em mais de um projeto. Para usuários do Cloud Billing que têm permissões no nível da conta de faturamento na conta do Cloud Billing, recomendamos que você use um projeto de administração do FinOps para conter a API.

  3. Ative a API Gemini Cloud Assist usando o gcloud services enable comando:

    gcloud services enable geminicloudassist.googleapis.com

    Para ativar a API Gemini Cloud Assist em outro Google Cloud projeto, adicione o --project parâmetro:

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

    Substitua PROJECT_ID pelo Google Cloud ID do projeto.

    O resultado será assim:

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

Depois de ativar a API Gemini Cloud Assist no projeto especificado Google Cloud , o Gemini Cloud Assist vai estar disponível para todos os usuários que tiverem as funções de IAM necessárias no projeto especificado.

Conceder papéis do IAM em um Google Cloud projeto do

Esta seção descreve as etapas para conceder as permissões necessárias do projeto para usar o Gemini Cloud Assist. No Google Cloud projeto em que você ativou a API Gemini Cloud Assist, conceda os seguintes papéis do IAM aos usuários (principais) no projeto:

  • Usuário do Gemini Cloud Assist
  • Consumidor do Service Usage

Console

  1. Para conceder os papéis do IAM necessários para usar o Gemini Cloud Assist, acesse a página IAM e administrador.

    Acessar IAM e administrador

  2. Na coluna Principal, encontre um principal para o qual você quer ativar o acesso ao Gemini Cloud Assist e clique em Editar principal nessa linha.

  3. No painel Editar acesso, clique em Adicionar outro papel.

  4. Em Selecionar papel, selecione Usuário do Gemini Cloud Assist.

  5. Clique em Adicionar novo papel e selecione Consumidor do Service Usage.

  6. Clique em Salvar.

gcloud

  1. No Google Cloud console, ative o Cloud Shell.

    Ativar o Cloud Shell

  2. No menu do seletor de projetos, selecione um projeto.

  3. Conceda o papel Usuário do Gemini Cloud Assist:

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

    Substitua:

    • PROJECT_ID: o ID do projetoGoogle Cloud . Por exemplo, 1234567890.
    • PRINCIPAL: o identificador do principal. Por exemplo, user:cloudysanfrancisco@gmail.com.

    A saída é uma lista de vinculações de política que inclui o seguinte:

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

  4. Repita a etapa anterior para o papel roles/serviceusage.serviceUsageConsumer.

Para mais informações, consulte Conceder um único papel e gcloud projects add-iam-policy-binding.

Todos os usuários (principais) que receberem essas funções poderão acessar os recursos do Gemini Cloud Assist no Google Cloud console. Se os usuários também tiverem acesso para ver dados do Cloud Billing , eles poderão usar o Gemini Cloud Assist nos relatórios do Cloud Billing e no hub do FinOps para receber assistência de IA na criação de relatórios de custos e para resumir os principais insights sobre custos na nuvem e recomendações de otimização. Para mais informações, consulte Visão geral do Gemini Cloud Assist no Cloud Billing.

Tarefas avançadas de configuração do IAM para projetos

Em vez de usar o Google Cloud console ou a CLI gcloud para conceder papéis predefinidos do IAM em um projeto, faça o seguinte:

  • Use APIs REST do IAM ou bibliotecas de cliente do IAM para conceder papéis.

    Se você usar essas interfaces, use os nomes de função totalmente qualificados:

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

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

  • Criar e conceder funções personalizadas.

    Quaisquer papéis personalizados para permissões de projeto que você criar precisam das seguintes permissões para acessar o Gemini Cloud Assist:

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

Conceder papéis do IAM em uma conta do Cloud Billing

Para usuários que precisam acessar os dados de custo do Cloud Billing, é necessário conceder permissões na conta do Cloud Billing adequadas para acessar a página Relatórios e o hub do FinOps. Para usar o Gemini Cloud Assist no Cloud Billing, conceda aos usuários acesso à conta do Cloud Billing que está vinculada ao projeto em que a API Gemini Cloud Assist está ativada.

A seguir