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 文档。

用量

用于描述访问过虚拟机的用户总数的消息。

JSON 表示法 
{
  "limaInstance": string,
  "users": integer
}
字段
limaInstance

string

LiMa 实例资源名称，即 projects/{project}/locations/{location}/instances/{instance}
users

integer

访问虚拟机的唯一身份用户数。