構成のインスタンスあたりの使用量を集計します。
HTTP リクエスト
GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:aggregateUsage
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
name |
必須。AggregateUsageRequest の親の値 |
クエリ パラメータ
パラメータ | |
---|---|
pageSize |
省略可。リクエストされたページサイズ。サーバーはリクエストされた数よりも少ない項目を返す場合があります。指定しない場合は、サーバーで適切なデフォルトが選択されます。 |
pageToken |
省略可。サーバーが返す必要がある結果のページを特定するトークン。 |
filter |
省略可。結果をフィルタする |
orderBy |
省略可。結果の並べ替え方法に関するヒント。 |
startTime |
必須。ライセンスは月単位で購入されるため、使用状況の追跡には月の開始時間が必要です。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
endTime |
必須。使用状況の追跡は常に 1 か月単位で行われます。このパラメータは、月の終了時刻を表します。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
使用量カウントの集計に対するレスポンスのメッセージ
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"usages": [
{
object ( |
フィールド | |
---|---|
usages[] |
構成ごとの使用状況の集計レコード |
nextPageToken |
サーバーが返す必要がある結果のページを特定するトークン。 |
unreachable[] |
到達できなかった場所。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
詳細については、Authentication Overview をご覧ください。
IAM 権限
name
リソースに対する次の IAM 権限が必要です。
licensemanager.configurations.aggregateUsage
詳細については、IAM のドキュメントをご覧ください。
用途
VM にアクセスしたユーザーの合計数を説明するメッセージ。
JSON 表現 |
---|
{ "limaInstance": string, "users": integer } |
フィールド | |
---|---|
limaInstance |
LiMa インスタンスのリソース名(projects/{project}/locations/{location}/instances/{instance}) |
users |
VM にアクセスしているユニーク ユーザーの数。 |