Listar entradas
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.
Obter uma lista de recursos catalogEntry do catálogo.
Atualmente, essa operação retorna entradas dos tipos featureUpdateCatalogEntry ou qualityUpdateCatalog , herdados de catalogEntry.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | WindowsUpdates.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | WindowsUpdates.ReadWrite.All | Indisponível. |
Para que um aplicativo leia ou escreva todas as configurações de implantação de atualização do Windows com permissões delegadas, o usuário conectado deve receber as funções administrador global, administrador Intune ou administrador de implantação Windows UpdateMicrosoft Entra.
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 do catalogEntry, inclua o tipo de recurso completo para a propriedade. Por exemplo, para filtrar na propriedade de versão do 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": "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"
}
]
}
}
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de