Method: projects.locations.configurations.aggregateUsage

Agrège l'utilisation par instance pour une configuration.

Requête HTTP

GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:aggregateUsage

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Valeur parente pour AggregateUsageRequest.

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Taille de la page demandée. Le serveur peut renvoyer un nombre d'éléments inférieur à celui demandé. Si aucune valeur n'est spécifiée, le serveur sélectionne une valeur par défaut appropriée.
pageToken

string

Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer.
filter

string

Facultatif. Filtrage des résultats.
orderBy

string

Facultatif. Indication sur la façon d'organiser les résultats
startTime

string (Timestamp format)

Obligatoire. Les licences sont achetées par mois. Le suivi de l'utilisation nécessite donc un mois comme date de début.

Utilise la norme RFC 3339, où le résultat généré se sert toujours du 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".
endTime

string (Timestamp format)

Obligatoire. Le suivi de l'utilisation est toujours effectué sur un mois. Ce paramètre correspond à la fin du mois.

Utilise la norme RFC 3339, où le résultat généré se sert toujours du 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".

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour l'agrégation du nombre d'utilisations

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "usages": [
    {
      object (Usage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
usages[]

object (Usage)

Enregistrements agrégés de l'utilisation par configuration
nextPageToken

string

Jeton identifiant une page de résultats que le serveur doit renvoyer.
unreachable[]

string

Emplacements inaccessibles.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • licensemanager.configurations.aggregateUsage

Pour en savoir plus, consultez la documentation IAM.

Utilisation

Message décrivant le nombre total d'utilisateurs ayant accédé à une VM.

Représentation JSON 
{
  "limaInstance": string,
  "users": integer
}
Champs
limaInstance

string

Nom de ressource de l'instance LiMa, c'est-à-dire projects/{project}/locations/{location}/instances/{instance}
users

integer

Nombre d'utilisateurs uniques accédant à la VM.