| title | allotment resource type |
|---|---|
| description | Represents an independently manageable pool of licenses supported by a subscription. |
| author | patrick-starrin |
| ms.date | 07/18/2025 |
| ms.localizationpriority | medium |
| ms.subservice | cloud-licensing |
| doc_type | resourcePageType |
Namespace: microsoft.graph.cloudLicensing
[!INCLUDE beta-disclaimer]
Represents an independently manageable pool of licenses supported by a subscription.
Inherits from entity.
| Method | Return type | Description |
|---|---|---|
| List | microsoft.graph.cloudLicensing.allotment collection | Get a list of the allotment objects and their properties. |
| Get | microsoft.graph.cloudLicensing.allotment | Read the properties and relationships of an allotment object. |
| List assignments for allotment | microsoft.graph.cloudLicensing.assignment collection | Get a list of license assignment objects within an organization. |
| Create assignment for allotment | microsoft.graph.cloudLicensing.assignment | Create a new license assignment by posting to the assignments collection of an organization. |
| List waiting members | microsoft.graph.cloudLicensing.waitingMember collection | Get a list of over-assigned users who are in the waiting room for this allotment due to license capacity limits. |
| Property | Type | Description |
|---|---|---|
| allottedUnits | Int32 | The number of licenses contained within the allotment. Not nullable. Read-only. |
| assignableTo | microsoft.graph.cloudLicensing.assigneeTypes | Identifies the types of directory objects to which the allotment can be assigned. The possible values are: none, user, group, device, unknownFutureValue. The assigneeTypes enum is multivalued and can contain multiple values in a comma‑separated list. Not nullable. Read-only. |
| consumedUnits | Int32 | The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only. |
| id | String | The unique identifier for the allotment that should be treated as an opaque identifier. Inherited from entity. Not nullable. Read-only. |
| services | microsoft.graph.cloudLicensing.service collection | The list of services that might be enabled or disabled for assignments from this allotment. Not nullable. Read-only. |
| 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. |
| subscriptions | microsoft.graph.cloudLicensing.subscription collection | Basic information about the subscriptions that supports this allotment. |
| Relationship | Type | Description |
|---|---|---|
| assignments | microsoft.graph.cloudLicensing.assignment collection | The list of license assignments that consume licenses from this allotment. Not nullable. |
| waitingMembers | microsoft.graph.cloudLicensing.waitingMember collection | List of over-assigned users who are in the waiting room for an allotment due to license capacity limits. |
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.cloudLicensing.allotment",
"allottedUnits": "Int32",
"assignableTo": "String",
"consumedUnits": "Int32",
"id": "String (identifier)",
"services": [{"@odata.type": "microsoft.graph.cloudLicensing.service"}],
"skuId": "Guid",
"skuPartNumber": "String",
"subscriptions": [{"@odata.type": "microsoft.graph.cloudLicensing.subscription"}]
}