Update softwareUpdateStatusSummary

Статья
08/01/2024

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

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

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

Разрешения

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

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

HTTP-запрос

PATCH /deviceManagement/softwareUpdateStatusSummary

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

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

Тело запроса

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

Ниже показаны свойства, которые необходимо указывать при создании объекта softwareUpdateStatusSummary.

Свойство	Тип	Описание
id	String	Ключ объекта.
displayName	String	Имя политики.
compliantDeviceCount	Int32	Количество устройств, соответствующих требованиям.
nonCompliantDeviceCount	Int32	Количество устройств, не соответствующих требованиям.
remediatedDeviceCount	Int32	Количество исправленных устройств.
errorDeviceCount	Int32	Количество устройств с ошибками.
unknownDeviceCount	Int32	Количество неизвестных устройств
conflictDeviceCount	Int32	Количество конфликтующих устройств.
notApplicableDeviceCount	Int32	Количество неприменимых устройств.
compliantUserCount	Int32	Количество пользователей, соответствующих требованиям.
nonCompliantUserCount	Int32	Количество пользователей, не соответствующих требованиям.
remediatedUserCount	Int32	Количество исправленных пользователей.
errorUserCount	Int32	Количество пользователей с ошибками.
unknownUserCount	Int32	Количество неизвестных пользователей.
conflictUserCount	Int32	Количество конфликтующих пользователей.
notApplicableUserCount	Int32	Количество неприменимых пользователей.

Ответ

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

Пример

Запрос

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

HTTP
JavaScript

PATCH https://graph.microsoft.com/v1.0/deviceManagement/softwareUpdateStatusSummary
Content-type: application/json
Content-length: 518

{
  "@odata.type": "#microsoft.graph.softwareUpdateStatusSummary",
  "displayName": "Display Name value",
  "compliantDeviceCount": 4,
  "nonCompliantDeviceCount": 7,
  "remediatedDeviceCount": 5,
  "errorDeviceCount": 0,
  "unknownDeviceCount": 2,
  "conflictDeviceCount": 3,
  "notApplicableDeviceCount": 8,
  "compliantUserCount": 2,
  "nonCompliantUserCount": 5,
  "remediatedUserCount": 3,
  "errorUserCount": 14,
  "unknownUserCount": 0,
  "conflictUserCount": 1,
  "notApplicableUserCount": 6
}


const options = {
	authProvider,
};

const client = Client.init(options);

const softwareUpdateStatusSummary = {
  '@odata.type': '#microsoft.graph.softwareUpdateStatusSummary',
  displayName: 'Display Name value',
  compliantDeviceCount: 4,
  nonCompliantDeviceCount: 7,
  remediatedDeviceCount: 5,
  errorDeviceCount: 0,
  unknownDeviceCount: 2,
  conflictDeviceCount: 3,
  notApplicableDeviceCount: 8,
  compliantUserCount: 2,
  nonCompliantUserCount: 5,
  remediatedUserCount: 3,
  errorUserCount: 14,
  unknownUserCount: 0,
  conflictUserCount: 1,
  notApplicableUserCount: 6
};

await client.api('/deviceManagement/softwareUpdateStatusSummary')
	.update(softwareUpdateStatusSummary);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

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

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

{
  "@odata.type": "#microsoft.graph.softwareUpdateStatusSummary",
  "id": "4f71421f-421f-4f71-1f42-714f1f42714f",
  "displayName": "Display Name value",
  "compliantDeviceCount": 4,
  "nonCompliantDeviceCount": 7,
  "remediatedDeviceCount": 5,
  "errorDeviceCount": 0,
  "unknownDeviceCount": 2,
  "conflictDeviceCount": 3,
  "notApplicableDeviceCount": 8,
  "compliantUserCount": 2,
  "nonCompliantUserCount": 5,
  "remediatedUserCount": 3,
  "errorUserCount": 14,
  "unknownUserCount": 0,
  "conflictUserCount": 1,
  "notApplicableUserCount": 6
}

Поделиться через