assignLicenseassignLicense

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Hinzufügen oder Entfernen von Lizenzen für den Benutzer, um die Verwendung von Microsoft-Cloud-angeboten zu aktivieren oder zu deaktivieren.Add or remove licenses for the user to enable or disable their use of Microsoft cloud offerings. Beispielsweise kann eine Organisation über ein Office 365 Enterprise E3-Abonnement mit 100 Lizenzen verfügen, und diese Anforderung weist einem bestimmten Benutzer eine dieser Lizenzen zu.For example, an organization can have an Office 365 Enterprise E3 subscription with 100 licenses, and this request assigns one of those licenses to a specific user. Sie können auch bestimmte Pläne aktivieren oder deaktivieren, die mit einem Abonnement verknüpft sind.You can also enable and disable specific plans associated with a subscription. Weitere Informationen zu Abonnements und Lizenzen finden Sie in diesem TechNet-Artikel.To learn more about subscriptions and licenses, see this Technet article.

Um die im Verzeichnis verfügbaren Abonnements abzurufen, führen Sie eine Get subscribedSkus-Anforderungaus.To get the subscriptions available in the directory, perform a GET subscribedSkus request.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) User.ReadWrite.All, Directory.ReadWrite.AllUser.ReadWrite.All, Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication User.ReadWrite.All, Directory.ReadWrite.AllUser.ReadWrite.All, Directory.ReadWrite.All

HTTP-AnforderungHTTP request

POST /users/{id | userPrincipalName}/assignLicense

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

ParameterParameter TypType BeschreibungDescription
addLicensesaddLicenses assignedLicense-SammlungassignedLicense collection Eine Sammlung von assignedLicense-Objekten, die die hinzuzufügenden Lizenzen angeben.A collection of assignedLicense objects that specify the licenses to add. Sie können servicePlans, die einer Lizenz zugeordnet sind, deaktivieren, indem Sie die disabledPlans -Eigenschaft für ein assignedLicense -Objekt festlegen.You can disable servicePlans associated with a license by setting the disabledPlans property on an assignedLicense object.
removeLicensesremoveLicenses GUID-SammlungGuid collection Eine Auflistung von skuIds, die die zu entfernenden Lizenzen identifizieren.A collection of skuIds that identify the licenses to remove.

AntwortResponse

Wenn die Methode erfolgreich verläuft 200 OK , werden der Antwortcode und ein aktualisiertes User -Objekt im Antworttext zurückgegeben.If successful, this method returns 200 OK response code and an updated user object in the response body.

BeispielExample

Fügen Sie dem Benutzerlizenzen hinzu.Add licenses to the user.

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

{
  "addLicenses": [
    {
      "disabledPlans": [ "11b0131d-43c8-4bbb-b2c8-e80f9a50834a" ],
      "skuId": "skuId-value-1"
    },
    {
      "disabledPlans": [ "a571ebcc-fqe0-4ca2-8c8c-7a284fd6c235" ],
      "skuId": "skuId-value-2"
    }
  ],
  "removeLicenses": []
}

BeispielExample

Entfernen Sie die Lizenzen des Benutzers.Remove licenses from the user.

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

{
  "addLicenses": [],
  "removeLicenses": ["skuId-value-1", "skuId-value-2"]
}
AntwortResponse

In beiden Beispielen ist die Antwort das aktualisierte Benutzerobjekt.In both examples, the response is the updated user object. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.All of the properties will be returned from an actual call.

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": "2016-10-19T10:37:00Z",
      "capabilityStatus": "capabilityStatus-value",
      "service": "service-value",
      "servicePlanId": "bea13e0c-3828-4daa-a392-28af7ff61a0f"
    }
  ],
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value",
  "companyName": "companyName-value"
}