| title | usageRight resource type |
|---|---|
| description | Represents the right of a user or group to use a particular set of services, as granted by the combination of their assigned licenses for the same subscribedSku. |
| author | patrick-starrin |
| ms.localizationpriority | medium |
| ms.subservice | cloud-licensing |
| doc_type | resourcePageType |
| ms.date | 10/17/2024 |
Namespace: microsoft.graph.cloudLicensing
[!INCLUDE beta-disclaimer]
Represents the right of a user or group to use a particular set of services, as granted by the combination of their assigned licenses for the same subscribedSku.
Inherits from entity.
| Method | Return type | Description |
|---|---|---|
| List for group | microsoft.graph.cloudLicensing.usageRight collection | Get a list of the usageRight objects granted to a group. |
| List for user | microsoft.graph.cloudLicensing.usageRight collection | Get a list of the usageRight objects granted to a user. |
| Get | microsoft.graph.cloudLicensing.usageRight | Get the properties and relationships of a usageRight for a user or group. |
| List assignments | microsoft.graph.cloudLicensing.assignment collection | Get a list of the assignment objects which combine to form this usageRight. |
| Property | Type | Description |
|---|---|---|
| id | String | The unique identifier for the usageRight that should be treated as an opaque identifier. Inherited from entity. Not nullable. Read-only. |
| services | microsoft.graph.cloudLicensing.service collection | Information about the services associated with the usageRight. Not nullable. Read-only. Supports $filter on the planId property. |
| skuId | Guid | Unique identifier (GUID) for the service SKU that is equal to the skuId property on the related subscribedSku object. Read-only. Supports $filter. |
| skuPartNumber | String | Unique SKU display name that is equal to the skuPartNumber on the related subscribedSku object; for example, AAD_Premium. Read-only. |
| Relationship | Type | Description |
|---|---|---|
| allotments | microsoft.graph.cloudLicensing.allotment collection | The set of allotments associated with the assignments that combine to form this usageRight. |
| assignments | microsoft.graph.cloudLicensing.assignment collection | The set of assignments that combine to form this usageRight, including both direct assignments and assignments inherited through group membership. |
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.cloudLicensing.usageRight",
"id": "String (identifier)",
"services": [{"@odata.type": "microsoft.graph.cloudLicensing.service"}],
"skuId": "Guid",
"skuPartNumber": "String"
}