Gestire le licenze Gemini Code Assist Standard ed Enterprise

Console

1. Verifica di disporre delle seguenti autorizzazioni IAM sull'account di fatturazione proprietario dell'abbonamento:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • resourcemanager.projects.get

2. Vai alla pagina Amministrazione per Gemini e seleziona il progetto collegato al tuo account di fatturazione con l'abbonamento a Gemini Code Assist Standard o Enterprise.

   Vai a Gemini in Google Cloud

3. Scegli l'abbonamento da modificare, poi seleziona Modifica abbonamento.

   Per ogni utente a cui è stata assegnata una licenza sono disponibili le seguenti informazioni:

   • Nome
   • le email,
   • Data di assegnazione della licenza.
   • Data e ora dell'ultimo utilizzo della licenza.

4. Per trovare un insieme specifico di utenti, puoi filtrare e ordinare l'elenco come segue:

   • Per filtrare l'elenco, inserisci le proprietà e i valori nel campo Filtro.
   • Per ordinare l'elenco, seleziona l'intestazione della colonna in base alla quale ordinare. Ad esempio, per ordinare in ordine alfabetico in base ai nomi utente, seleziona l'intestazione della colonna Nome.

API

Per visualizzare le assegnazioni delle licenze Gemini Code Assist Standard o Enterprise, utilizza il metodo billingAccounts.orders.licensePool.enumerateLicensedUsers.

1. Verifica di disporre dell'autorizzazione IAM consumerprocurement.licensePools.enumerateLicensedUsers sull'account di fatturazione che contiene il pool di licenze di cui vuoi visualizzare le assegnazioni.

2. Utilizza cURL per chiamare il metodo:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID di un progetto. L'utilizzo della quota e gli addebiti associati alla richiesta API vengono applicati a questo progetto.
   • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione associato al pool di licenze.
   • ORDER_ID: l'ID ordine. Se non conosci l'ID ordine, puoi recuperarlo elencando gli ordini associati al tuo account di fatturazione.

Se il comando ha esito positivo, restituisce l'output licensedUsers nel seguente formato:

{
  "licensedUsers": [
      {
          "username": "dana@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "lee@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "taylor@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "bola@example.com",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

Se non sono presenti assegnazioni di licenze Gemini Code Assist Standard o Enterprise o se ORDER_ID non è valido, viene restituito l'output licensedUsers nel seguente formato:

{}

Console

1. Verifica di disporre delle seguenti autorizzazioni IAM sull'account di fatturazione proprietario dell'abbonamento:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.assign
   • resourcemanager.projects.get

2. Vai alla pagina Amministrazione di Gemini.

   Vai a Gemini in Google Cloud

3. Seleziona Gestisci Gemini Code Assist, poi seleziona Modifica abbonamento.

4. Per questo abbonamento a Gemini Code Assist Standard o Enterprise, verifica di aver impostato Assegnazione licenze su Assegna licenze manualmente. Se l'abbonamento a Gemini Code Assist Standard o Enterprise è impostato su Assegna automaticamente le licenze, non puoi gestire le singole licenze. Se passi a questo account di fatturazione Assegna licenze manualmente, l'assegnazione automatica delle licenze viene disattivata dopo la modifica, ma le assegnazioni di licenze preesistenti non vengono modificate.

5. Seleziona Aggiungi utente con licenza. Viene visualizzata una finestra di dialogo di selezione utente. Sono supportati solo gli indirizzi email degli Account Google individuali, ad esempio @gmail.com, @googlegroups.com e i domini Google Workspace. La federazione delle identità per la forza lavoro (BYOID) non è supportata.

6. Seleziona Aggiungi utente con licenza.

7. Verifica di concedere i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer agli utenti agli utenti con licenza.

API

Per assegnare licenze Gemini Code Assist Standard ed Enterprise, utilizza il metodo billingAccounts.orders.licensePool.assign.

1. Verifica di disporre delle seguenti autorizzazioni IAM sull'account di fatturazione che contiene il pool di licenze di cui intendi assegnare la licenza:

• billing.accounts.get
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.unassign
• consumerprocurement.orders.get

1. Crea un file JSON contenente le seguenti informazioni:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Sostituisci USER_EMAILS con un elenco separato da virgole di account utente a cui viene assegnata la licenza, ad esempio "dana@example.com", "lee@example.com". Sono supportati solo indirizzi email di Account Google individuali, ad esempio @gmail.com, @googlegroups.com e domini Google Workspace. La federazione delle identità per la forza lavoro (BYOID) non è supportata.

2. Utilizza cURL per chiamare il metodo:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

   Sostituisci quanto segue:

   • JSON_FILE_NAME: il percorso del file JSON che hai creato nel passaggio 2.
   • PROJECT_ID: l'ID di un progetto. L'utilizzo della quota e gli addebiti associati alla richiesta API vengono applicati a questo progetto.
   • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione associato al pool di licenze.
   • ORDER_ID: l'ID ordine. Se non conosci l'ID ordine, puoi recuperarlo elencando gli ordini associati al tuo account di fatturazione.

Se l'operazione ha esito positivo, la risposta è simile alla seguente:

{}

Per verificare l'assegnazione, visualizza l'elenco dei compiti.

Quindi, verifica di concedere i ruoli IAM Gemini for Google Cloud User e Service Usage Consumer agli utenti agli utenti con licenza.

Console

1. Verifica di disporre delle seguenti autorizzazioni IAM sull'account di fatturazione proprietario dell'abbonamento:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.unassign
   • resourcemanager.projects.get

2. Vai alla pagina Amministrazione di Gemini.

   Vai a Gemini in Google Cloud

3. Seleziona Gestisci Gemini Code Assist, quindi Gestisci abbonamento.

4. Seleziona Gestione licenze, quindi Gestisci assegnazione automatica di licenza. Viene visualizzata la finestra di dialogo Gestisci l'assegnazione automatica delle licenze.

5. Seleziona gli utenti per i quali vuoi annullare l'assegnazione delle licenze, quindi seleziona Annulla assegnazione licenza.

6. Seleziona Conferma.

API

Per annullare l'assegnazione delle licenze Gemini Code Assist Standard ed Enterprise, utilizza il metodo billingAccounts.orders.licensePool.unassign.

1. Per eseguire questa attività, devi disporre dell'autorizzazione consumerprocurement.licensePools.unassign Identity and Access Management per l'account di fatturazione che contiene il pool di licenze di cui intendi annullare l'assegnazione.

2. Crea un file JSON contenente le seguenti informazioni:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Sostituisci USER_EMAILS con un elenco separato da virgole di account utente a cui è assegnata la licenza, ad esempio "dana@example.com", "lee@example.com".

3. Utilizza cURL per chiamare il metodo:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

   Sostituisci quanto segue:

   • JSON_FILE_NAME: il percorso del file JSON che hai creato nel passaggio 2.
   • PROJECT_ID: l'ID di un progetto. L'utilizzo della quota e gli addebiti associati alla richiesta API vengono applicati a questo progetto.
   • BILLING_ACCOUNT_ID: l'ID dell'account di fatturazione associato al pool di licenze.
   • ORDER_ID: l'ID ordine. Se non conosci l'ID ordine, puoi recuperarlo elencando gli ordini associati al tuo account di fatturazione.

Se l'operazione ha esito positivo, la risposta è simile alla seguente:

{}

Per verificare l'annullamento dell'assegnazione, visualizza l'elenco delle assegnazioni.