Method: projects.locations.configurations.aggregateUsage

מצטבר השימוש בכל מופע של הגדרה.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. ערך ההורה של AggregateUsageRequest

פרמטרים של שאילתה

פרמטרים
pageSize

integer

זה שינוי אופציונלי. גודל הדף המבוקש. יכול להיות שהשרת יחזיר פחות פריטים מהמספר שצוין בבקשה. אם לא מציינים ערך, השרת יבחר ברירת מחדל מתאימה.
pageToken

string

זה שינוי אופציונלי. אסימון שמזהה איזה דף תוצאות השרת צריך להחזיר.
filter

string

זה שינוי אופציונלי. סינון התוצאות
orderBy

string

זה שינוי אופציונלי. הנחיה לגבי סדר התוצאות
startTime

string (Timestamp format)

חובה. הרישיונות נרכשים מדי חודש, ולכן צריך להגדיר את שעת ההתחלה של השימוש במסלול בחודש.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

חובה. המעקב אחר השימוש הוא תמיד חודשי. הפרמטר הזה מציין את שעת הסיום של החודש.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעה לתגובה לצורך צבירת נתוני השימוש

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "usages": [
    {
      object (Usage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
שדות
usages[]

object (Usage)

רשומות נצברות של נתוני השימוש לכל הגדרה
nextPageToken

string

אסימון שמזהה איזה דף תוצאות השרת צריך להחזיר.
unreachable[]

string

מיקומים שלא ניתן להגיע אליהם.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

ניתן למצוא מידע נוסף כאן: Authentication Overview.

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב name:

  • licensemanager.configurations.aggregateUsage

מידע נוסף מופיע במאמרי העזרה בנושא IAM.

Usage

הודעה שמתארת את המספר הכולל של משתמשים שניגשו למכונה וירטואלית.

ייצוג ב-JSON 
{
  "limaInstance": string,
  "users": integer
}
שדות
limaInstance

string

שם המשאב של מופע LiMa, כלומר projects/{project}/locations/{location}/instances/{instance}
users

integer

מספר המשתמשים הייחודיים שניגשים למכונה הווירטואלית.