assignLicense

为用户添加或删除订阅。还可以启用和禁用与订阅相关的特定计划。

先决条件

若要执行此 API,必须有以下范围之一:Directory.ReadWrite.All、Directory.AccessAsUser.All

HTTP 请求

POST /users/{id | userPrincipalName}/assignLicense

请求标头

标头
Authorization Bearer {token}。必需。
Content-Type application/json

请求正文

在请求正文中,提供具有以下参数的 JSON 对象。

参数 类型 说明
addLicenses AssignedLicense 用于指定要添加的许可证的 assignedLicense 对象集合。可以通过设置 assignedLicense 对象中的 disabledPlans 属性禁用与许可证相关的计划。
removeLicenses Guid 标识要删除的许可证的 GUID 的集合。

响应

如果成功,此方法在响应正文中返回 200, OK 响应代码和 user 对象。

示例

下面是一个如何调用此 API 的示例。

请求

下面是一个请求示例。

POST https://graph.microsoft.com/v1.0/me/assignLicense
Content-type: application/json
Content-length: 185

{
  "addLicenses": [
    {
      "disabledPlans": [ "11b0131d-43c8-4bbb-b2c8-e80f9a50834a" ],
      "skuId": "skuId-value"
    }
  ],
  "removeLicenses": [ "bea13e0c-3828-4daa-a392-28af7ff61a0f" ]
}
响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 491

{
  "accountEnabled": true,
  "assignedLicenses": [
    {
      "disabledPlans": [ "11b0131d-43c8-4bbb-b2c8-e80f9a50834a" ],
      "skuId": "skuId-value"
    }
  ],
  "assignedPlans": [
    {
      "assignedDateTime": "datetime-value",
      "capabilityStatus": "capabilityStatus-value",
      "service": "service-value",
      "servicePlanId": "bea13e0c-3828-4daa-a392-28af7ff61a0f"
    }
  ],
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value",
  "companyName": "companyName-value"
}