配置的许可使用情况信息。
HTTP 请求
GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:queryLicenseUsage
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
必需。配置的资源路径。 |
查询参数
参数 | |
---|---|
startTime |
必需。用于检索使用情况的开始时间。如果未指定,我们将使用当前结算周期的第一天。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
endTime |
必需。检索用量的结束时间。如果未指定,我们将使用当前结算周期的最后一天。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
请求正文
请求正文必须为空。
响应正文
用于响应的消息,用于获取每个配置的许可使用情况。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 details 。根据配置的类型,系统会填充以下其中一项。details 只能是下列其中一项: |
|
userCountUsage |
使用按用户数结算的许可类型的用量信息。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅 Authentication Overview。
IAM 权限
需要拥有 name
资源的以下 IAM 权限:
licensemanager.configurations.queryLicenseUsage
如需了解详情,请参阅 IAM 文档。
UserCountUsage
表示使用用户数结算的许可配置的使用情况的消息。
JSON 表示法 |
---|
{ "uniqueUserCount": integer } |
字段 | |
---|---|
uniqueUserCount |
必需。许可用户的唯一身份用户数。 |