Gemini Code Assist Standard- und Enterprise-Lizenzen verwalten

Console

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Abrechnungskonto haben, zu dem das Abo gehört:

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

2. Rufen Sie die Seite Admin for Gemini auf und wählen Sie das Projekt aus, das mit Ihrem Rechnungskonto mit dem Gemini Code Assist Standard- oder Enterprise-Abo verknüpft ist.

   Zu Gemini für Google Cloud

3. Wählen Sie das Abo aus, das Sie ändern möchten, und dann Abo ändern.

   Für jeden Nutzer, dem eine Lizenz zugewiesen wurde, sind die folgenden Informationen verfügbar:

   • Name
   • E‑Mails,
   • Datum, an dem die Lizenz zugewiesen wurde.
   • Datum und Uhrzeit der letzten Verwendung der Lizenz.

4. Wenn Sie eine bestimmte Gruppe von Nutzern finden möchten, können Sie die Liste so filtern und sortieren:

   • Geben Sie zum Filtern der Liste die gewünschten Attribute und Werte in das Feld Filter ein.
   • Zum Sortieren der Liste wählen Sie die Überschrift der Spalte aus, nach der Sie sortieren möchten. Wenn Sie beispielsweise alphabetisch nach den Nutzernamen sortieren möchten, wählen Sie die Spaltenüberschrift Name aus.

API

Wenn Sie Zuweisungen von Gemini Code Assist Standard- oder Enterprise-Lizenzen ansehen möchten, verwenden Sie die billingAccounts.orders.licensePool.enumerateLicensedUsers-Methode.

1. Sie müssen die IAM-Berechtigung consumerprocurement.licensePools.enumerateLicensedUsers für das Abrechnungskonto haben, das den Lizenzpool enthält, dessen Lizenzzuweisungen Sie aufrufen möchten.

2. Verwenden Sie cURL, um die Methode aufzurufen:

   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/"
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die ID für ein Projekt. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angerechnet.
   • BILLING_ACCOUNT_ID: die ID des Rechnungskontos, das dem Lizenzpool zugeordnet ist.
   • ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Abrechnungskonto verknüpften Bestellungen auflisten.

Bei erfolgreicher Ausführung gibt dieser Befehl licensedUsers-Diagnoseinformationen im nachfolgend dargestellten Format aus:

{
  "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"
      }
  ]
}

Wenn keine Gemini Code Assist Standard- oder Enterprise-Lizenzzuweisungen vorhanden sind oder die ORDER_ID ungültig ist, wird die licensedUsers-Ausgabe im folgenden Format zurückgegeben:

{}

Console

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Abrechnungskonto haben, zu dem das Abo gehört:

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

2. Rufen Sie die Seite Admin für Gemini auf.

   Zu Gemini für Google Cloud

3. Wählen Sie Gemini Code Assist verwalten und dann Abo ändern aus.

4. Achten Sie bei diesem Gemini Code Assist Standard- oder Enterprise-Abo darauf, dass Sie Lizenzzuweisung auf Lizenzen manuell zuweisen festlegen. Wenn für das Gemini Code Assist Standard- oder Enterprise-Abo die Option Lizenzen automatisch zuweisen festgelegt ist, können Sie keine einzelnen Lizenzen verwalten. Wenn Sie dieses Rechnungskonto auf Lizenzen manuell zuweisen umstellen, wird die automatische Lizenzzuweisung nach der Änderung deaktiviert. Vorhandene Lizenzzuweisungen sind davon jedoch nicht betroffen.

5. Wählen Sie Lizenzen zuweisen aus. Ein Dialogfeld zur Auswahl von Nutzern wird angezeigt. Wenn Sie nach bestimmten Nutzern suchen möchten, geben Sie deren E‑Mail-Adresse ein und wählen Sie Weiter aus.

6. Wählen Sie Lizenzen zuweisen aus.

7. Weisen Sie den lizenzierten Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zu.

API

Verwenden Sie die billingAccounts.orders.licensePool.assign-Methode, um Gemini Code Assist Standard- und Enterprise-Lizenzen zuzuweisen.

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Rechnungskonto haben, das den Lizenzpool enthält, dessen Lizenz Sie zuweisen möchten:

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

2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Ersetzen Sie USER_EMAILS durch eine durch Kommas getrennte Liste von Nutzerkonten, denen die Lizenz zugewiesen wird, z. B. "dana@example.com", "lee@example.com".

3. Verwenden Sie cURL, um die Methode aufzurufen:

   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/"

   Ersetzen Sie Folgendes:

   • JSON_FILE_NAME: der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.
   • PROJECT_ID: die ID für ein Projekt. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angerechnet.
   • BILLING_ACCOUNT_ID: die ID des Rechnungskontos, das dem Lizenzpool zugeordnet ist.
   • ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Abrechnungskonto verknüpften Bestellungen auflisten.

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

{}

Sehen Sie sich die Liste der Zuweisungen an, um die Zuweisung zu überprüfen.

Achten Sie dann darauf, dass Sie den lizenzierten Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zuweisen.

Console

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Abrechnungskonto haben, zu dem das Abo gehört:

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

2. Rufen Sie die Seite Admin für Gemini auf.

   Zu Gemini für Google Cloud

3. Wählen Sie Gemini Code Assist verwalten und dann Abo verwalten aus.

4. Wählen Sie Lizenzverwaltung und dann Automatische Lizenzzuweisung verwalten aus. Das Dialogfeld Automatische Lizenzzuweisung verwalten wird angezeigt.

5. Wählen Sie die Nutzer aus, für die Sie die Zuweisung von Lizenzen aufheben möchten, und wählen Sie dann Zuweisung von Lizenz aufheben aus.

6. Wählen Sie Bestätigen aus.

API

Wenn Sie Gemini Code Assist Standard- und Enterprise-Lizenzen entfernen möchten, verwenden Sie die Methode billingAccounts.orders.licensePool.unassign.

1. Zum Ausführen dieser Aufgabe benötigen Sie die IAM-Berechtigung (Identity and Access Management) consumerprocurement.licensePools.unassign für das Rechnungskonto, das den Lizenzpool enthält, dessen Lizenz Sie aufheben möchten.

2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Ersetzen Sie USER_EMAILS durch eine durch Kommas getrennte Liste von Nutzerkonten, denen die Lizenz zugewiesen ist, z. B. "dana@example.com", "lee@example.com".

3. Verwenden Sie cURL, um die Methode aufzurufen:

   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/"

   Ersetzen Sie Folgendes:

   • JSON_FILE_NAME: der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.
   • PROJECT_ID: die ID für ein Projekt. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angerechnet.
   • BILLING_ACCOUNT_ID: die ID des Rechnungskontos, das dem Lizenzpool zugeordnet ist.
   • ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Abrechnungskonto verknüpften Bestellungen auflisten.

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

{}

Rufen Sie die Liste der Zuweisungen auf, um die Aufhebung der Zuweisung zu überprüfen.