Method: projects.locations.configurations.aggregateUsage

Fasst die Nutzung pro Instanz für eine Konfiguration 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

Pflichtangabe. Übergeordneter Wert für AggregateUsageRequest

Abfrageparameter

Parameter
pageSize

integer

Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben ist, 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)

Pflichtangabe. Lizenzen werden pro Monat erworben. Für die Nutzungserfassung ist daher der Startzeitpunkt eines Monats erforderlich.

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)

Pflichtangabe. Der Nutzungszeitraum beträgt immer einen Monat. Dieser Parameter gibt die Endzeit 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 Aggregieren 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 Gesamtzahl der Nutzer, die auf eine VM zugegriffen haben.

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

string

LiMa-Instanzressourcenname, z.B. projects/{project}/locations/{location}/instances/{instance}

users

integer

Anzahl der einzelnen Nutzer, die auf die VM zugreifen.