- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- IAM-Berechtigungen
- Nutzung
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 |
Pflichtangabe. Übergeordneter Wert für AggregateUsageRequest |
Abfrageparameter
Parameter | |
---|---|
pageSize |
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 |
Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. |
filter |
Optional. Ergebnisse filtern |
orderBy |
Optional. Hinweis zur Sortierung der Ergebnisse |
startTime |
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: |
endTime |
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: |
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 ( |
Felder | |
---|---|
usages[] |
Die aggregierten Nutzungsdatensätze pro Konfiguration |
nextPageToken |
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. |
unreachable[] |
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 |
LiMa-Instanzressourcenname, z.B. projects/{project}/locations/{location}/instances/{instance} |
users |
Anzahl der einzelnen Nutzer, die auf die VM zugreifen. |