Prima di utilizzare determinati prodotti Gemini per Google Cloud (ad esempio Gemini Code Assist), ogni utente della tua organizzazione deve avere una licenza.
Prima di iniziare
- Assicurati di avere l'Amministratore account di fatturazione
(
roles/billing.admin
) o Amministratore ordini approvvigionamento consumer (roles/consumerprocurement.orderAdmin
) ruoli IAM per concedere autorizzazioni aggiuntive per attività specifiche di gestione delle licenze, dettagliate di seguito, sezioni.
- Se vuoi gestire le licenze utilizzando un'API anziché la console Google Cloud, assicurati di quanto segue:
- Configura un progetto di quota per la fatturazione .
- Attivata la API Cloud Commerce Consumer Procurement nel progetto di quota.
- Assicurati che siano presenti le seguenti coppie chiave-valore di intestazione per tutte le chiamate API:
Authorization
: il tuo Token di accesso Google Cloud da Google Cloud CLIx-goog-user-project
: l'ID del progetto quota
Modificare il numero di licenze Gemini per Google Cloud in un abbonamento
Puoi aggiungere o rimuovere il numero di licenze Gemini per Google Cloud direttamente tramite la console Google Cloud, tramite il rappresentante del tuo Account Google o un rivenditore autorizzato.
Per eseguire questa attività, devi disporre delle seguenti autorizzazioni IAM (Gestione di identità e accessi):
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify
Per modificare il numero di licenze in un abbonamento:
Nella console Google Cloud, vai alla pagina Amministrazione per Gemini.
Scegli l'abbonamento che vuoi modificare, quindi fai clic su Modifica abbonamento.
Inserisci il numero di licenze che vuoi avere. Le seguenti informazioni è visualizzato:
- Numero di licenze totali dopo l'acquisto.
- Numero di licenze disponibili per l'assegnazione dopo l'acquisto.
- Nuovo prezzo dell'abbonamento per periodo. L'importo aggiuntivo per le licenze aggiunte viene ripartito proporzionalmente in base al tempo rimanente nel termine corrente.
Fai clic su Salva.
Visualizza le assegnazioni delle licenze Gemini per Google Cloud
Console
Per visualizzare le assegnazioni delle licenze di Gemini per Google Cloud nella console Google Cloud, devi disporre delle seguenti autorizzazioni:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
Vai alla pagina Amministrazione per Gemini.
Scegli l'abbonamento che vuoi modificare, quindi fai clic su Modifica abbonamento.
Le seguenti informazioni sono disponibili per ogni utente assegnato una licenza:
- Nome
- Tipo di account
- Licenze assegnate
Per trovare un insieme specifico di utenti, puoi filtrare e ordinare l'elenco come segue:
- Per filtrare l'elenco, nel campo Filtro: inserisci le proprietà e i valori.
- Per ordinare l'elenco, fai clic sull'intestazione della colonna da ordinare. tramite. Ad esempio, per ordinare alfabeticamente in base ai nomi utente, fai clic sul Intestazione della colonna Nome.
API
Per visualizzare le assegnazioni delle licenze di Gemini per Google Cloud, utilizza
il
Metodo billingAccounts.orders.licensePool.enumerateLicensedUsers
.
Per eseguire questa attività, devi avere il
Autorizzazione consumerprocurement.licensePools.enumerateLicensedUsers
.
GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/
Sostituisci quanto segue:
BILLING_ACCOUNT_ID
: l'ID dell'account di fatturazioneORDER_ID
: il criterio IAM
Se il comando va a buon fine, 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"
}
]
}
Assegnare licenze di Gemini per Google Cloud a singoli utenti
Console
Per assegnare le licenze Gemini per Google Cloud ai singoli utenti nella console Google Cloud, devi disporre delle seguenti autorizzazioni:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
Vai alla pagina Amministrazione di Gemini.
Scegli l'abbonamento che vuoi modificare, quindi fai clic su Modifica abbonamento.
Fai clic su Assegna licenze. Viene visualizzata una finestra di dialogo di selezione dell'utente. Per eseguire una ricerca per utenti specifici, inserisci il loro nome nella casella di ricerca.
Seleziona uno o più utenti dall'elenco e fai clic su Avanti.
Scegli i servizi Gemini per Google Cloud per cui vuoi assegnare le licenze.
Fai clic su Assegna licenze.
API
Per assegnare le licenze Gemini per Google Cloud, utilizza
Metodo billingAccounts.orders.licensePool.assign
.
Per eseguire questa attività, devi avere il
Autorizzazione consumerprocurement.licensePools.assign
.
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
Sostituisci quanto segue:
BILLING_ACCOUNT_ID
: l'ID dell'account di fatturazioneORDER_ID
: il criterio IAM
Se il comando ha esito positivo, restituisce un corpo della risposta vuoto nel seguente formato:
{}
Per verificare il compito, visualizza l'elenco dei compiti.
Annullare l'assegnazione delle licenze Gemini per Google Cloud
Console
Per annullare l'assegnazione di una licenza a un utente nella console Google Cloud, devi disporre delle seguenti autorizzazioni:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.unassign
Vai alla pagina Amministrazione per Gemini.
Scegli l'abbonamento che vuoi modificare e poi fai clic su Gestisci abbonamento.
Seleziona gli utenti di cui vuoi revocare le licenze e poi fai clic su Revoca licenza.
Fai clic su Conferma modifiche.
API
Per annullare l'assegnazione delle licenze Gemini per Google Cloud, utilizza il
metodo billingAccounts.orders.licensePool.unassign
.
Per eseguire questa operazione, devi disporre dell'autorizzazione consumerprocurement.licensePools.unassign
.
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
Sostituisci quanto segue:
BILLING_ACCOUNT_ID
: l'ID dell'account di fatturazioneORDER_ID
: il criterio IAM
Se il comando va a buon fine, restituisce un corpo della risposta vuoto nel seguente formato:
{}
Per verificare lo scollegamento, visualizza l'elenco dei compiti.
Trasferisci le licenze Gemini per Google Cloud
Le licenze Gemini per Google Cloud non possono essere trasferite direttamente tra utenti. È invece necessario annullare l'assegnazione della licenza a un utente e poi assegnarla al nuovo utente.
Impedire l'utilizzo delle licenze tra organizzazioni
Le licenze di Gemini per Google Cloud vengono assegnate ai singoli utenti, non organizzazioni o progetti, consentendo ai singoli utenti di utilizzare Gemini per Google Cloud in più organizzazioni.
Eventuali log generati dall'utilizzo di Gemini per Google Cloud dipende dal progetto in cui è avvenuto l'utilizzo, non dal licenziatario. Inoltre, qualsiasi personalizzazione o configurazione di Gemini per Google Cloud (ad esempio la personalizzazione del codice di Gemini Code Assist) viene eseguita nel progetto, non a livello di licenza o abbonamento.
Per impedire ulteriormente l'utilizzo di Gemini per Google Cloud tra organizzazioni in un progetto, puoi eseguire una delle seguenti operazioni:
- Disattiva l'API Gemini per Google Cloud nel progetto.
- Utilizza le autorizzazioni per negare l'accesso degli utenti al progetto.
Limitazioni
- La gestione delle licenze di Gemini per Google Cloud non supporta la federazione delle identità per la forza lavoro.