Method: projects.locations.configurations.aggregateUsage

匯總設定的每個執行個體用量。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
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 權限

需要 name 資源的下列 IAM 權限：

  • licensemanager.configurations.aggregateUsage

詳情請參閱 IAM 說明文件。

用量

訊息：說明存取 VM 的使用者總數。

JSON 表示法 
{
  "limaInstance": string,
  "users": integer
}
欄位
limaInstance

string

LiMa 執行個體資源名稱，即 projects/{project}/locations/{location}/instances/{instance}
users

integer

存取 VM 的不重複使用者人數。