Listar todas as atividades de correção

Artigo
05/03/2024

Aplica-se a:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita..

Quer experimentar Gerenciamento de Vulnerabilidades do Microsoft Defender? Saiba mais sobre como você pode se inscrever no Gerenciamento de Vulnerabilidades do Microsoft Defender avaliação de visualização pública.

Importante

Algumas informações neste artigo estão relacionadas ao produto pré-lançado que pode ser modificado substancialmente antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, com relação às informações aqui fornecidas.

Observação

Se você for um cliente do governo dos EUA, use as URIs listadas em Microsoft Defender para Ponto de Extremidade para clientes do governo dos EUA.

Dica

Para obter um melhor desempenho, você pode usar o servidor mais próximo da localização geográfica:

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com

Descrição da API

Retorna informações sobre todas as atividades de correção.

Saiba mais sobre as atividades de correção.

URL: GET: /api/remediationTasks
Dá suporte a consultas OData V4.
Operadores com suporte do OData:
$filter em: createdon e status propriedades.
$top com valor máximo de 10.000.
$skip.
Consulte exemplos em consultas OData com Microsoft Defender para Ponto de Extremidade.

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, consulte Usar APIs Microsoft Defender para Ponto de Extremidade para obter detalhes.

Tipo de permissão	Permissão	Nome da exibição de permissão
Application	RemediationTasks.Read.All	'Ler informações de vulnerabilidade do Gerenciamento de Ameaças e Vulnerabilidades'
Delegado (conta corporativa ou de estudante)	RemediationTask.Read	'Ler informações de vulnerabilidade do Gerenciamento de Ameaças e Vulnerabilidades'

Propriedades

Propriedade (ID)	Tipo de dados	Descrição	Exemplo de um valor retornado
Categoria	String	Categoria da atividade de correção (configuração de software/segurança)	Software
completerEmail	Cadeia de caracteres	Se a atividade de correção foi concluída manualmente por alguém, esta coluna contém seu email	Nulo
completerId	Cadeia de caracteres	Se a atividade de correção foi concluída manualmente por alguém, esta coluna contém a ID do objeto	Nulo
completionMethod	Cadeia de caracteres	Uma atividade de correção pode ser concluída "automaticamente" (se todos os dispositivos forem corrigidos) ou "manualmente" por uma pessoa que seleciona "marcar conforme concluído"	Automático
createdOn	DateTime	Hora em que essa atividade de correção foi criada	2021-01-12T18:54:11.5499478Z
Descrição	Cadeia de caracteres	Descrição dessa atividade de correção	Atualize o Microsoft Silverlight para uma versão posterior para mitigar vulnerabilidades conhecidas que afetam seus dispositivos.
dueOn	DateTime	Data de vencimento do criador definido para essa atividade de correção	2021-01-13T00:00:00Z
fixedDevices	.	O número de dispositivos que foram corrigidos	2
ID	Cadeia de caracteres	ID dessa atividade de correção	097d9735-5479-4899-b1b7-77398899df92
nameId	Cadeia de caracteres	Nome do produto relacionado	Microsoft Silverlight
Prioridade	Cadeia de caracteres	Prioridade do conjunto de criadores para essa atividade de correção (High\Medium\Low)	Alto
Productid	Cadeia de caracteres	ID do produto relacionado	microsoft-_-silverlight
productivityImpactRemediationType	Cadeia de caracteres	Algumas alterações de configuração só podem ser solicitadas para dispositivos que não afetam os usuários. Esse valor indica a seleção entre "todos os dispositivos expostos" ou "apenas dispositivos sem impacto do usuário".	AllExposedAssets
rbacGroupNames	Cadeia de caracteres	Nomes de grupo de dispositivos relacionados	[ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram	Cadeia de caracteres	Programa recomendado para atualizar para	Nulo
recommendedVendor	Cadeia de caracteres	Fornecedor recomendado para atualizar para	Nulo
recommendedVersion	Cadeia de caracteres	Versão recomendada para atualizar/atualizar para	Nulo
Relatedcomponent	Cadeia de caracteres	Componente relacionado dessa atividade de correção (semelhante ao componente relacionado para uma recomendação de segurança)	Microsoft Silverlight
requesterEmail	Cadeia de caracteres	Endereço de email do criador	globaladmin@UserName.contoso.com
requesterId	Cadeia de caracteres	ID do objeto criador	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Cadeia de caracteres	As anotações (texto gratuito) que o criador adicionou para essa atividade de correção	Nulo
Scid	Cadeia de caracteres	SCID da recomendação de segurança relacionada	Nulo
Status	Cadeia de caracteres	Status de atividade de correção (Ativo/Concluído)	Ativo
statusLastModifiedOn	DateTime	Data em que o campo status foi atualizado	2021-01-12T18:54:11.5499487Z
targetDevices	Long	Número de dispositivos expostos aos quais essa correção é aplicável	43
Título	String	Título dessa atividade de correção	Atualizar o Microsoft Silverlight
Tipo	String	Tipo de correção	Atualizar
Vendorid	Cadeia de caracteres	Nome do fornecedor relacionado	Microsoft

Exemplo

Exemplo de solicitação

GET https://api.securitycenter.windows.com/api/remediationtasks/

Exemplo de resposta

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks",
    "value": [
        {
            "id": "03942ef5-aewb-4w6e-b555-d6a97013844w",
            "title": "Update Microsoft Silverlight",
            "createdOn": "2021-02-10T13:20:36.4718166Z",
            "requesterId": "65548a1d-ef00-4a7a-8d19-1b967b5c36f4",
            "requesterEmail": "user1@contoso.com",
            "status": "Active",
            "statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z",
            "description": "Update Silverlight to a later version  to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.",
            "relatedComponent": "Microsoft Silverlight",
            "targetDevices": 18511,
            "rbacGroupNames": [
                "UnassignedGroup",
                "hhh"
            ],
            "fixedDevices": 2866,
            "requesterNotes": "test",
            "dueOn": "2021-02-11T00:00:00Z",
            "category": "Software",
            "productivityImpactRemediationType": null,
            "priority": "Medium",
            "completionMethod": null,
            "completerId": null,
            "completerEmail": null,
            "scid": null,
            "type": "Update",
            "productId": "microsoft-_-silverlight",
            "vendorId": "microsoft",
            "nameId": "silverlight",
            "recommendedVersion": null,
            "recommendedVendor": null,
            "recommendedProgram": null
        }
    ]
}

Confira também