- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Autorisations IAM
- Utilisation
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 |
Obligatoire. Valeur parente pour AggregateUsageRequest |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
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 |
Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer. |
filter |
Facultatif. Filtrer les résultats |
orderBy |
Facultatif. Indication sur la façon de trier les résultats |
startTime |
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 : |
endTime |
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 : |
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 ( |
Champs | |
---|---|
usages[] |
Enregistrements agrégés de l'utilisation par configuration |
nextPageToken |
Jeton identifiant une page de résultats que le serveur doit renvoyer. |
unreachable[] |
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 |
Nom de ressource de l'instance LiMa, c'est-à-dire projects/{project}/locations/{location}/instances/{instance} |
users |
Nombre d'utilisateurs uniques accédant à la VM. |