ניהול רישיונות של Gemini Code Assist

כדי להשתמש ב-Gemini Code Assist, כל משתמש בארגון צריך רישיון.

כברירת מחדל, במינויים חדשים צריך להקצות רישיונות באופן ידני. אחרי שמגדירים מוצרים מסוימים של Gemini for Google Cloud, אפשר להקצות רישיונות באופן ידני או באופן אוטומטי.

לפני שמתחילים

• חשוב לוודא שיש לכם את תפקידי ה-IAM 'אדמין של חשבון לחיוב' (roles/billing.admin) או 'אדמין של הזמנות רכש של צרכנים' (roles/consumerprocurement.orderAdmin) כדי שתוכלו להקצות הרשאות נוספות שנדרשות בחשבון לחיוב למשימות ספציפיות של ניהול רישיונות שמפורטות בקטעים הבאים.

• אם אתם רוצים לנהל את הרישיונות באמצעות API במקום במסוף Google Cloud, עליכם לוודא את הפרטים הבאים:
  • מגדירים פרויקט מכסה לחשבון לחיוב.
  • מפעילים את Cloud Commerce Consumer Procurement API בפרויקט עם המכסה.
  • מוודאים שכל צמד מפתח/ערך בכותרת הבא נמצא בכל קריאות ה-API:
    • Authorization: אסימון הגישה ל-Google Cloud מ-Google Cloud CLI
    • x-goog-user-project: מזהה הפרויקט של המכסה

שינוי מספר הרישיונות של Gemini Code Assist במינוי

אתם יכולים להוסיף או להסיר את מספר הרישיונות של Gemini for Google Cloud ישירות דרך מסוף Google Cloud, או דרך הנציג של חשבון Google או מפיץ מורשה.

כדי לשנות את מספר הרישיונות במינוי:

1. חשוב לוודא שיש לכם את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בחשבון לחיוב שבבעלותו המינוי:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.orders.modify
   • resourcemanager.projects.get

2. נכנסים לדף Admin for Gemini במסוף Google Cloud.

   כניסה לדף Gemini for Google Cloud

3. בוחרים את המינוי שרוצים לשנות ואז בוחרים באפשרות Modify Subscription.

4. מזינים את מספר הרישיונות שרוצים לקבל. יוצגו הפרטים הבאים:

   • מספר הרישיונות הכולל לאחר הרכישה.
   • מספר הרישיונות שזמינים להקצאה לאחר הרכישה.
   • המחיר החדש של המינוי לכל תקופה. הסכום הנוסף עבור הרישיונות שנוספו מחושב באופן יחסי על סמך משך הזמן שנותר בתקופת המינוי הנוכחית.

5. לוחצים על שמירה.

הצגת הקצאות הרישיונות של Gemini Code Assist

בוחרים באחת מהאפשרויות הבאות:

המסוף API

1. חשוב לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שבבעלותו המינוי:

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

2. עוברים לדף ניהול ב-Gemini.

   כניסה לדף Gemini for Google Cloud

3. בוחרים את המינוי שרוצים לשנות ואז בוחרים באפשרות Modify Subscription.

   המידע הבא זמין לגבי כל משתמש שהוקצה לו רישיון:

   • שם.
   • אימייל.
   • התאריך שבו הוקצה הרישיון.
   • התאריך והשעה שבהם בוצע השימוש האחרון ברישיון.

4. כדי למצוא קבוצה ספציפית של משתמשים, אפשר לסנן ולמיין את הרשימה בדרכים הבאות:

   • כדי לסנן את הרשימה, מזינים את המאפיינים והערכים בשדה Filter.
   • כדי למיין את הרשימה, בוחרים את הכותרת של העמודה שלפיה רוצים למיין. לדוגמה, כדי למיין את הרשימה לפי סדר אלפביתי של שמות המשתמשים, בוחרים את העמודה Name.

כדי להציג את הקצאות הרישיונות של Gemini Code Assist, משתמשים בשיטה billingAccounts.orders.licensePool.enumerateLicensedUsers.

כדי לבצע את המשימה הזו, נדרשת ההרשאה consumerprocurement.licensePools.enumerateLicensedUsers בחשבון לחיוב שבבעלותו המינוי.

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

מחליפים את מה שכתוב בשדות הבאים:

• BILLING_ACCOUNT_ID: מספר החשבון לחיוב
• ORDER_ID: מדיניות IAM

אם הפקודה מסתיימת ללא שגיאות, היא מחזירה את הפלט של licensedUsers בפורמט הבא:

{
  "licensedUsers": [
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

אם אין הקצאות רישיון ל-Gemini Code Assist או שהערך של ORDER_ID לא תקין, הפונקציה מחזירה את הפלט licensedUsers בפורמט הבא:

{}

הקצאת רישיונות Gemini Code Assist למשתמשים ספציפיים באופן ידני

בוחרים באחת מהאפשרויות הבאות:

המסוף API

1. חשוב לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שבבעלותו המינוי:

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

2. עוברים לדף ניהול ב-Gemini.

   כניסה לדף Gemini for Google Cloud

3. בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות שינוי המינוי.

4. במינוי הזה ל-Gemini Code Assist, חשוב לוודא שהגדרתם את הקצאת הרישיונות לאפשרות הקצאת רישיונות באופן ידני. אם ההגדרה של המינוי ל-Gemini Code Assist היא הקצאת רישיונות באופן אוטומטי, לא תוכלו לנהל רישיונות ספציפיים. אם תשנו את החשבון לחיוב לאפשרות הקצאת רישיונות באופן ידני, ההקצאה האוטומטית של הרישיונות תושבת אחרי השינוי, אבל הקצאות רישיונות קיימות לא יושפעו.

5. בוחרים באפשרות הקצאת רישיונות. תופיע תיבת דו-שיח לבחירת משתמש. כדי לחפש משתמשים ספציפיים, מזינים את כתובת האימייל שלהם ולוחצים על הבא.

6. בוחרים באפשרות הקצאת רישיונות.

7. חשוב לוודא שמקצים למשתמשים את התפקידים 'משתמש ב-Gemini for Google Cloud' ו'צרכן של שימוש בשירות' ב-IAM.

כדי להקצות רישיונות ל-Gemini Code Assist, משתמשים בשיטה billingAccounts.orders.licensePool.assign.

כדי לבצע את המשימה הזו, צריך לוודא שיש לכם את ההרשאות הבאות בחשבון לחיוב שבבעלותו המינוי:

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

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

מחליפים את מה שכתוב בשדות הבאים:

• BILLING_ACCOUNT_ID: מספר החשבון לחיוב
• ORDER_ID: מדיניות IAM

אם הפקודה מסתיימת ללא שגיאות, היא מחזירה גוף תגובה ריק בפורמט הבא:

{}

כדי לוודא שהמטלה נשלחה, מציגים את רשימת המטלות.

לאחר מכן, חשוב לוודא שמקצים למשתמשים את התפקידים Gemini for Google Cloud User ו-Service Usage Consumer ב-IAM.

הקצאה אוטומטית של רישיונות Gemini Code Assist

בדף הקצאת רישיון אפשר להקצות באופן אוטומטי רישיון לכל משתמש בארגון שזקוק לגישה ל-Gemini Code Assist. הקצאת הרישיון האוטומטית מוגדרת בנפרד לכל מינוי.

אם בוחרים להקצות רישיונות באופן אוטומטי ל-Gemini Code Assist, אי אפשר להסיר או להוסיף רישיונות משתמשים ספציפיים בחשבון הזה. משתמשים עם הקצאות רישיון שלא השתמשו באף אחת מהתכונות של Gemini Code Assist יאבדו את ההקצאה באופן אוטומטי בסוף תקופת החיובים, אחרי מספר מסוים של ימים ללא פעילות, כפי שהוגדר על ידי האדמין.

1. נכנסים לדף Admin for Gemini במסוף Google Cloud.

   כניסה לדף Gemini for Google Cloud

2. בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות ניהול המינוי.

3. בוחרים באפשרות License Management ואז באפשרות Enable Automatic License Assignment. תיבת הדו-שיח Enable automatic licenses מופיעה.

   אם תשנו את המינוי הזה להקצאה אוטומטית של רישיונות, ההקצאה הידנית של רישיונות תושבת אחרי השינוי, אבל הקצאות רישיונות קיימות לא יושפעו.

4. מגדירים את משך הזמן שיחלוף עד לביטול ההקצאה של הרישיון אם המשתמש שהוקצה לו לא פעיל, ולוחצים על Confirm Change. תיבת הדו-שיח Automatic license assignment has been enabled מופיעה.

5. בוחרים באפשרות סגירה.

6. חשוב לוודא שמקצים למשתמשים את התפקידים 'משתמש ב-Gemini for Google Cloud' ו'צרכן של שימוש בשירות' ב-IAM.

   משתמשים עם ההרשאה cloudaicompanion.licenses.selfAssign מקבלים רישיון באופן אוטומטי בפעם הראשונה שהם ניגשים ל-Gemini Code Assist בפרויקט שמחויב דרך חשבון לחיוב שיש בו מינוי תקף שמוגדר להקצאת רישיונות אוטומטית, ויש בו רישיונות זמינים שמכוסים על ידי המינויים בחשבון לחיוב.

כדי להשבית את הקצאת הרישיונות האוטומטית:

1. נכנסים לדף Admin for Gemini במסוף Google Cloud.

   כניסה לדף Gemini for Google Cloud

2. בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות ניהול המינוי.

3. בוחרים באפשרות License Management ואז באפשרות Manage Automatic License Assignment. תיבת הדו-שיח Manage automatic license assignment מופיעה.

4. בוחרים באפשרות Disable automatic license management.

5. בוחרים באפשרות אישור השינוי.

ביטול ההקצאה של רישיונות Gemini Code Assist באופן ידני

בוחרים באחת מהאפשרויות הבאות:

המסוף API

1. חשוב לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שבבעלותו המינוי:

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

2. עוברים לדף ניהול Gemini.

   כניסה לדף Gemini for Google Cloud

3. בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות ניהול המינוי.

4. בוחרים באפשרות License Management ואז באפשרות Manage Automatic License Assignment. תיבת הדו-שיח Manage automatic license assignment מופיעה.

5. בוחרים את המשתמשים שרוצים לבטל את ההקצאה של הרישיונות שלהם, ואז בוחרים באפשרות ביטול הקצאת רישיון.

6. בוחרים אישור.

כדי לבטל את ההקצאה של רישיונות Gemini Code Assist, משתמשים בשיטה billingAccounts.orders.licensePool.unassign.

כדי לבצע את המשימה הזו, נדרשת ההרשאה consumerprocurement.licensePools.unassign בחשבון לחיוב שבבעלותו המינוי.

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

מחליפים את מה שכתוב בשדות הבאים:

• BILLING_ACCOUNT_ID: מספר החשבון לחיוב
• ORDER_ID: מדיניות IAM

אם הפקודה מסתיימת ללא שגיאות, היא מחזירה גוף תגובה ריק בפורמט הבא:

{}

כדי לוודא שהמטלה בוטלה, מציגים את רשימת המטלות.

העברת רישיונות ל-Gemini Code Assist

אי אפשר להעביר רישיונות של Gemini Code Assist ישירות בין משתמשים. במקום זאת, מבטלים את ההקצאה של הרישיון למשתמש ואז מקצים רישיון למשתמש החדש.

מניעת שימוש ברישיון בארגונים שונים

רישיונות Gemini Code Assist מוקצים למשתמשים ספציפיים, ולא לארגונים או לפרויקטים, כך שמשתמשים ספציפיים יכולים להשתמש ב-Gemini Code Assist בכמה ארגונים.

כל יומנים שנוצרו כתוצאה משימוש ב-Gemini Code Assist נמצאים בפרויקט שבו השימוש התרחש, ולא אצל המשתמש ברישיון. בנוסף, כל התאמה אישית או הגדרה של Gemini Code Assist (כמו התאמה אישית של קוד) מתבצעת ברמת הפרויקט, ולא ברמת הרישיון או המינוי.

כדי למנוע שימוש נרחב יותר ב-Gemini Code Assist בפרויקט בארגון, תוכלו לבצע אחת מהפעולות הבאות:

• משביתים את Gemini for Google Cloud API בפרויקט.
• להשתמש בהרשאות כדי לדחות את הגישה של משתמשים לפרויקט.

מגבלות

• Gemini לניהול רישיונות ב-Google Cloud לא תומך באיחוד שירותי אימות הזהות של כוח עבודה.