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

List updatePolicy

  • Статья

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Получение списка объектов updatePolicy и их свойств.

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

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

Разрешения

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

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

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшего пользователя должен быть владельцем или членом группы либо ему должна быть назначена поддерживаемая роль Microsoft Entra или пользовательская роль с разрешением поддерживаемой роли. Intune администратор или администратор развертывания клиентский компонент Центра обновления Windows являются наименее привилегированными ролями, поддерживаемыми для этой операции.

HTTP-запрос

GET /admin/windows/updates/updatePolicies

Необязательные параметры запросов

Этот метод поддерживает некоторые параметры запросов OData для настройки отклика. Общие сведения см. в статье Параметры запроса OData.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

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

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов microsoft.graph.windowsUpdates.updatePolicy в тексте ответа.

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/admin/windows/updates/updatePolicies

Отклик

Ниже показан пример отклика.

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.updatePolicy",
      "id": "a7aa99c1-34a2-850c-5223-7816fde70713",
      "audience": {
        "@odata.id": "deploymentAudiences/1"
      },
      "complianceChanges": [
        {
          "@odata.type": "#microsoft.graph.windowsUpdates.contentApproval"
        }
      ],
      "complianceChangeRules": [
        {
          "@odata.type": "#microsoft.graph.windowsUpdates.contentApprovalRule",
          "contentFilter": {
              "@odata.type": "#microsoft.graph.windowsUpdates.driverUpdateFilter"
          },
          "durationBeforeDeploymentStart": "P7D",
          "createdDateTime": "2020-06-09T10:00:00Z",
          "lastEvaluatedDateTime": "2020-06-09T10:00:00Z",
          "lastModifiedDateTime": "2020-06-09T10:00:00Z"
        }
      ],
      "deploymentSettings": {
        "@odata.type": "microsoft.graph.windowsUpdates.deploymentSettings",
        "schedule": {
          "gradualRollout": {
            "@odata.type": "#microsoft.graph.windowsUpdates.rateDrivenRolloutSettings",
            "durationBetweenOffers": "P1D",
            "devicePerOffer": 1000
          }
        }
      }
    }
  ]
}