Method: projects.locations.configurations.aggregateUsage

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

string

Obbligatorio. Valore principale per AggregateUsageRequest

Parametri di query

Parametri
pageSize

integer

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

string

Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
filter

string

Facoltativo. Filtro dei risultati
orderBy

string

Facoltativo. Suggerimento su come ordinare i risultati
startTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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 (Usage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
usages[]

object (Usage)

I record aggregati di utilizzo per configurazione
nextPageToken

string

Un token che identifica una pagina di risultati che il server deve restituire.
unreachable[]

string

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

string

Nome della risorsa dell'istanza LiMa, ad esempio projects/{project}/locations/{location}/instances/{instance}
users

integer

Numero di utenti unici che accedono alla VM.