Обновление пользователя
Пространство имен: microsoft.graph
Важно: API-интерфейсы в версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновление свойств объекта user.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке убывания привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | |
Управление устройствами | DeviceManagementManagedDevices.ReadWrite.All |
MAM | DeviceManagementApps.ReadWrite.All |
Адаптация | DeviceManagementServiceConfig.ReadWrite.All |
Устранение неполадок | DeviceManagementManagedDevices.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | |
Управление устройствами | DeviceManagementManagedDevices.ReadWrite.All |
MAM | DeviceManagementApps.ReadWrite.All |
Адаптация | DeviceManagementServiceConfig.ReadWrite.All |
Устранение неполадок | DeviceManagementManagedDevices.ReadWrite.All |
HTTP-запрос
PATCH /users/{usersId}
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Тело запроса
В теле запроса добавьте представление объекта user в формате JSON.
В приведенной ниже таблице указаны свойства, необходимые при создании объекта user.
Свойство | Тип | Описание |
---|---|---|
id | String | Уникальный идентификатор пользователя. |
Адаптация | ||
deviceEnrollmentLimit | Int32 | Максимальное количество устройств, которые разрешено зарегистрировать пользователю. Допустимые значения: 5 или 1000. |
Отклик
При успешном выполнении этот метод возвращает код отклика 200 OK
и обновленный объект user в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/beta/users/{usersId}
Content-type: application/json
Content-length: 2
{}
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 95
{
"@odata.type": "#microsoft.graph.user",
"id": "d36894ae-94ae-d368-ae94-68d3ae9468d3"
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по