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)

必須。使用量の追跡は常に 1 か月単位で行われます。このパラメータは、月の終了時間を表します。

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 にアクセスしているユニーク ユーザーの数。