Обновление advancedThreatProtectionOnboardingDeviceSettingState

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

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/advancedThreatProtectionOnboardingStateSummary/advancedThreatProtectionOnboardingDeviceSettingStates/{advancedThreatProtectionOnboardingDeviceSettingStateId}

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

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

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

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

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

Свойство	Тип	Описание
id	String	Ключ объекта
platformType	deviceType	Тип платформы устройства. Возможные значения: desktop, windowsRT, , winMO6, nokia, macwindowsPhone, winCE, winEmbedded, iPhone, iPadmacMDMholoLensiSocConsumerunixandroidForWorkandroidiPodandroidEnterprisesurfaceHubwindows10x, androidnGMS, chromeOS, linux, , blackberry, palm, . cloudPCunknown
setting	String	Имя класса параметров и свойства.
settingName	String	Имя параметра в отчете
deviceId	String	ИД устройства в отчете
deviceName	String	Имя устройства в отчете
userId	String	ИД пользователя в отчете
userEmail	String	Электронный адрес пользователя в отчете
userName	String	Имя пользователя в отчете
userPrincipalName	String	Имя участника-пользователя в отчете
deviceModel	String	Модель устройства в отчете
state	complianceStatus	Состояние соответствия параметра. Возможные значения: unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict, notAssigned.
complianceGracePeriodExpirationDateTime	DateTimeOffset	Дата и время, когда истекает период отсрочки применения политик на устройстве.

Отклик

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

Пример

Запрос

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

PATCH https://graph.microsoft.com/beta/deviceManagement/advancedThreatProtectionOnboardingStateSummary/advancedThreatProtectionOnboardingDeviceSettingStates/{advancedThreatProtectionOnboardingDeviceSettingStateId}
Content-type: application/json
Content-length: 573

{
  "@odata.type": "#microsoft.graph.advancedThreatProtectionOnboardingDeviceSettingState",
  "platformType": "windowsRT",
  "setting": "Setting value",
  "settingName": "Setting Name value",
  "deviceId": "Device Id value",
  "deviceName": "Device Name value",
  "userId": "User Id value",
  "userEmail": "User Email value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "deviceModel": "Device Model value",
  "state": "notApplicable",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00"
}

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.advancedThreatProtectionOnboardingDeviceSettingState",
  "id": "63593fc6-3fc6-6359-c63f-5963c63f5963",
  "platformType": "windowsRT",
  "setting": "Setting value",
  "settingName": "Setting Name value",
  "deviceId": "Device Id value",
  "deviceName": "Device Name value",
  "userId": "User Id value",
  "userEmail": "User Email value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "deviceModel": "Device Model value",
  "state": "notApplicable",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00"
}