Создание deviceManagementIntEntDeviceState

Пространство имен: microsoft.graph

Важно: Корпорация Майкрософт поддерживает api Intune /beta, но они могут часто изменяться. Корпорация Майкрософт рекомендует по возможности использовать версию 1.0. Проверьте доступность API в версии 1.0 с помощью селектора версий.

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Создайте объект deviceManagementIntentDeviceState .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) DeviceManagementConfiguration.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение DeviceManagementConfiguration.ReadWrite.All

HTTP-запрос

POST /deviceManagement/intents/{deviceManagementIntentId}/deviceStates

Заголовки запроса

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept application/json

Текст запроса

В тексте запроса укажите представление объекта deviceManagementIntentDeviceState в формате JSON.

В следующей таблице показаны свойства, необходимые при создании deviceManagementIntentDeviceState.

Свойство Тип Описание
id String Идентификатор
userPrincipalName String Имя субъекта-пользователя, которое передается на устройстве
userName String Имя пользователя, которое передается на устройстве
deviceDisplayName String Сообщаемое имя устройства
lastReportedDateTime DateTimeOffset Время последнего изменения даты для отчета о намерениях
state complianceStatus Состояние устройства для намерения. Возможные значения: unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict, notAssigned.
deviceId String Сообщаемый идентификатор устройства

Отклик

В случае успешного 201 Created выполнения этот метод возвращает код отклика и объект deviceManagementIntentDeviceState в теле отклика.

Пример

Запрос

Ниже приведен пример запроса.

POST https://graph.microsoft.com/beta/deviceManagement/intents/{deviceManagementIntentId}/deviceStates
Content-type: application/json
Content-length: 342

{
  "@odata.type": "#microsoft.graph.deviceManagementIntentDeviceState",
  "userPrincipalName": "User Principal Name value",
  "userName": "User Name value",
  "deviceDisplayName": "Device Display Name value",
  "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
  "state": "notApplicable",
  "deviceId": "Device Id value"
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 391

{
  "@odata.type": "#microsoft.graph.deviceManagementIntentDeviceState",
  "id": "8db75881-5881-8db7-8158-b78d8158b78d",
  "userPrincipalName": "User Principal Name value",
  "userName": "User Name value",
  "deviceDisplayName": "Device Display Name value",
  "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
  "state": "notApplicable",
  "deviceId": "Device Id value"
}
  • Last updated on