REST Resource: projects.locations.licenseConfigs

Ressource : LicenseConfig

Informations sur les licences des utilisateurs.

Représentation JSON 
{
  "name": string,
  "licenseCount": string,
  "subscriptionTier": enum (SubscriptionTier),
  "state": enum (State),
  "autoRenew": boolean,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "subscriptionTerm": enum (SubscriptionTerm),
  "freeTrial": boolean,
  "alertPolicyResourceConfig": {
    object (AlertPolicyResourceConfig)
  },
  "geminiBundle": boolean,
  "earlyTerminated": boolean,
  "earlyTerminationDate": {
    object (Date)
  },
  "lastUserUpdateTime": string
}
Champs
name

string

Immuable. Identifiant. Nom complet de la configuration de licence. Format : projects/{project}/locations/{location}/licenseConfigs/{licenseConfig}
licenseCount

string (int64 format)

Obligatoire. Nombre de licences achetées.
subscriptionTier

enum (SubscriptionTier)

Obligatoire. Informations sur le niveau d'abonnement pour la configuration de la licence.
state

enum (State)

Uniquement en sortie. État de la configuration de la licence.
autoRenew

boolean

Facultatif. Indique si la configuration de la licence doit être renouvelée automatiquement lorsqu'elle arrive à échéance.
startDate

object (Date)

Obligatoire. Date de début.
endDate

object (Date)

Facultatif. Date de fin prévue.
subscriptionTerm

enum (SubscriptionTerm)

Obligatoire. Période d'abonnement.
freeTrial

boolean

Facultatif. Indique si la configuration de licence concerne un essai sans frais.
alertPolicyResourceConfig

object (AlertPolicyResourceConfig)

Facultatif. Configuration de la règle d'alerte pour cette configuration de licence.
geminiBundle

boolean

Uniquement en sortie. Indique si la configuration de licence concerne le bundle Gemini.
earlyTerminated

boolean

Uniquement en sortie. Indique si l'abonnement a été résilié avant la date d'expiration. Il est généralement arrêté par le pipeline une fois l'abonnement résilié depuis subsv3.
earlyTerminationDate

object (Date)

Uniquement en sortie. Date à laquelle l'abonnement est résilié avant la date d'expiration.
lastUserUpdateTime

string (Timestamp format)

Facultatif. Code temporel de la dernière mise à jour initiée par l'utilisateur (modification du nombre de postes ou de la durée de l'abonnement). Contrairement à updateTime, ce champ n'est estampillé que lorsqu'un client met à jour explicitement la licence (par exemple, via l'UI). Il n'est pas modifié par les écritures système (pipeline d'abonnement, propagation BALC, etc.).

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

État

Énumération de l'état de la configuration de la licence.

Enums
STATE_UNSPECIFIED Valeur par défaut. La configuration de licence n'existe pas.
ACTIVE La configuration de la licence est effective et utilisée.
EXPIRED La configuration de la licence a expiré.
NOT_STARTED La configuration de la licence n'a pas encore commencé et sa date de début est dans le futur.
WITHDRAWN Cela se produit lorsqu'une configuration de sous-licence a renvoyé tous ses sièges à la configuration de licence du compte de facturation auquel elle appartient. Semblable à EXPIRED.
DEACTIVATING La configuration de la licence est résiliée avant la date d'expiration et est en cours de désactivation. Dans cet état, le client aura toujours accès à son compte. Il passera à l'état "EXPIRÉ" à la fin de la période de désactivation (14 jours) ou à la date de fin, selon la première échéance.

AlertPolicyResourceConfig

Configuration des alertes au niveau des ressources. Utilisé dans : * UserLicense * EngineUserData L'AlertPolicyConfig dans le connecteur de données est utilisé de la même manière. Il n'existe pas de moyen simple de migrer.

Représentation JSON 
{
  "alertPolicy": string,
  "alertEnrollments": [
    {
      object (AlertEnrollment)
    }
  ],
  "contactDetails": [
    {
      object (ContactDetails)
    }
  ],
  "languageCode": string,
  "regionCode": string
}
Champs
alertPolicy

string

Immuable. Nom complet de la ressource AlertPolicy.
alertEnrollments[]

object (AlertEnrollment)

Facultatif. État d'inscription de chaque alerte.
contactDetails[]

object (ContactDetails)

Facultatif. Coordonnées de chaque règle d'alerte.
languageCode

string

Facultatif. Code de langue utilisé pour les notifications
regionCode

string

Facultatif. Code de région de l'utilisateur qui s'est abonné à la règle d'alerte.

AlertEnrollment

État de l'inscription à l'alerte.

Représentation JSON 
{
  "alertId": string,
  "enrollState": enum (EnrollState),
  "notificationParams": {
    string: string,
    ...
  }
}
Champs
alertId

string

Immuable. ID d'une alerte.
enrollState

enum (EnrollState)

Obligatoire. État d'inscription d'un client.
notificationParams

map (key: string, value: string)

Facultatif. Paramètres utilisés pour instancier une notification. Utilisé pour les notifications déclenchées lors de l'enregistrement. Elles ne sont pas stockées. * E-mails de bienvenue Gemini Business * E-mails d'invitation des utilisateurs Gemini Business

EnrollState

Énumération de l'état de l'inscription pour l'alerte.

Enums
ENROLL_STATE_UNSPECIFIED Valeur par défaut. Utilisé pour les clients qui n'ont pas répondu à la règle d'alerte.
ENROLLED Le client est inscrit à ce règlement.
DECLINED Le client a refusé cette règle.

ContactDetails

Coordonnées stockées au niveau de la ressource. Si les informations de contact au niveau du projet et de la ressource sont renseignées, celles au niveau de la ressource remplaceront celles au niveau du projet.

Représentation JSON 
{
  "emailAddress": string
}
Champs
emailAddress

string

Facultatif. Adresse e-mail du contact.

Méthodes

create

 Crée un LicenseConfig. Cette méthode ne doit être utilisée que pour créer des licences NotebookLM ou des licences d'essai sans frais Gemini Enterprise.

get

 Récupère un LicenseConfig.

list

 Liste tous les LicenseConfig associés au projet.

patch

 Met à jour le LicenseConfig.