Listar todas as atividades de remediação

Aplica-se a:

• API do Microsoft Defender para Endpoint 1
• Microsoft Defender para Endpoint Plano 2
• Gestão de Vulnerabilidade do Microsoft Defender
• Microsoft Defender XDR

Quer experimentar o Microsoft Defender para Ponto Final? Inscreva-se numa avaliação gratuita.

Quer experimentar a Gestão de Vulnerabilidades do Microsoft Defender? Saiba mais sobre como se pode inscrever na versão de avaliação de pré-visualização pública da Gestão de Vulnerabilidades do Microsoft Defender.

Descrição da API

Devolve informações sobre todas as atividades de remediação.

Saiba mais sobre as atividades de remediação.

URL: GET: /api/remediationTasks
Suporta consultas OData V4.
Operadores suportados pelo OData:
$filter em: createdon e status propriedades.
$top com o valor máximo de 10 000.
$skip.
Veja exemplos em Consultas OData com o Microsoft Defender para Endpoint.

Permissões

É necessária uma das seguintes permissões para chamar esta API. Para saber mais, incluindo como escolher permissões, consulte Utilizar as APIs do Microsoft Defender para Endpoint para obter detalhes.

Propriedades

Exemplos:

Exemplo de pedido

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
        }
    ]
}

Consulte também

• Métodos e propriedades de remediação
• Obter uma atividade de remediação por ID
• Listar os dispositivos expostos de uma atividade de remediação
• Gestão de Vulnerabilidade do Microsoft Defender
• Vulnerabilidades na sua organização