Agregue o quite licencias para que el usuario habilite o deshabilite el uso de ofertas en la nube de Microsoft a las que la empresa tiene licencias. Por ejemplo, una organización puede tener una suscripción Microsoft 365 Enterprise E3 con 100 licencias y esta solicitud asigna una de esas licencias a un usuario específico. También puede habilitar y deshabilitar planes específicos asociados a una suscripción. El método de licencias de usuario directo es una alternativa a las licencias basadas en grupos.
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso
Permisos con privilegios mínimos
Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)
LicenseAssignment.ReadWrite.All
Directory.ReadWrite.All, User.ReadWrite.All
Delegado (cuenta personal de Microsoft)
No admitida.
No admitida.
Aplicación
LicenseAssignment.ReadWrite.All
Directory.ReadWrite.All, User.ReadWrite.All
Para escenarios delegados, el usuario que realiza la llamada necesita al menos uno de los siguientes roles de Microsoft Entra.
Escritores de directorios
Administrador de licencias
Administrador de usuarios
Solicitud HTTP
POST /users/{id | userPrincipalName}/assignLicense
Colección de objetos assignedLicense que especifican las licencias que se van a agregar. Puede deshabilitar servicePlans asociado a una licencia estableciendo la propiedad disabledPlans en un objeto assignedLicense .
removeLicenses
Colección Guid
Colección de skuIds que identifican las licencias que se van a quitar. Obligatorio.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el objeto user en el cuerpo de la respuesta.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Me.AssignLicense;
using Microsoft.Graph.Models;
var requestBody = new AssignLicensePostRequestBody
{
AddLicenses = new List<AssignedLicense>
{
new AssignedLicense
{
DisabledPlans = new List<Guid?>
{
Guid.Parse("11b0131d-43c8-4bbb-b2c8-e80f9a50834a"),
},
SkuId = Guid.Parse("45715bb8-13f9-4bf6-927f-ef96c102d394"),
},
},
RemoveLicenses = new List<Guid?>
{
Guid.Parse("bea13e0c-3828-4daa-a392-28af7ff61a0f"),
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.AssignLicense.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.users.item.assignlicense.AssignLicensePostRequestBody assignLicensePostRequestBody = new com.microsoft.graph.users.item.assignlicense.AssignLicensePostRequestBody();
LinkedList<AssignedLicense> addLicenses = new LinkedList<AssignedLicense>();
AssignedLicense assignedLicense = new AssignedLicense();
LinkedList<UUID> disabledPlans = new LinkedList<UUID>();
disabledPlans.add(UUID.fromString("11b0131d-43c8-4bbb-b2c8-e80f9a50834a"));
assignedLicense.setDisabledPlans(disabledPlans);
assignedLicense.setSkuId(UUID.fromString("45715bb8-13f9-4bf6-927f-ef96c102d394"));
addLicenses.add(assignedLicense);
assignLicensePostRequestBody.setAddLicenses(addLicenses);
LinkedList<UUID> removeLicenses = new LinkedList<UUID>();
removeLicenses.add(UUID.fromString("bea13e0c-3828-4daa-a392-28af7ff61a0f"));
assignLicensePostRequestBody.setRemoveLicenses(removeLicenses);
var result = graphClient.me().assignLicense().post(assignLicensePostRequestBody);
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.users.item.assign_license.assign_license_post_request_body import AssignLicensePostRequestBody
from msgraph.generated.models.assigned_license import AssignedLicense
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AssignLicensePostRequestBody(
add_licenses = [
AssignedLicense(
disabled_plans = [
UUID("11b0131d-43c8-4bbb-b2c8-e80f9a50834a"),
],
sku_id = UUID("45715bb8-13f9-4bf6-927f-ef96c102d394"),
),
],
remove_licenses = [
UUID("bea13e0c-3828-4daa-a392-28af7ff61a0f"),
],
)
result = await graph_client.me.assign_license.post(request_body)