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 moins d'éléments que 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. Filtrer les résultats

orderBy

string

Facultatif. Indication sur la façon de trier les résultats

startTime

string (Timestamp format)

Obligatoire. Les licences sont achetées par mois. Par conséquent, le suivi de l'utilisation nécessite une date de début du mois.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" 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 mensuel. Ce paramètre correspond à l'heure de fin du mois.

Utilise la norme RFC 3339, où le résultat généré est toujours normalisé avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" 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.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez 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.