REST Resource: projects.locations.licenseConfigs

Recurso: LicenseConfig

Es información sobre las licencias de los usuarios.

Representación JSON 
{
  "name": string,
  "licenseCount": string,
  "subscriptionTier": enum (SubscriptionTier),
  "state": enum (State),
  "autoRenew": boolean,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "subscriptionTerm": enum (SubscriptionTerm),
  "freeTrial": boolean,
  "geminiBundle": boolean,
  "earlyTerminated": boolean,
  "earlyTerminationDate": {
    object (Date)
  },
  "lastUserUpdateTime": string
}
Campos
name

string

Inmutable. Es el identificador. Es el nombre del recurso completamente calificado de la configuración de licencia. Formato: projects/{project}/locations/{location}/licenseConfigs/{licenseConfig}
licenseCount

string (int64 format)

Obligatorio. Cantidad de licencias compradas.
subscriptionTier

enum (SubscriptionTier)

Obligatorio. Es la información del nivel de suscripción para la configuración de la licencia.
state

enum (State)

Solo salida. Es el estado de la configuración de licencias.
autoRenew

boolean

Es opcional. Indica si la configuración de la licencia se debe renovar automáticamente cuando llegue a la fecha de finalización.
startDate

object (Date)

Obligatorio. Es la fecha de inicio.
endDate

object (Date)

Es opcional. Es la fecha de finalización prevista.
subscriptionTerm

enum (SubscriptionTerm)

Obligatorio. Es el plazo de suscripción.
freeTrial

boolean

Es opcional. Indica si la configuración de la licencia es para una prueba gratuita.
geminiBundle

boolean

Solo salida. Indica si la configuración de la licencia es para el paquete de Gemini.
earlyTerminated

boolean

Solo salida. Indicación de si la suscripción se canceló antes de la fecha de vencimiento. Por lo general, la canalización finaliza este proceso una vez que se cancela la suscripción desde subsv3.
earlyTerminationDate

object (Date)

Solo salida. Fecha en la que se canceló la suscripción antes de la fecha de vencimiento.
lastUserUpdateTime

string (Timestamp format)

Opcional. Es la marca de tiempo de la actualización más reciente iniciada por el usuario (cambio en el recuento de asientos o en el plazo de la suscripción). A diferencia de updateTime, este campo solo se marca cuando un cliente actualiza explícitamente la licencia (p.ej., a través de la IU) y no se ve afectado por las escrituras controladas por el sistema (canalización de suscripciones, propagación de BALC, etc.).

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Estado

Es la enumeración del estado de la configuración de licencias.

Enums
STATE_UNSPECIFIED Valor predeterminado. No existe la configuración de licencias.
ACTIVE La configuración de la licencia es efectiva y se está usando.
EXPIRED Venció la configuración de licencias.
NOT_STARTED La configuración de la licencia aún no comenzó y su fecha de inicio es posterior a la actual.
WITHDRAWN Esto sucede cuando una configuración de licencia secundaria devolvió todos sus cupos a BillingAccountLicenseConfig al que pertenece. Es similar a EXPIRED.
DEACTIVATING La configuración de licencias está en período de gracia. Su suscripción finalizó, ya sea por cancelación anticipada o por alcanzar la fecha de finalización, pero el cliente conserva el acceso por un tiempo limitado. Se convierte en EXPIRED cuando finaliza el período de gracia.

SubscriptionTerm

Es el plazo de suscripción.

Enums
SUBSCRIPTION_TERM_UNSPECIFIED Valor predeterminado que no se debe usar.
SUBSCRIPTION_TERM_ONE_MONTH 1 mes
SUBSCRIPTION_TERM_ONE_YEAR 1 año
SUBSCRIPTION_TERM_THREE_YEARS 3 años
SUBSCRIPTION_TERM_CUSTOM Es un término personalizado. Se debe establecer la fecha de finalización.

Métodos

create

 Crea un objeto LicenseConfig. Este método solo se debe usar para crear licencias de NotebookLM o licencias de prueba gratuita de Gemini Enterprise.

get

 Obtienes una LicenseConfig.

list

 Enumera todos los LicenseConfig asociados al proyecto.

patch

 Actualiza el LicenseConfig