Method: projects.locations.configurations.queryLicenseUsage

נתוני שימוש ברישיון עבור הגדרה.

בקשת HTTP

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

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

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

פרמטרים
name

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 
{

  // Union field details can be only one of the following:
  "userCountUsage": {
    object (UserCountUsage)
  }
  // End of list of possible types for union field details.
}
שדות
שדה איחוד details. בהתאם לסוג ההגדרה, אחד מהערכים הבאים יאוכלס. הערך details יכול להיות רק אחד מהבאים:
userCountUsage

object (UserCountUsage)

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

היקפי הרשאות

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

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

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

הרשאות IAM

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

  • licensemanager.configurations.queryLicenseUsage

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

UserCountUsage

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

ייצוג ב-JSON 
{
  "uniqueUserCount": integer
}
שדות
uniqueUserCount

integer

חובה. מספר ייחודי של משתמשים בעלי רישיון.