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