構成のライセンス使用状況情報。
HTTP リクエスト
GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:queryLicenseUsage
この URL では gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
name |
必須。Configuration のリソースパス。 |
クエリ パラメータ
| パラメータ | |
|---|---|
startTime |
必須。使用状況の取得を開始する時刻。指定しない場合は、現在の請求期間の初日が使用されます。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
endTime |
必須。使用状況を取得する終了時刻。指定しない場合、現在の請求期間の最終日が使用されます。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
構成ごとのライセンス使用状況を取得するレスポンスのメッセージ。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ // Union field |
| Fields | |
|---|---|
共用体フィールド 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 |
必須。ライセンスが付与された固有のユーザーの数。 |