Method: projects.locations.configurations.aggregateUsage

Fasst für eine Konfiguration die Nutzung pro Instanz zusammen

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Übergeordneter Wert für „AggregateUsageRequest“

Anfrageparameter

Parameter
pageSize

integer

Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server einen geeigneten Standardwert aus.
pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll
filter

string

Optional. Ergebnisse filtern
orderBy

string

Optional. Hinweis zur Sortierung der Ergebnisse
startTime

string (Timestamp format)

Erforderlich. Lizenzen werden pro Monat erworben. Für die Erfassung der Nutzung muss als Startzeitpunkt daher ein Monat angegeben werden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

Erforderlich. Die Nutzung wird immer für einen Monat erfasst. Dieser Parameter gibt das Ende des Monats an.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Nachricht für die Antwort zum Zusammenfassen der Nutzungsanzahl

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "usages": [
    {
      object (Usage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
usages[]

object (Usage)

Die aggregierten Nutzungsdatensätze pro Konfiguration
nextPageToken

string

Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll
unreachable[]

string

Standorte, die nicht erreicht werden konnten

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • licensemanager.configurations.aggregateUsage

Weitere Informationen finden Sie in der IAM-Dokumentation.

Nutzung

Nachricht mit der Gesamtanzahl der Nutzer, die auf eine VM zugegriffen haben

JSON-Darstellung 
{
  "limaInstance": string,
  "users": integer
}
Felder
limaInstance

string

Ressourcenname der LiMa-Instanz, z. B. projects/{project}/locations/{location}/instances/{instance}
users

integer

Anzahl der einzelnen Nutzer, die auf die VM zugreifen