cloudPcReports: getSharedUseLicenseUsageReport (非推奨)
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
ServicePlanId、licenseCount、claimedLicenseCount などの共有使用ライセンスに関する使用状況レポートを、リアルタイム、7 日間、または 28 日間の傾向で取得します。
注意
この API は非推奨であり、2024 年 4 月 24 日にデータの返しを停止します。 今後は、 getFrontlineReport API を 使用します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | CloudPC.Read.All | CloudPC.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | CloudPC.Read.All | CloudPC.ReadWrite.All |
HTTP 要求
POST /deviceManagement/virtualEndpoint/reports/getSharedUseLicenseUsageReport
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/json. 必須です。 |
要求本文
要求本文で、パラメーターの JSON 表現を指定します。
次の表に、このアクションで使用できるパラメーターを示します。
| パラメーター | 型 | 説明 |
|---|---|---|
| reportName | String | レポート名を指定します。 |
| filter | String | OData フィルター構文。 サポートされているフィルターには、 and、 or、 lt、 le、 gt、 ge、 eqが含まれます。 |
| select | String collection | OData 選択構文。 レポートの選択した列を表します。 |
| search | String | 検索する文字列を指定します。 |
| groupBy | String collection | レポートをグループ化する方法を指定します。 を使用する場合は、 select パラメーターと同じコンテンツが必要です。 |
| orderBy | String collection | レポートを並べ替える方法を指定します。 |
| skip | Int32 | スキップするレコードの数。 |
| top | Int32 | 返す上位レコードの数。 |
応答
成功した場合、このアクションは200 OK応答コードと応答本文にStreamを返します。
例
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getSharedUseLicenseUsageReport
Content-Type: application/json
Content-length: 199
{
"reportName": "SharedUseLicenseUsageReport",
"filter": "ServicePlanId eq '2d1d344e-d10c-41bb-953b-b3a47521dca0' and DateTimeUTC gt datetime'2022-11-30'",
"select":["ServicePlanId", "LicenseCount", "ClaimedLicenseCount", "DateTimeUTC"],
"skip": 0,
"top": 100
}
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/octet-stream
{
"TotalRowCount": 2,
"Schema": [
{
"name": "ServicePlanId",
"type": "String"
},
{
"name": "LicenseCount",
"type": "Int32"
},
{
"name": "ClaimedLicenseCount",
"type": "Int32"
},
{
"name": "DateTimeUTC",
"type": "DateTime"
}
],
"Values": [
[
"2d1d344e-d10c-41bb-953b-b3a47521dca0", 100, 10, "2022-12-02T00:00:00"
],
[
"2d1d344e-d10c-41bb-953b-b3a47521dca0", 100, 11, "2022-12-01T00:00:00"
]
]
}