Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph.windowsUpdates
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Obtenha uma lista de recursos catalogEntry do catálogo.
Atualmente, essa operação retorna entradas dos tipos featureUpdateCatalogEntry ou qualityUpdateCatalog , herdadas de catalogEntry.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | WindowsUpdates.Read.All | WindowsUpdates.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | WindowsUpdates.Read.All | WindowsUpdates.ReadWrite.All |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve ser proprietário ou membro do grupo ou ser atribuído a uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. O Administrador do Intune ou o Administrador de Implantação do Windows Update são as funções com menos privilégios com suporte para esta operação.
Solicitação HTTP
GET /admin/windows/updates/catalog/entries
Parâmetros de consulta opcionais
Esse método dá suporte a alguns dos parâmetros de consulta OData para ajudar a personalizar a resposta, incluindo $count, $filter, $orderby, $select, $skip, e $top.
Para usar um parâmetro de consulta em uma propriedade que não é herdada de catalogEntry, inclua o tipo de recurso completo da propriedade. Por exemplo, para filtrar a propriedade de versão de featureUpdateCatalogEntry que é igual a 'Windows 11, versão 22H2' , use ?$filter=microsoft.graph.windowsUpdates.featureUpdateCatalogEntry/version eq 'Windows 11, version 22H2'.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK código de resposta e uma coleção de objetos catalogEntry no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/admin/windows/updates/catalog/entries
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateCatalogEntry",
"id": "c1dec151-c151-c1de-51c1-dec151c1dec1",
"displayName": "Test security updates",
"releaseDateTime": "2023-07-11T00:00:00Z",
"deployableUntilDateTime": "2023-07-11T00:00:00Z",
"version": "v2"
},
{
"@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"
}
]
}
}
]
}