Список записей
Пространство имен: microsoft.graph.windowsUpdates
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получите список catalogКорресунд ресурсов из каталога.
В настоящее время эта операция возвращает записи типов featureUpdateCatalogEntry или qualityUpdateCatalog , унаследованных от catalogEntry.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | WindowsUpdates.ReadWrite.All | Недоступно. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | WindowsUpdates.ReadWrite.All | Недоступно. |
В делегированных сценариях с рабочими или учебными учетными записями вошедшего пользователя должен быть владельцем или членом группы либо ему должна быть назначена поддерживаемая роль Microsoft Entra или пользовательская роль с разрешением поддерживаемой роли. Администратор Intune или администратор развертывания Центра обновления Windows — это наименее привилегированные роли, поддерживаемые для этой операции.
HTTP-запрос
GET /admin/windows/updates/catalog/entries
Необязательные параметры запросов
Этот метод поддерживает некоторые параметры запроса OData для настройки ответа, включая $count, , $filter$orderby, $select, $skip, и $top.
Чтобы использовать параметр запроса для свойства, которое не наследуется от catalogEntry, добавьте полный тип ресурса для свойства . Например, чтобы отфильтровать свойство versionобъекта featureUpdateCatalogEntry , равное "Windows 11, версия 22H2", используйте ?$filter=microsoft.graph.windowsUpdates.featureUpdateCatalogEntry/version eq 'Windows 11, version 22H2'.
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов catalogEntry в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/beta/admin/windows/updates/catalog/entries
Отклик
Ниже приводится пример отклика.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
"id": "c1dec151-c151-c1de-51c1-dec151c1dec1",
"displayName": "String",
"releaseDateTime": "String (timestamp)",
"deployableUntilDateTime": "String (timestamp)",
"version": "String"
},
{
"@odata.type": "#microsoft.graph.windowsUpdates.qualityUpdateCatalogEntry",
"id": "d0c03fbb-43b9-4dff-840b-974ef227384d",
"displayName": "07/11/2023 - 2023.07 B SecurityUpdate for Windows 10 and later",
"catalogName": "2023-07 Cumulative Update for Windows 10 and later",
"shortName": "2023.07 B",
"releaseDateTime": "2023-07-11T00:00:00Z",
"deployableUntilDateTime": null,
"isExpeditable": true,
"qualityUpdateClassification": "security",
"qualityUpdateCadence": "monthly",
"cveSeverityInformation": {
"maxSeverity": "critical",
"maxBaseScore": 9.8,
"exploitedCves": [
{
"number": "CVE-2023-32046",
"url": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2023-32046"
}
]
}
}
]
}