Эта страница переведена с помощью Cloud Translation API.

Управление лицензиями Gemini Code Assist

Прежде чем использовать Gemini Code Assist, каждому пользователю в вашей организации необходима лицензия.

По умолчанию новые подписки требуют назначения лицензий вручную. После того как вы настроите определенные продукты Gemini для Google Cloud, вы сможете назначать лицензии вручную или автоматически .

Прежде чем начать

Убедитесь, что у вас есть роли IAM администратора учетной записи выставления счетов ( roles/billing.admin ) или администратора заказов на потребительские закупки ( roles/consumerprocurement.orderAdmin ), чтобы вы могли предоставить дополнительные разрешения, необходимые для учетной записи выставления счетов для конкретных задач управления лицензиями, подробно описанных в следующих разделах.

Если вы хотите управлять лицензиями с помощью API, а не консоли Google Cloud, убедитесь в следующем:
- Настройте проект квоты для своего платежного аккаунта.
- Включите API Cloud Commerce Consumer Procurement в своем проекте квоты.
- Убедитесь, что во всех вызовах API присутствуют следующие пары «ключ-значение» заголовка:
  - Authorization : ваш токен доступа к Google Cloud из интерфейса командной строки Google Cloud.
  - x-goog-user-project : идентификатор вашего проекта квоты.

Изменение количества лицензий Gemini Code Assist в подписке

Вы можете добавить или удалить количество лицензий Gemini для Google Cloud непосредственно через консоль Google Cloud, через представителя своей учетной записи Google или авторизованного реселлера.

Чтобы изменить количество лицензий в подписке, выполните следующие действия:

Убедитесь, что у вас есть следующие разрешения на управление идентификацией и доступом для учетной записи выставления счетов, которой принадлежит подписка:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.orders.modify
- resourcemanager.projects.get
В консоли Google Cloud перейдите на страницу «Администратор Gemini» .
Перейдите в Gemini для Google Cloud
Выберите подписку, которую вы хотите изменить, а затем выберите «Изменить подписку» .
Введите количество лицензий, которое вы хотите иметь. Отображается следующая информация:
- Общее количество лицензий после покупки.
- Количество лицензий, доступных для назначения после покупки.
- Новая цена подписки за триместр. Дополнительная сумма за добавленные лицензии рассчитывается пропорционально тому, сколько времени осталось до текущего срока.
Выберите Сохранить .

Просмотр назначений лицензий Gemini Code Assist

Выберите один из следующих вариантов:

Консоль API

Убедитесь, что у вас есть следующие разрешения IAM для учетной записи выставления счетов, которой принадлежит подписка:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- resourcemanager.projects.get
Перейдите на страницу администратора Gemini .
Перейдите в Gemini для Google Cloud
Выберите подписку, которую вы хотите изменить, а затем выберите «Изменить подписку» .
Для каждого пользователя, которому назначена лицензия, доступна следующая информация:
- Имя.
- Электронная почта.
- Дата присвоения лицензии.
- Дата и время последнего использования лицензии.
Чтобы найти определенный набор пользователей, вы можете отфильтровать и отсортировать список следующим образом:
- Чтобы отфильтровать список, в поле Фильтр введите свойства и значения.
- Чтобы отсортировать список, выберите заголовок столбца, по которому вы хотите выполнить сортировку. Например, чтобы отсортировать имена пользователей в алфавитном порядке, выберите заголовок столбца «Имя» .

Чтобы просмотреть назначения лицензий 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": "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 отсутствуют или ORDER_ID недействителен, он возвращает выходные данные licensedUsers в следующем формате:

{}

Назначайте лицензии Gemini Code Assist вручную отдельным пользователям.

Выберите один из следующих вариантов:

Консоль API

Убедитесь, что у вас есть следующие разрешения IAM для учетной записи выставления счетов, которой принадлежит подписка:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.assign
- resourcemanager.projects.get
Перейдите на страницу администратора Gemini .
Перейдите в Gemini для Google Cloud
Выберите «Управление Gemini Code Assist» , а затем выберите «Изменить подписку» .
Для этой подписки Gemini Code Assist убедитесь, что для параметра «Назначение лицензий» установлено значение «Назначать лицензии вручную» . Если для подписки Gemini Code Assist установлено значение «Автоматически назначать лицензии» , вы не сможете управлять отдельными лицензиями. Переключение этого платежного аккаунта на назначение лицензий вручную отключает автоматическое назначение лицензий после изменения, но существующие назначения лицензий не затрагиваются.
Выберите «Назначить лицензии» . Появится диалог выбора пользователя. Чтобы найти конкретных пользователей, введите их адрес электронной почты и нажмите «Далее» .
Выберите «Назначить лицензии» .
Убедитесь, что вы предоставили роли IAM Gemini for Google Cloud User и Service Usage Consumer для лицензированных пользователей.

Чтобы назначить лицензии 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": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Замените следующее:

BILLING_ACCOUNT_ID : идентификатор платежного аккаунта.
ORDER_ID : политика IAM.

Если команда выполнена успешно, она возвращает пустое тело ответа в следующем формате:

{}

Чтобы проверить назначение, просмотрите список назначений .

Затем убедитесь, что вы предоставили роли IAM Gemini for Google Cloud User и Service Usage Consumer для лицензированных пользователей.

Автоматически назначать лицензии Gemini Code Assist

Вы можете автоматически назначить лицензию любому пользователю в вашей организации, которому требуется доступ к Gemini Code Assist, на странице назначения лицензий . Автоматическое назначение лицензии настраивается индивидуально для каждой подписки.

Если вы решите автоматически назначать лицензии для Gemini Code Assist, вы не сможете удалять или добавлять отдельные пользовательские лицензии под этой учетной записью. Пользователи с назначенными лицензиями, которые не использовали какие-либо функции Gemini Code Assist, автоматически отключаются в конце расчетного периода после определенного количества дней бездействия, установленного администратором.

В консоли Google Cloud перейдите на страницу «Администратор Gemini» .
Перейдите в Gemini для Google Cloud
Выберите «Управление Gemini Code Assist» , а затем выберите «Управление подпиской» .
Выберите «Управление лицензиями» , а затем выберите «Включить автоматическое назначение лицензий» . Появится диалоговое окно Включить автоматические лицензии .
Переключение этой подписки на автоматическое назначение лицензий отключает назначение лицензий вручную после изменения, но ранее существовавшие назначения лицензий не затрагиваются.
Установите период времени, в течение которого лицензия будет отменена, если правопреемник неактивен, затем выберите «Подтвердить изменение» . Появится диалоговое окно Автоматическое назначение лицензии включено .
Выберите Закрыть .
Убедитесь, что вы предоставили роли IAM Gemini for Google Cloud User и Service Usage Consumer для лицензированных пользователей.
Пользователи с разрешением cloudaicompanion.licenses.selfAssign автоматически получают лицензию при первом доступе к Gemini Code Assist в проекте, оплаченном с помощью учетной записи для выставления счетов, имеющей действительную подписку, настроенную для автоматического назначения лицензий, и в учетной записи для выставления счетов имеются доступные лицензии, охватываемые вашими подписками.

Чтобы отключить автоматическое назначение лицензии, выполните следующие действия:

В консоли Google Cloud перейдите на страницу «Администратор Gemini» .
Перейдите в Gemini для Google Cloud
Выберите «Управление Gemini Code Assist» , а затем выберите «Управление подпиской» .
Выберите «Управление лицензиями» , а затем выберите «Управление автоматическим назначением лицензий» . Появится диалоговое окно «Управление автоматическим назначением лицензий» .
Выберите «Отключить автоматическое управление лицензиями» .
Выберите Подтвердить изменение .

Отмена назначения лицензий Gemini Code Assist вручную

Выберите один из следующих вариантов:

Консоль API

Убедитесь, что у вас есть следующие разрешения IAM для учетной записи выставления счетов, которой принадлежит подписка:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.unassign
- resourcemanager.projects.get
Перейдите на страницу администратора Gemini .
Перейдите в Gemini для Google Cloud
Выберите «Управление Gemini Code Assist» , а затем выберите «Управление подпиской» .
Выберите «Управление лицензиями» , а затем выберите «Управление автоматическим назначением лицензий» . Появится диалоговое окно «Управление автоматическим назначением лицензий» .
Выберите пользователей, для которых вы хотите отменить назначение лицензий, затем выберите «Отменить назначение лицензии» .
Выберите Подтвердить .

Чтобы отменить назначение лицензий 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": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Замените следующее:

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 для Google Cloud API в проекте.
Используйте разрешения, чтобы запретить пользователям доступ к проекту.

Ограничения

Gemini для управления лицензиями Google Cloud не поддерживает Workforce Identity Federation .