Edit

Share via


assignment resource type

Namespace: microsoft.graph.cloudLicensing

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a license assignment that grants a license for the product-SKU contained within an allotment directly to the assigned user or indirectly to each member of the assigned group. Each unique user consumes one license from each allotment to which they're directly or indirectly assigned.

Inherits from entity.

Methods

Method Return type Description
List microsoft.graph.cloudLicensing.assignment collection Get a list of license assignment objects within an organization.
Create microsoft.graph.cloudLicensing.assignment Create a new license assignment by posting to the assignments collection of an organization.
Get microsoft.graph.cloudLicensing.assignment Read the properties and relationships of an assignment object.
Update microsoft.graph.cloudLicensing.assignment Update an assignment object to enable or disable services.
Delete None Delete an assignment object.
Create for allotment microsoft.graph.cloudLicensing.assignment Create a new license assignment by posting to the assignments collection of an allotment.
Create for user microsoft.graph.cloudLicensing.assignment Create a new license assignment by posting to a user's assignments collection.
Create for group microsoft.graph.cloudLicensing.assignment Create a new license assignment by posting to the assignments collection for a group.
Reprocess assignments None Reprocess existing license assignments for a user by calling the reprocessAssignments action on a user's assignments.
Get assignedTo directoryObject Get a user or group object for a given assignment to which licenses are assigned.
Get allotment for assignment microsoft.graph.cloudLicensing.allotment Get the allotment that is the source of the licenses used in the assignment.

Properties

Property Type Description
disabledServicePlanIds Guid collection The list of disabled service plans for this assignment. Not nullable.
id String The unique identifier for the assignment that should be treated as an opaque identifier. Inherited from entity. Not nullable.

Relationships

Relationship Type Description
allotment microsoft.graph.cloudLicensing.allotment The allotment from which licenses are assigned. Not nullable.
assignedTo directoryObject The user or group to which licenses are assigned. Not nullable.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.cloudLicensing.assignment",
  "disabledServicePlanIds": ["Guid"],
  "id": "String (identifier)"
}