Обновление deviceManagementAutopilotEvent

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

Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.

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

Обновление свойств объекта deviceManagementAutopilotEvent .

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}

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

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

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

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

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

Свойство	Тип	Описание
id	String	UUID объекта.
deviceId	String	Идентификатор устройства, связанный с объектом
userId	String	Идентификатор UserId, связанный с объектом
eventDateTime	DateTimeOffset	Время возникновения события.
deviceRegisteredDateTime	DateTimeOffset	Дата регистрации устройства.
enrollmentStartDateTime	DateTimeOffset	Дата начала регистрации устройств.
enrollmentType	windowsAutopilotEnrollmentType	Тип регистрации. Возможные значения: unknown, azureADJoinedWithAutopilotProfile, offlineDomainJoined, azureADJoinedUsingDeviceAuthWithAutopilotProfile, azureADJoinedUsingDeviceAuthWithoutAutopilotProfile, azureADJoinedWithOfflineAutopilotProfile, azureADJoinedWithWhiteGlove, offlineDomainJoinedWithWhiteGlove, offlineDomainJoinedWithOfflineAutopilotProfile.
deviceSerialNumber	String	Серийный номер устройства.
managedDeviceName	String	Имя управляемого устройства.
userPrincipalName	String	Имя субъекта-пользователя, используемое для регистрации устройства.
windowsAutopilotDeploymentProfileDisplayName	String	Имя профиля Autopilot.
enrollmentState	enrollmentState	Состояние регистрации, например Зарегистрировано, Сбой. Возможные значения: unknown, enrolled, pendingReset, failed, notContacted, blocked.
windows10EnrollmentCompletionPageConfigurationDisplayName	String	Имя профиля страницы состояния регистрации
windows10EnrollmentCompletionPageConfigurationId	String	Идентификатор профиля страницы состояния регистрации
deploymentState	windowsAutopilotDeploymentState	Состояние развертывания, например Успешно, Сбой, InProgress, SuccessWithTimeout. Возможные значения: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled, successOnRetry.
deviceSetupStatus	windowsAutopilotDeploymentState	Состояние развертывания для этапа настройки устройства страницы состояния регистрации. Возможные значения: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled, successOnRetry.
accountSetupStatus	windowsAutopilotDeploymentState	Состояние развертывания для этапа настройки учетной записи страницы состояния регистрации. Возможные значения: unknown, success, inProgress, failure, successWithTimeout, notAttempted, disabled, successOnRetry.
osVersion	String	Версия операционной системы устройства.
deploymentDuration	Duration (Длительность)	Длительность развертывания Autopilot, включая регистрацию.
deploymentTotalDuration	Duration (Длительность)	Общая длительность развертывания от регистрации до экрана рабочего стола.
deviceSetupDuration	Duration (Длительность)	Время, затраченное на esp устройства.
accountSetupDuration	Duration (Длительность)	Время, затраченное на пользователя ESP.
deploymentStartDateTime	DateTimeOffset	Время начала развертывания.
deploymentEndDateTime	DateTimeOffset	Время окончания развертывания.
enrollmentFailureDetails	String	Сведения о сбое регистрации.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект deviceManagementAutopilotEvent в теле отклика.

Пример

Запрос

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

PATCH https://graph.microsoft.com/beta/deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}
Content-type: application/json
Content-length: 1468

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "deviceId": "Device Id value",
  "userId": "User Id value",
  "eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
  "deviceRegisteredDateTime": "2017-01-01T00:02:48.7185581-08:00",
  "enrollmentStartDateTime": "2017-01-01T00:00:19.6280481-08:00",
  "enrollmentType": "azureADJoinedWithAutopilotProfile",
  "deviceSerialNumber": "Device Serial Number value",
  "managedDeviceName": "Managed Device Name value",
  "userPrincipalName": "User Principal Name value",
  "windowsAutopilotDeploymentProfileDisplayName": "Windows Autopilot Deployment Profile Display Name value",
  "enrollmentState": "enrolled",
  "windows10EnrollmentCompletionPageConfigurationDisplayName": "Windows10Enrollment Completion Page Configuration Display Name value",
  "windows10EnrollmentCompletionPageConfigurationId": "Windows10Enrollment Completion Page Configuration Id value",
  "deploymentState": "success",
  "deviceSetupStatus": "success",
  "accountSetupStatus": "success",
  "osVersion": "Os Version value",
  "deploymentDuration": "PT3M21.5549443S",
  "deploymentTotalDuration": "PT1M43.5284261S",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "enrollmentFailureDetails": "Enrollment Failure Details value"
}

Отклик

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

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1517

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "id": "3e455cab-5cab-3e45-ab5c-453eab5c453e",
  "deviceId": "Device Id value",
  "userId": "User Id value",
  "eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
  "deviceRegisteredDateTime": "2017-01-01T00:02:48.7185581-08:00",
  "enrollmentStartDateTime": "2017-01-01T00:00:19.6280481-08:00",
  "enrollmentType": "azureADJoinedWithAutopilotProfile",
  "deviceSerialNumber": "Device Serial Number value",
  "managedDeviceName": "Managed Device Name value",
  "userPrincipalName": "User Principal Name value",
  "windowsAutopilotDeploymentProfileDisplayName": "Windows Autopilot Deployment Profile Display Name value",
  "enrollmentState": "enrolled",
  "windows10EnrollmentCompletionPageConfigurationDisplayName": "Windows10Enrollment Completion Page Configuration Display Name value",
  "windows10EnrollmentCompletionPageConfigurationId": "Windows10Enrollment Completion Page Configuration Id value",
  "deploymentState": "success",
  "deviceSetupStatus": "success",
  "accountSetupStatus": "success",
  "osVersion": "Os Version value",
  "deploymentDuration": "PT3M21.5549443S",
  "deploymentTotalDuration": "PT1M43.5284261S",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "enrollmentFailureDetails": "Enrollment Failure Details value"
}