Administra las licencias de Gemini Code Assist Standard y Enterprise

Console

1. Asegúrate de tener los siguientes permisos de IAM en la cuenta de facturación propietaria de la suscripción:

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

2. Ve a la página Administrador de Gemini y selecciona el proyecto adjunto a tu cuenta de facturación con la suscripción a Gemini Code Assist Standard o Enterprise.

   Ir a Gemini para Google Cloud

3. Elige la suscripción que deseas cambiar y, luego, selecciona Modificar suscripción.

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

   • Nombre
   • el correo electrónico,
   • Fecha en que se asignó la licencia.
   • Fecha y hora en que se usó la licencia por última vez.

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

   • Para filtrar la lista, ingresa las propiedades y los valores en el campo Filtro.
   • Para ordenar la lista, selecciona el encabezado de la columna por la que deseas ordenar. Por ejemplo, para ordenar alfabéticamente por los nombres de los usuarios, selecciona el encabezado de la columna Nombre.

API

Para ver las asignaciones de licencias de Gemini Code Assist Standard o Enterprise, usa el método billingAccounts.orders.licensePool.enumerateLicensedUsers.

1. Asegúrate 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 deseas ver.

2. Usa 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/"
   

   Reemplaza lo siguiente:

   • PROJECT_ID: Es el ID de un proyecto. El uso de la cuota y los cargos asociados con la solicitud a la API se aplican a este proyecto.
   • BILLING_ACCOUNT_ID: Es el ID de la cuenta de facturación asociada con el grupo de licencias.
   • ORDER_ID: Es el ID del pedido. Si no conoces el ID del pedido, puedes recuperarlo enumerando los pedidos asociados a tu cuenta de facturación.

Si el comando tiene éxito, se muestra el resultado 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 de Gemini Code Assist Standard o Enterprise, o si el ORDER_ID no es válido, se devuelve el resultado licensedUsers en el siguiente formato:

{}

Console

1. Asegúrate de tener los siguientes permisos de IAM en la cuenta de facturación propietaria de la suscripción:

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

2. Ve a la página Administrador de Gemini.

   Ir a Gemini para Google Cloud

3. Selecciona Administrar Gemini Code Assist y, luego, Modificar suscripción.

4. Para esta suscripción a Gemini Code Assist Standard o Enterprise, asegúrate de configurar Asignación de licencias como Asignar licencias manualmente. Si la suscripción a Gemini Code Assist Standard o Enterprise está configurada como Asignar licencias automáticamente, no podrás administrar licencias individuales. Si cambias esta cuenta de facturación a Asignar licencias manualmente, se desactivará la asignación automática de licencias después del cambio, pero las asignaciones de licencias existentes no se verán afectadas.

5. Selecciona Asignar licencias. Aparecerá un cuadro de diálogo de selección del usuario. Para buscar usuarios específicos, ingresa su dirección de correo electrónico y, luego, selecciona Siguiente.

6. Selecciona Asignar licencias.

7. Asegúrate de otorgar los roles de IAM de Usuario de Gemini para Google Cloud y Consumidor de Service Usage a los usuarios con licencia.

API

Para asignar licencias de Gemini Code Assist Standard y Enterprise, usa el método billingAccounts.orders.licensePool.assign.

1. Asegúrate de tener los siguientes permisos de IAM en la cuenta de facturación que contiene el grupo de licencias cuya licencia deseas 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
     ]
   }
   

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

3. Usa 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/"

   Reemplaza lo siguiente:

   • JSON_FILE_NAME: Es la ruta de acceso al archivo JSON que creaste en el paso 2.
   • PROJECT_ID: Es el ID de un proyecto. El uso de la cuota y los cargos asociados con la solicitud a la API se aplican a este proyecto.
   • BILLING_ACCOUNT_ID: Es el ID de la cuenta de facturación asociada con el grupo de licencias.
   • ORDER_ID: Es el ID del pedido. Si no conoces el ID del pedido, puedes recuperarlo enumerando los pedidos asociados a tu cuenta de facturación.

Si se ejecuta de forma correcta, la respuesta será similar a la siguiente:

{}

Para verificar la asignación, consulta la lista de tareas.

Luego, asegúrate de otorgar los roles de IAM de Usuario de Gemini para Google Cloud y Consumidor de Service Usage a los usuarios con licencia.

Console

1. Asegúrate de tener los siguientes permisos de IAM en la cuenta de facturación propietaria de la suscripción:

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

2. Ve a la página Administrador de Gemini.

   Ir a Gemini para Google Cloud

3. Selecciona Administrar Gemini Code Assist y, luego, Administrar suscripción.

4. Selecciona Administración de licencias y, luego, Administrar la asignación automática de licencias. Aparecerá el diálogo Administrar la asignación automática de licencias.

5. Selecciona los usuarios a los que quieras quitar la asignación de licencias y, luego, selecciona Quitar la asignación de licencias.

6. Selecciona Confirmar.

API

Para anular la asignación de licencias de Gemini Code Assist Standard y Enterprise, usa el método billingAccounts.orders.licensePool.unassign.

1. Para realizar esta tarea, debes tener el permiso consumerprocurement.licensePools.unassign de Identity and Access Management (IAM) en la cuenta de facturación que contiene el grupo de licencias cuya licencia deseas anular la asignación.

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

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

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

3. Usa 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/"

   Reemplaza lo siguiente:

   • JSON_FILE_NAME: Es la ruta de acceso al archivo JSON que creaste en el paso 2.
   • PROJECT_ID: Es el ID de un proyecto. El uso de la cuota y los cargos asociados con la solicitud a la API se aplican a este proyecto.
   • BILLING_ACCOUNT_ID: Es el ID de la cuenta de facturación asociada con el grupo de licencias.
   • ORDER_ID: Es el ID del pedido. Si no conoces el ID del pedido, puedes recuperarlo enumerando los pedidos asociados a tu cuenta de facturación.

Si se ejecuta de forma correcta, la respuesta será similar a la siguiente:

{}

Para verificar la anulación de la asignación, consulta la lista de asignaciones.