次の方法で共有

使用状況を取得するRight

名前空間: microsoft.graph.cloudLicensing

重要

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

ユーザーまたはグループの usageRight のプロパティとリレーションシップを取得します。

アクセス許可

次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。 ベスト プラクティスに従って、最小限の特権のアクセス許可を要求します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

ユーザーの usageRight を取得するためのアクセス許可:

GET /me/cloudLicensing/usageRights/{usageRightId}
GET /users/{userId}/cloudLicensing/usageRights/{usageRightId}
アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) User-UsageRight.Read User.Read、User.Read.All、User.ReadWrite、User.ReadWrite.All、Directory.Read.All、Directory.ReadWrite.All、User-CloudLicensing.Read.All、User-CloudLicensing.Read、User-UsageRight.Read.All、User-UsageRight.Read.Read
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション User-UsageRight.Read.All User.Read.All、User.ReadWrite.All、Directory.Read.All、Directory.ReadWrite.All、User-CloudLicensing.Read.All、User-UsageRight.Read.All

グループの usageRight を取得するためのアクセス許可:

GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}
アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Group-UsageRight.Read.All Directory.Read.All、Directory.ReadWrite.All、Group-CloudLicensing.Read、Group-CloudLicensing.Read.All、Group.Read.All、Group.ReadWrite.All、User.Read.All、User.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Group-UsageRight.Read.All Directory.Read.All、Directory.ReadWrite.All、Group-CloudLicensing.Read.All、Group.Read.All、Group.ReadWrite.All、User.Read.All、User.ReadWrite.All

HTTP 要求

委任された (/me) アクセス許可を使用して、サインインしているユーザーの使用権を取得するには:

GET /me/cloudLicensing/usageRights/{usageRightId}

委任されたアクセス許可またはアプリケーションのアクセス許可を使用して、特定のユーザーまたはグループの使用権を取得するには:

GET /users/{userId}/cloudLicensing/usageRights/{usageRightId}
GET /groups/{groupId}/cloudLicensing/usageRights/{usageRightId}

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

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

要求ヘッダー

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

要求本文

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

応答

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

例

例 1: ユーザーの usageRight を取得する

次の例は、ユーザーの使用状況を適切に取得する方法を示しています。

要求

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

GET https://graph.microsoft.com/beta/users/48fbdf70-9e09-40df-9dbe-17af483ab113/cloudLicensing/usageRights/i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3

応答

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

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

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

{
  "@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
  "id": "i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3",
  "skuId": "639dec6b-bb19-468b-871c-c5c441c4b0cb",
  "skuPartNumber": "Microsoft_365_Copilot",
  "services": [
    {
      "@odata.type": "microsoft.graph.cloudLicensing.service",
      "assignableTo": "user,group",
      "planId": "fe6c28b3-d468-44ea-bbd0-a10a5167435c",
      "planName": "COPILOT_STUDIO_IN_COPILOT_FOR_M365"
    }
  ]
}

例 2: グループの usageRight を取得する

次の例は、グループの使用状況を適切に取得する方法を示しています。

要求

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

GET https://graph.microsoft.com/beta/groups/1003985b-dfc1-4f42-97d4-65f70a335ca8/cloudLicensing/usageRights/j6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby4

応答

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

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

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

{
  "@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
  "id": "j6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby4",
  "skuId": "639dec6b-bb19-468b-871c-c5c441c4b0cb",
  "skuPartNumber": "Microsoft_365_Copilot",
  "services": [
    {
      "@odata.type": "microsoft.graph.cloudLicensing.service",
      "assignableTo": "user,group",
      "planId": "fe6c28b3-d468-44ea-bbd0-a10a5167435c",
      "planName": "COPILOT_STUDIO_IN_COPILOT_FOR_M365"
    }
  ]
}

例 3: ユーザーの割り当てを使用して usageRight を取得する

次の例は、ユーザーの使用状況と割り当てを取得する方法を示しています。

要求

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

GET https://graph.microsoft.com/beta/users/48fbdf70-9e09-40df-9dbe-17af483ab113/cloudLicensing/usageRights/i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3?$expand=assignments($select=id)

応答

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

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

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

{
  "@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
  "id": "i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3",
  "skuId": "639dec6b-bb19-468b-871c-c5c441c4b0cb",
  "skuPartNumber": "Microsoft_365_Copilot",
  "services": [
    {
      "@odata.type": "microsoft.graph.cloudLicensing.service",
      "assignableTo": "user,group",
      "planId": "fe6c28b3-d468-44ea-bbd0-a10a5167435c",
      "planName": "COPILOT_STUDIO_IN_COPILOT_FOR_M365"
    }
  ],
  "assignments": [
    {
      "@odata.type": "#microsoft.graph.cloudLicensing.assignment",
      "id": "405ee855-dd74-f695-8d7e-be35a6788fe8"
    }
  ]
}

例 4: ユーザーの割り当てを使用して usageRight を取得する

次の例は、ユーザーの使用権とその割り当てを取得する方法を示しています。

要求

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

GET https://graph.microsoft.com/beta/users/48fbdf70-9e09-40df-9dbe-17af483ab113/cloudLicensing/usageRights/i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3?$expand=allotments($select=id,allottedUnits,consumedUnits,subscriptions)

応答

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

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

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

{
  "@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
  "id": "i6sq63x2vd3esbkifv7m42xdaugc6lfpqf3ozgvdlvk3ttnamby3",
  "skuId": "639dec6b-bb19-468b-871c-c5c441c4b0cb",
  "skuPartNumber": "Microsoft_365_Copilot",
  "services": [
    {
      "@odata.type": "microsoft.graph.cloudLicensing.service",
      "assignableTo": "user,group",
      "planId": "fe6c28b3-d468-44ea-bbd0-a10a5167435c",
      "planName": "COPILOT_STUDIO_IN_COPILOT_FOR_M365"
    }
  ],
  "allotments": [
    {
      "@odata.type": "#microsoft.graph.cloudLicensing.allotment",
      "id": "405ee855-dd74-f695-8d7e-be35a6788fe8",
      "allottedUnits": 100,
      "consumedUnits": 50,
      "subscriptions": [
        {
          "@odata.type": "#microsoft.graph.cloudLicensing.subscription",
          "subscriptionId": "f196adf8-75fa-8e4f-c61d-42d8114de4f4",
          "nextLifecycleDate": "2025-09-30T00:00:00.000Z",
          "startDate": "2025-07-18T00:00:00.000Z",
          "state": "active",
          "tags": "none"
        }
      ]
    }
  ]
}
  • Last updated on