デバイスの usageRights を一覧表示する

名前空間: microsoft.graph.cloudLicensing

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

デバイスに付与された usageRight オブジェクトのリストを取得します。この API は、デバイスに直接割り当てられているライセンスと、ライセンスされたグループのメンバーシップを通じて推移的に割り当てられたライセンスに関する詳細を返します。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類	最小特権アクセス許可	より高い特権のアクセス許可
委任 (職場または学校のアカウント)	CloudLicensing-UsageRights.Read	CloudLicensing-UsageRights.ReadWrite
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	CloudLicensing-UsageRights.Read.All	CloudLicensing-UsageRights.ReadWrite.All

HTTP 要求

GET /devices/{deviceId}/cloudLicensing/usageRights

オプションのクエリパラメーター

このメソッドは、応答をカスタマイズするための $select、$top、$expand、$filter OData クエリパラメーターをサポートします。一般的な情報については、「OData クエリパラメーター」を参照してください。

次の例は、特定のフィルターに基づいてデバイスの使用権情報を取得する方法を示しています。

GET /devices/0231bf6c-f5ba-4133-80dd-b35d619bb4b5/cloudLicensing/usageRights?$filter=skuId eq a0cfb9b5-427c-4d42-9e6d-6727c6bbd8b5
GET /devices/0231bf6c-f5ba-4133-80dd-b35d619bb4b5/cloudLicensing/usageRights?$filter=skuId in (a0cfb9b5-427c-4d42-9e6d-6727c6bbd8b5, 639dec6b-bb19-468b-871c-c5c441c4b0cb)
GET /devices/0231bf6c-f5ba-4133-80dd-b35d619bb4b5/cloudLicensing/usageRights?$filter=services/any(c:c/planId eq b7786c33-f595-4df5-bed7-9a2c8622df78)
GET /devices/0231bf6c-f5ba-4133-80dd-b35d619bb4b5/cloudLicensing/usageRights?$filter=services/any(c:c/planId in (b7786c33-f595-4df5-bed7-9a2c8622df78, f446866a-4b4c-492e-907a-998b3fde5a81))

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須です。認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文の microsoft.graph.cloudLicensing.usageRight オブジェクトのコレクションを返します。

例

例 1: デバイスのすべての使用権を取得する

次の例は、デバイスに付与されたすべての使用権を取得する方法を示しています。

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/devices/0231bf6c-f5ba-4133-80dd-b35d619bb4b5/cloudLicensing/usageRights

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
      "id": "a8d33537-2833-4f1c-8797-7aa891e15723",
      "skuId": "a0cfb9b5-427c-4d42-9e6d-6727c6bbd8b5",
      "skuPartNumber": "FABRIKAM_DEVICE",
      "services": [
        {
          "@odata.type": "microsoft.graph.cloudLicensing.service",
          "assignableTo": "user,device,group",
          "planId": "b7786c33-f595-4df5-bed7-9a2c8622df78",
          "planName": "FABRIKAM_DESKTOP"
        },
        {
          "@odata.type": "microsoft.graph.cloudLicensing.service",
          "assignableTo": "user,device,group",
          "planId": "f446866a-4b4c-492e-907a-998b3fde5a81",
          "planName": "FABRIKAM_REMOTE"
        },
        {
          "@odata.type": "microsoft.graph.cloudLicensing.service",
          "assignableTo": "user,device,group",
          "planId": "f08373fb-2530-4f97-8aa4-f424f071780d",
          "planName": "FABRIKAM_TASKS"
        }
      ]
    }
  ]
}

例 2: 特定の SKU を持つデバイスのすべての使用権を取得する

次の例は、特定の SKU のデバイスに付与されたすべての使用権を取得する方法を示しています。

要求