Administrar licencias estándar y empresariales de Gemini Code Assist

Antes de utilizar Gemini Code Assist Standard y Enterprise, cada usuario de su organización necesita una licencia.

De forma predeterminada, las nuevas suscripciones requieren que asigne licencias manualmente. Después de configurar ciertas licencias de Gemini para Google Cloud productos, luego puede elegir asignar licencias de forma manual o automática .

Antes de empezar

  • Asegúrese de tener los roles de IAM de Administrador de cuenta de facturación ( roles/billing.admin ) o Administrador de pedidos de compras del consumidor ( roles/consumerprocurement.orderAdmin ) para poder otorgar permisos adicionales necesarios en la cuenta de facturación para tareas de administración de licencias específicas detalladas en las siguientes secciones.
  • Si desea administrar licencias mediante una API en lugar de la Google Cloud consola, luego asegúrese de lo siguiente:

Cambiar la cantidad de licencias de Gemini Code Assist Standard y Enterprise en una suscripción

Puedes agregar o eliminar el número de Géminis para Google Cloud licencias directamente a través de la Google Cloud consola, o a través de su representante de cuenta de Google o un distribuidor autorizado.

Para cambiar la cantidad de licencias en una suscripción, siga estos pasos:

  1. Asegúrese de tener los siguientes permisos de Administración de identidad y acceso (IAM) en la cuenta de facturación propietaria de la suscripción:

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

  2. En el Google Cloud consola, vaya a la página Admin de Gemini .

    Vaya a Géminis para Google Cloud

  3. Seleccione la suscripción que desea cambiar y luego seleccione Modificar suscripción .

  4. Introduzca el número de licencias que desea. Se mostrará la siguiente información:

    • Número de licencias totales después de la compra.
    • Número de licencias disponibles para asignación luego de la compra.
    • Nuevo precio de suscripción por periodo. El importe adicional por las licencias añadidas se prorratea según el tiempo restante del periodo actual.

  5. Seleccione Guardar .

Ver las asignaciones de licencias estándar y empresariales de Gemini Code Assist

Seleccione una de las siguientes opciones:

Consola

  1. Asegúrese de tener los siguientes permisos de IAM en la cuenta de facturación que posee la suscripción:

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

  2. Vaya a la página de Administración de Gemini y seleccione el proyecto asociado a su cuenta de facturación con la suscripción Gemini Code Assist Standard o Enterprise.

    Vaya a Géminis para Google Cloud

  3. Seleccione la suscripción que desea cambiar y luego seleccione Modificar suscripción .

    La siguiente información está disponible para cada usuario al que se le ha asignado una licencia:

    • Nombre.
    • Correo electrónico.
    • Fecha en que se asignó la licencia.
    • Fecha y hora en que se utilizó la licencia por última vez.

  4. Para encontrar un conjunto específico de usuarios, puede filtrar y ordenar la lista de la siguiente manera:

    • Para filtrar la lista, en el campo Filtro , ingrese las propiedades y los valores.
    • Para ordenar la lista, seleccione el encabezado de la columna por la que desea ordenar. Por ejemplo, para ordenar alfabéticamente por nombre de usuario, seleccione el encabezado de la columna "Nombre" .

API

Para ver las asignaciones de licencias estándar o empresariales de Gemini Code Assist, utilice el método billingAccounts.orders.licensePool.enumerateLicensedUsers .

  1. Asegúrese de tener el permiso de IAM consumerprocurement.licensePools.enumerateLicensedUsers en la cuenta de facturación que contiene el grupo de licencias cuyas asignaciones de licencias desea ver.

  2. Utilice cURL para llamar al método:

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

    Reemplace lo siguiente:

    • PROJECT_ID : ID del proyecto. El uso de cuota y los cargos asociados a la solicitud de API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID : el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID : ID del pedido. Si no conoce el ID del pedido, puede recuperarlo listando los pedidos asociados a su cuenta de facturación .

Si el comando tiene éxito, devuelve la salida licensedUsers en el siguiente formato:

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

Si no hay asignaciones de licencias estándar o empresariales de Gemini Code Assist o el ORDER_ID no es válido, devuelve la salida licensedUsers en el siguiente formato:

{}

Asignar manualmente licencias estándar y empresariales de Gemini Code Assist a usuarios individuales

Seleccione una de las siguientes opciones:

Consola

  1. Asegúrese de tener los siguientes permisos de IAM en la cuenta de facturación que posee la suscripción:

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

  2. Vaya a la página de administración de Gemini .

    Vaya a Géminis para Google Cloud

  3. Seleccione Administrar Gemini Code Assist y luego seleccione Modificar suscripción .

  4. Para esta suscripción a Gemini Code Assist Standard o Enterprise, asegúrese de configurar la Asignación de Licencias en Asignar Licencias Manualmente . Si la suscripción a Gemini Code Assist Standard o Enterprise está configurada en Asignar Licencias Automáticamente , no podrá administrar licencias individuales. Al cambiar esta cuenta de facturación a Asignar Licencias Manualmente, se desactiva la asignación automática de licencias después del cambio, pero las asignaciones de licencias preexistentes no se ven afectadas.

  5. Seleccione "Asignar licencias" . Aparecerá un cuadro de diálogo de selección de usuarios. Para buscar usuarios específicos, introduzca su dirección de correo electrónico y seleccione "Siguiente" .

  6. Seleccione Asignar licencias .

  7. Asegúrese de otorgar los roles de IAM de consumidor de uso de servicio y usuario de Gemini para Google Cloud a los usuarios con licencia.

API

Para asignar licencias estándar y empresariales de Gemini Code Assist, utilice el método billingAccounts.orders.licensePool.assign .

  1. Asegúrese de tener los siguientes permisos de IAM en la cuenta de facturación que contiene el grupo de licencias cuya licencia desea asignar:

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

  2. Crea un archivo JSON que contenga la siguiente información:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Reemplace USER_EMAILS con una lista separada por comas de cuentas de usuario a las que se les asignará la licencia, por ejemplo, "dana@example.com", "lee@example.com" .

  3. Utilice cURL para llamar al método:

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

    Reemplace lo siguiente:

    • JSON_FILE_NAME : la ruta del archivo JSON que creó en el paso 2.
    • PROJECT_ID : ID del proyecto. El uso de cuota y los cargos asociados a la solicitud de API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID : el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID : ID del pedido. Si no conoce el ID del pedido, puede recuperarlo listando los pedidos asociados a su cuenta de facturación .

Si tiene éxito, la respuesta es similar a la siguiente:

{}

Para verificar la asignación, consulte la lista de asignaciones .

Luego, asegúrese de otorgar los roles de IAM de consumidor de uso de servicio y usuario de Gemini para Google Cloud a los usuarios con licencia.

Asignar automáticamente licencias estándar y empresariales de Gemini Code Assist

Puede asignar automáticamente una licencia a cualquier usuario de su organización que necesite acceder a Gemini Code Assist Standard o Enterprise desde la página "Asignación de licencias" . La asignación automática de licencias se configura individualmente para cada suscripción.

La asignación automática de licencias solo es compatible con VS Code, IntelliJ y otros IDE de JetBrains compatibles .

Si elige asignar licencias automáticamente para Gemini Code Assist Standard o Enterprise, no podrá eliminar ni agregar licencias de usuario individuales en esa cuenta. Los usuarios con licencias asignadas que no hayan utilizado ninguna función de Gemini Code Assist Standard o Enterprise serán dados de baja automáticamente al finalizar el período de inactividad establecido por el administrador.

  1. En el Google Cloud consola, vaya a la página Admin de Gemini .

    Vaya a Géminis para Google Cloud

  2. Seleccione Administrar Gemini Code Assist y luego seleccione Administrar suscripción .

  3. Seleccione Administración de licencias y, a continuación , Habilitar asignación automática de licencias . Aparecerá el cuadro de diálogo Habilitar licencias automáticas .

    Al cambiar esta suscripción para asignar licencias automáticamente se desactiva la asignación manual de licencias después del cambio, pero las asignaciones de licencias preexistentes no se ven afectadas.

  4. Establezca el tiempo que debe transcurrir para que una licencia se cancele si el cesionario está inactivo y, a continuación, seleccione "Confirmar cambio" . Aparecerá el cuadro de diálogo "Se ha habilitado la asignación automática de licencias" .

    Si configuró T días de inactividad para la desasignación, las licencias se desasignarán automáticamente y estarán disponibles en el grupo de licencias el día T+1 . Por ejemplo, si configura 7 días de inactividad para la desasignación, las licencias se desasignarán y estarán disponibles en el grupo de licencias el día 8 .

  5. Seleccione Cerrar .

  6. Asegúrese de otorgar los roles de IAM de consumidor de uso de servicio y usuario de Gemini para Google Cloud a los usuarios con licencia.

    Los usuarios con el permiso cloudaicompanion.licenses.selfAssign reciben automáticamente una licencia cuando acceden por primera vez a Gemini Code Assist Standard o Enterprise en un proyecto pagado por una cuenta de facturación que tiene una suscripción válida configurada para la asignación automática de licencias y tiene licencias disponibles cubiertas por sus suscripciones en la cuenta de facturación.

Para deshabilitar la asignación automática de licencias, siga estos pasos:

  1. En el Google Cloud consola, vaya a la página Admin de Gemini .

    Vaya a Géminis para Google Cloud

  2. Seleccione Administrar Gemini Code Assist y luego seleccione Administrar suscripción .

  3. Seleccione Administración de licencias y, a continuación , Administrar asignación automática de licencias . Aparecerá el cuadro de diálogo Administrar asignación automática de licencias .

  4. Seleccione Deshabilitar la gestión automática de licencias .

  5. Seleccione Confirmar cambio .

Desasignar manualmente las licencias estándar y empresariales de Gemini Code Assist

Seleccione una de las siguientes opciones:

Consola

  1. Asegúrese de tener los siguientes permisos de IAM en la cuenta de facturación que posee la suscripción:

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

  2. Vaya a la página de administración de Gemini .

    Vaya a Géminis para Google Cloud

  3. Seleccione Administrar Gemini Code Assist y luego seleccione Administrar suscripción .

  4. Seleccione Administración de licencias y, a continuación , Administrar asignación automática de licencias . Aparecerá el cuadro de diálogo Administrar asignación automática de licencias .

  5. Seleccione los usuarios para los cuales desea desasignar licencias y luego seleccione Desasignar licencia .

  6. Seleccione Confirmar .

API

Para anular la asignación de licencias estándar y empresariales de Gemini Code Assist, utilice el método billingAccounts.orders.licensePool.unassign .

  1. Para realizar esta tarea, debe tener el permiso de Administración de identidad y acceso (IAM) consumerprocurement.licensePools.unassign en la cuenta de facturación que contiene el grupo de licencias cuya licencia desea desasignar.

  2. Crea un archivo JSON que contenga la siguiente información:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Reemplace USER_EMAILS con una lista separada por comas de cuentas de usuario a las que se les asigna la licencia, por ejemplo, "dana@example.com", "lee@example.com" .

  3. Utilice cURL para llamar al método:

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

    Reemplace lo siguiente:

    • JSON_FILE_NAME : la ruta del archivo JSON que creó en el paso 2.
    • PROJECT_ID : ID del proyecto. El uso de cuota y los cargos asociados a la solicitud de API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID : el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID : ID del pedido. Si no conoce el ID del pedido, puede recuperarlo listando los pedidos asociados a su cuenta de facturación .

Si tiene éxito, la respuesta es similar a la siguiente:

{}

Para verificar la desasignación, consulte la lista de asignaciones .

Transferir licencias estándar y empresariales de Gemini Code Assist

Las licencias de Gemini Code Assist Standard y Enterprise no se pueden transferir directamente entre usuarios. En su lugar, cancele la asignación de la licencia de un usuario y luego asigne una nueva al nuevo usuario.

Prevenir el uso de licencias entre organizaciones

Las licencias de Gemini Code Assist Standard y Enterprise se asignan a usuarios individuales, no a organizaciones o proyectos, lo que permite que los usuarios individuales utilicen Gemini Code Assist Standard y Enterprise en varias organizaciones.

Los registros generados por el uso de Gemini Code Assist se guardan en el proyecto donde se realizó el uso, no en el licenciatario. Además, cualquier personalización o configuración de Gemini Code Assist (como la personalización del código ) se realiza en el proyecto, no a nivel de licencia o suscripción.

Para evitar aún más el uso entre organizaciones de Gemini Code Assist Standard y Enterprise en un proyecto, puede realizar una de las siguientes acciones:

  • Deshabilite la API de Gemini para Google Cloud en el proyecto.
  • Utilice permisos para denegar el acceso de los usuarios al proyecto.

Limitaciones

¿Qué sigue?