ניהול רישיונות Standard ו-Enterprise של Gemini Code Assist

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

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

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

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

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

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

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

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

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.orders.modify
    • resourcemanager.projects.get
  2. במסוף Google Cloud , עוברים לדף Admin for Gemini.

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

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

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

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

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

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

המסוף

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

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • resourcemanager.projects.get
  2. עוברים לדף Admin for Gemini ובוחרים את הפרויקט שמצורף לחשבון לחיוב עם המינוי ל-Gemini Code Assist Standard או ל-Gemini Code Assist Enterprise.

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

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

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

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

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

API

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

  1. מוודאים שיש לכם את ההרשאה consumerprocurement.licensePools.enumerateLicensedUsers ב-IAM בחשבון לחיוב שמכיל את מאגר הרישיונות שרוצים להציג את הקצאות הרישיונות שלו.

  2. משתמשים ב-cURL כדי להפעיל את השיטה:

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

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

    • PROJECT_ID: המזהה של הפרויקט. השימוש במכסה והחיובים שמשויכים לבקשת ה-API חלים על הפרויקט הזה.
    • BILLING_ACCOUNT_ID: המזהה של חשבון החיוב שמשויך למאגר הרישיונות.
    • ORDER_ID: מזהה ההזמנה. אם אתם לא יודעים מה מזהה ההזמנה, תוכלו לאחזר אותו על ידי הצגת רשימה של ההזמנות שמשויכות לחשבון לחיוב.

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

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

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

{}

הקצאה ידנית של רישיונות Gemini Code Assist Standard ו-Enterprise למשתמשים ספציפיים

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

המסוף

  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. בוחרים באפשרות Manage Gemini Code Assist ואז באפשרות Modify Subscription.

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

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

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

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

API

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

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

    • billing.accounts.get
    • consumerprocurement.licensePools.assign
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.unassign
    • consumerprocurement.orders.get
  2. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

    {
      "usernames": [
        USER_EMAILS
      ]
    }
    

    מחליפים את USER_EMAILS ברשימה של חשבונות משתמשים שמוקצה להם הרישיון, מופרדים בפסיקים. לדוגמה: "dana@example.com", "lee@example.com".

  3. משתמשים ב-cURL כדי להפעיל את השיטה:

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

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

    • JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב 2.
    • PROJECT_ID: המזהה של הפרויקט. השימוש במכסה והחיובים שמשויכים לבקשת ה-API חלים על הפרויקט הזה.
    • BILLING_ACCOUNT_ID: המזהה של חשבון החיוב שמשויך למאגר הרישיונות.
    • ORDER_ID: מזהה ההזמנה. אם אתם לא יודעים מה מזהה ההזמנה, תוכלו לאחזר אותו על ידי הצגת רשימה של ההזמנות שמשויכות לחשבון לחיוב.

אם הפעולה בוצעה ללא שגיאות, התגובה אמורה להיראות כך:

{}

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

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

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

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

הקצאת רישיון אוטומטית נתמכת רק ב-VS Code, ב-IntelliJ ובסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains.

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

  1. במסוף Google Cloud , עוברים לדף Admin for Gemini.

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

  2. בוחרים באפשרות Manage Gemini Code Assist ואז באפשרות Manage Subscription.

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

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

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

    אם הגדרתם T ימים של חוסר פעילות לביטול ההקצאה, הרישיונות יבטלו את ההקצאה באופן אוטומטי ויופיעו במאגר הרישיונות ביום T+1. לדוגמה, אם תגדירו 7 ימים של חוסר פעילות לביטול ההקצאה, הרישיונות יבטלו את ההקצאה ויופיעו במאגר הרישיונות ביום 8.

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

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

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

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

  1. במסוף Google Cloud , עוברים לדף Admin for Gemini.

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

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

  3. בוחרים באפשרות ניהול רישיונות ואז באפשרות ניהול הקצאת רישיונות אוטומטית. תיבת הדו-שיח Manage automatic license assignment מופיעה.

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

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

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

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

המסוף

  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. בוחרים באפשרות ניהול רישיונות ואז באפשרות ניהול הקצאת רישיונות אוטומטית. תיבת הדו-שיח Manage automatic license assignment מופיעה.

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

  6. לוחצים על אישור.

API

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

  1. כדי לבצע את המשימה הזו, צריכה להיות לכם הרשאת ניהול זהויות והרשאות גישה (IAM)‏ consumerprocurement.licensePools.unassign בחשבון לחיוב שמכיל את מאגר הרישיונות שאת הרישיון שלו אתם רוצים לבטל את ההקצאה שלו.

  2. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

    {
      "usernames": [
        USER_EMAILS
      ]
    }
    

    מחליפים את USER_EMAILS ברשימת חשבונות משתמשים שמוקצה להם הרישיון, מופרדים בפסיקים. לדוגמה: "dana@example.com", "lee@example.com".

  3. משתמשים ב-cURL כדי להפעיל את השיטה:

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

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

    • JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב 2.
    • PROJECT_ID: המזהה של הפרויקט. השימוש במכסה והחיובים שמשויכים לבקשת ה-API חלים על הפרויקט הזה.
    • BILLING_ACCOUNT_ID: המזהה של חשבון החיוב שמשויך למאגר הרישיונות.
    • ORDER_ID: מזהה ההזמנה. אם אתם לא יודעים מה מזהה ההזמנה, תוכלו לאחזר אותו על ידי הצגת רשימה של ההזמנות שמשויכות לחשבון לחיוב.

אם הפעולה בוצעה ללא שגיאות, התגובה אמורה להיראות כך:

{}

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

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

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

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

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

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

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

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

מגבלות

המאמרים הבאים