כדי להשתמש ב-Gemini Code Assist Standard וב-Enterprise, כל משתמש בארגון צריך רישיון.
כברירת מחדל, במינויים חדשים צריך להקצות רישיונות באופן ידני. אחרי שמגדירים מוצרים מסוימים של 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 CLIx-goog-user-project
: מזהה הפרויקט של פרויקט המכסה
שינוי מספר הרישיונות של Gemini Code Assist Standard ו-Enterprise במינוי
אפשר להוסיף או להסיר את מספר הרישיונות של Gemini for Google Cloud ישירות דרך Google Cloud המסוף, או דרך הנציג של חשבון Google או מפיץ מורשה.
כדי לשנות את מספר הרישיונות במינוי:
חשוב לוודא שיש לכם את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בחשבון לחיוב שבבעלותו המינוי:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify
resourcemanager.projects.get
במסוף Google Cloud , עוברים לדף Admin for Gemini.
בוחרים את המינוי שרוצים לשנות ואז בוחרים באפשרות Modify Subscription.
מזינים את מספר הרישיונות שרוצים לקבל. יוצגו הפרטים הבאים:
- מספר הרישיונות הכולל לאחר הרכישה.
- מספר הרישיונות שזמינים להקצאה לאחר הרכישה.
- המחיר החדש של המינוי לכל תקופת המינוי. הסכום הנוסף עבור הרישיונות שנוספו מחושב באופן יחסי על סמך משך הזמן שנותר בתקופת המינוי הנוכחית.
בוחרים באפשרות שמירה.
הצגת ההקצאות של רישיונות Gemini Code Assist Standard ו-Enterprise
בוחרים באחת מהאפשרויות הבאות:
המסוף
חשוב לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שבבעלותו המינוי:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
resourcemanager.projects.get
עוברים לדף Admin for Gemini ובוחרים את הפרויקט שמצורף לחשבון לחיוב עם המינוי ל-Gemini Code Assist Standard או ל-Gemini Code Assist Enterprise.
בוחרים את המינוי שרוצים לשנות ואז בוחרים באפשרות Modify Subscription.
המידע הבא זמין לגבי כל משתמש שהוקצה לו רישיון:
- שם.
- אימייל.
- התאריך שבו הוקצה הרישיון.
- התאריך והשעה שבהם בוצע השימוש האחרון ברישיון.
כדי למצוא קבוצה ספציפית של משתמשים, אפשר לסנן ולמיין את הרשימה בדרכים הבאות:
- כדי לסנן את הרשימה, מזינים את המאפיינים והערכים בשדה Filter.
- כדי למיין את הרשימה, בוחרים את הכותרת של העמודה שלפיה רוצים למיין. לדוגמה, כדי למיין את הרשימה לפי סדר אלפביתי של שמות המשתמשים, בוחרים את העמודה Name.
API
כדי להציג את ההקצאות של רישיונות Gemini Code Assist Standard או Enterprise, משתמשים בשיטה billingAccounts.orders.licensePool.enumerateLicensedUsers
.
מוודאים שיש לכם את ההרשאה
consumerprocurement.licensePools.enumerateLicensedUsers
ב-IAM בחשבון לחיוב שמכיל את מאגר הרישיונות שרוצים להציג את הקצאות הרישיונות שלו.משתמשים ב-
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 למשתמשים ספציפיים
בוחרים באחת מהאפשרויות הבאות:
המסוף
חשוב לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שבבעלותו המינוי:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
resourcemanager.projects.get
עוברים לדף ניהול Gemini.
בוחרים באפשרות Manage Gemini Code Assist ואז באפשרות Modify Subscription.
במינוי ל-Gemini Code Assist Standard או Enterprise, חשוב להגדיר את הקצאת הרישיונות לאפשרות הקצאת רישיונות באופן ידני. אם המינוי ל-Gemini Code Assist ברמה Standard או Enterprise מוגדר לאפשרות הקצאת רישיונות באופן אוטומטי, לא תוכלו לנהל רישיונות ספציפיים. אם תשנו את חשבון החיוב להקצאת רישיונות באופן ידני, ההקצאה האוטומטית של הרישיונות תושבת אחרי השינוי, אבל הקצאות רישיונות קיימות לא יושפעו.
בוחרים באפשרות הקצאת רישיונות. תופיע תיבת דו-שיח לבחירת משתמש. כדי לחפש משתמשים ספציפיים, מזינים את כתובת האימייל שלהם ולוחצים על הבא.
בוחרים באפשרות הקצאת רישיונות.
חשוב לוודא שמקצים למשתמשים את התפקידים 'משתמש ב-Gemini for Google Cloud' ו'צרכן של שימוש בשירות' ב-IAM.
API
כדי להקצות רישיונות Gemini Code Assist Standard ו-Enterprise, משתמשים בשיטה billingAccounts.orders.licensePool.assign
.
חשוב לוודא שיש לכם את ההרשאות הבאות ב-IAM בחשבון לחיוב שמכיל את מאגר הרישיונות שאת הרישיון שלו אתם רוצים להקצות:
billing.accounts.get
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.get
consumerprocurement.licensePools.unassign
consumerprocurement.orders.get
יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "usernames": [ USER_EMAILS ] }
מחליפים את
USER_EMAILS
ברשימה של חשבונות משתמשים שמוקצה להם הרישיון, מופרדים בפסיקים. לדוגמה:"dana@example.com", "lee@example.com"
.משתמשים ב-
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 יאבדו את ההקצאה באופן אוטומטי בסוף תקופת הפעילות השקטה שהוגדרה על ידי האדמין.
במסוף Google Cloud , עוברים לדף Admin for Gemini.
בוחרים באפשרות Manage Gemini Code Assist ואז באפשרות Manage Subscription.
בוחרים באפשרות License Management ואז באפשרות Enable Automatic License Assignment. תיבת הדו-שיח Enable automatic licenses מופיעה.
אם תשנו את המינוי הזה להקצאת רישיונות אוטומטית, הקצאת הרישיונות הידנית תושבת אחרי השינוי, אבל הקצאות רישיונות קיימות לא יושפעו.
מגדירים את משך הזמן שיחלוף עד לביטול ההקצאה של הרישיון אם המשתמש שהוקצה לו לא פעיל, ולוחצים על Confirm Change. תיבת הדו-שיח Automatic license assignment has been enabled מופיעה.
אם הגדרתם
T
ימים של חוסר פעילות לביטול ההקצאה, הרישיונות יבטלו את ההקצאה באופן אוטומטי ויופיעו במאגר הרישיונות ביוםT+1
. לדוגמה, אם תגדירו7
ימים של חוסר פעילות לביטול ההקצאה, הרישיונות יבטלו את ההקצאה ויופיעו במאגר הרישיונות ביום8
.בוחרים באפשרות סגירה.
חשוב לוודא שהקציתם למשתמשים את התפקידים 'משתמש ב-Gemini for Google Cloud' ו'צרכן של שימוש בשירות' ב-IAM.
משתמשים עם ההרשאה
cloudaicompanion.licenses.selfAssign
מקבלים רישיון באופן אוטומטי בפעם הראשונה שהם ניגשים ל-Gemini Code Assist Standard או Enterprise בפרויקט שמחויב דרך חשבון לחיוב שיש בו מינוי תקף שמוגדר להקצאת רישיונות אוטומטית, ויש בו רישיונות זמינים שמכוסים על ידי המינויים בחשבון לחיוב.
כדי להשבית את הקצאת הרישיונות האוטומטית:
במסוף Google Cloud , עוברים לדף Admin for Gemini.
בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות ניהול המינוי.
בוחרים באפשרות ניהול רישיונות ואז באפשרות ניהול הקצאת רישיונות אוטומטית. תיבת הדו-שיח Manage automatic license assignment מופיעה.
בוחרים באפשרות Disable automatic license management.
בוחרים באפשרות אישור השינוי.
ביטול ההקצאה של רישיונות Gemini Code Assist Standard ו-Enterprise באופן ידני
בוחרים באחת מהאפשרויות הבאות:
המסוף
חשוב לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שבבעלותו המינוי:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.unassign
resourcemanager.projects.get
עוברים לדף ניהול Gemini.
בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות ניהול המינוי.
בוחרים באפשרות ניהול רישיונות ואז באפשרות ניהול הקצאת רישיונות אוטומטית. תיבת הדו-שיח Manage automatic license assignment מופיעה.
בוחרים את המשתמשים שרוצים לבטל את ההקצאה של הרישיונות שלהם, ואז בוחרים באפשרות ביטול הקצאת רישיון.
לוחצים על אישור.
API
כדי לבטל את ההקצאה של רישיונות Gemini Code Assist Standard ו-Enterprise, משתמשים בשיטה billingAccounts.orders.licensePool.unassign
.
כדי לבצע את המשימה הזו, צריכה להיות לכם הרשאת ניהול זהויות והרשאות גישה (IAM)
consumerprocurement.licensePools.unassign
בחשבון לחיוב שמכיל את מאגר הרישיונות שאת הרישיון שלו אתם רוצים לבטל את ההקצאה שלו.יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "usernames": [ USER_EMAILS ] }
מחליפים את
USER_EMAILS
ברשימת חשבונות משתמשים שמוקצה להם הרישיון, מופרדים בפסיקים. לדוגמה:"dana@example.com", "lee@example.com"
.משתמשים ב-
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 בפרויקט.
- משתמשים בהרשאות כדי לדחות את הגישה של משתמשים לפרויקט.
מגבלות
- Gemini לניהול רישיונות לא תומך באיחוד שירותי אימות הזהות של כוח עבודה. Google Cloud