Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph.cloudLicensing
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Создайте новое назначение лицензии, опубликовав его в коллекции назначенийпользователя.
Назначение всегда должно иметь прямую связь с выделением, а также с пользователем или группой. Если назначение создается путем публикации в коллекции назначений пользователя, расположенной по адресу /users/{userId}/cloudLicensing/assignments, отношение выделения должно быть установлено в тексте запроса. Назначения также можно создать путем публикации в коллекции заданий организации, в коллекции назначений выделения или в коллекции назначений группы.
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | User-CloudLicensing.AssignLicenses.Organization | User.ReadWrite.All, Directory.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | User-CloudLicensing.AssignLicenses.Organization | User.ReadWrite.All, Directory.ReadWrite.All |
HTTP-запрос
Чтобы создать назначение для пользователя, выполнившего вход, используя делегированные разрешения (/me), выполните следующие действия:
POST /me/cloudLicensing/assignments
Чтобы создать назначение для определенного пользователя с помощью делегированных разрешений или разрешений приложения, выполните следующие действия:
POST /users/{userId}/cloudLicensing/assignments
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите представление объекта назначения в формате JSON.
При создании назначения можно указать следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| disabledServicePlanIds | Коллекция объектов Guid | Список отключенных планов обслуживания для этого назначения. Пустой список указывает, что включены все службы. Обязательно. Значение null не допускается. |
При создании назначения можно указать следующие связи.
| Связь | Тип | Описание |
|---|---|---|
| Выделение | microsoft.graph.cloudLicensing.allotment | Выделение, из которого назначаются лицензии. Обязательно. Значение null не допускается. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект microsoft.graph.cloudLicensing.assignment в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/users/6d645c5f-089f-40d8-b0e7-136fb5c56d5b/cloudLicensing/assignments
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudLicensing.assignment",
"allotment@odata.bind": "https://graph.microsoft.com/beta/admin/cloudLicensing/allotments/rkocgef3dgjhnu3gmu2mqhbdbmwcymnf6fk3k6a7zbui5e7gfpmi",
"disabledServicePlanIds": [
"bed136c6-b799-4462-824d-fc045d3a9d25"
]
}
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudLicensing.assignment",
"disabledServicePlanIds": [
"bed136c6-b799-4462-824d-fc045d3a9d25"
]
}