- Richiesta HTTP
- Parametri del percorso
- Parametri di query
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Autorizzazioni IAM
- Utilizzo
Aggrega l'utilizzo per istanza per una configurazione.
Richiesta HTTP
GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:aggregateUsage
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Obbligatorio. Valore principale per AggregateUsageRequest |
Parametri di query
Parametri | |
---|---|
pageSize |
Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire un numero di elementi inferiore a quello richiesto. Se non specificato, il server sceglierà un valore predefinito appropriato. |
pageToken |
Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire. |
filter |
Facoltativo. Filtro dei risultati |
orderBy |
Facoltativo. Suggerimento su come ordinare i risultati |
startTime |
Obbligatorio. Le licenze vengono acquistate al mese, quindi il monitoraggio dell'utilizzo deve iniziare all'inizio di un mese. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
endTime |
Obbligatorio. Il monitoraggio dell'utilizzo è sempre mensile. Questo parametro indica l'ora di fine del mese. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio per la risposta per l'aggregazione del conteggio utilizzo
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"usages": [
{
object ( |
Campi | |
---|---|
usages[] |
I record aggregati di utilizzo per configurazione |
nextPageToken |
Un token che identifica una pagina di risultati che il server deve restituire. |
unreachable[] |
Località non raggiungibili. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Per ulteriori informazioni, consulta la Authentication Overview.
Autorizzazioni IAM
Richiede la seguente autorizzazione IAM per la risorsa name
:
licensemanager.configurations.aggregateUsage
Per saperne di più, consulta la documentazione di IAM.
Utilizzo
Messaggio che descrive i conteggi totali degli utenti che hanno eseguito l'accesso a una VM.
Rappresentazione JSON |
---|
{ "limaInstance": string, "users": integer } |
Campi | |
---|---|
limaInstance |
Nome della risorsa dell'istanza LiMa, ad esempio projects/{project}/locations/{location}/instances/{instance} |
users |
Numero di utenti unici che accedono alla VM. |