Listar todas as atividades de correção

Artigo
03/01/2025

Aplica-se a:

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

Quer experimentar Gerenciamento de Vulnerabilidades do Microsoft Defender? Saiba mais sobre como se pode inscrever na Gerenciamento de Vulnerabilidades do Microsoft Defender avaliação de pré-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 for um cliente do Governo norte-americano, utilize os URIs listados no Microsoft Defender para Ponto de Extremidade para clientes do Us Government.

Dica

Para um melhor desempenho, pode utilizar 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
ina.api.security.microsoft.com

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 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, veja Utilizar Microsoft Defender para Ponto de Extremidade APIs para obter detalhes.

Tipo de permissão	Permissão	Nome a apresentar da permissão
Application	RemediationTasks.Read.All	"Ler informações sobre vulnerabilidades da Gestão de Ameaças e Vulnerabilidades"
Delegado (conta corporativa ou de estudante)	RemediationTask.Read	"Ler informações sobre vulnerabilidades da Gestão de Ameaças e Vulnerabilidades"

Propriedades

Propriedade (ID)	Tipo de dados	Descrição	Exemplo de um valor devolvido
Categoria	String	Categoria da atividade de remediação (Configuração de software/segurança)	Software
completerEmail	Cadeia de caracteres	Se a atividade de remediação tiver sido concluída manualmente por alguém, esta coluna contém o respetivo e-mail	Nulo
completerId	Cadeia de caracteres	Se a atividade de remediação tiver sido concluída manualmente por alguém, esta coluna contém o respetivo ID de objeto	Nulo
completionMethod	Cadeia de caracteres	Uma atividade de remediação pode ser concluída "automaticamente" (se todos os dispositivos forem corrigidos) ou "manualmente" por uma pessoa que selecione "marcar como concluído"	Automático
createdOn	DateTime	Hora em que esta atividade de remediação foi criada	01-2021-12T18:54:11.5499478Z
Descrição	Cadeia de caracteres	Descrição desta atividade de remediação	Atualize o Microsoft Silverlight para uma versão posterior para mitigar vulnerabilidades conhecidas que afetam os seus dispositivos.
dueOn	DateTime	Data para conclusão do criador definido para esta atividade de remediação	01-2021-13T00:00:00Z
fixedDevices	.	O número de dispositivos que foram corrigidos	2
ID	Cadeia de caracteres	ID desta atividade de remediaçã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 esta atividade de remediação (Alto\Médio\Baixo)	Alto
productId	Cadeia de caracteres	ID do produto relacionado	microsoft-_-silverlight
productivityImpactRemediationType	Cadeia de caracteres	Algumas alterações de configuração só podiam ser pedidas para dispositivos que não afetam os utilizadores. Este valor indica a seleção entre "todos os dispositivos expostos" ou "apenas dispositivos sem impacto do utilizador".	AllExposedAssets
rbacGroupNames	Cadeia de caracteres	Nomes de grupos de dispositivos relacionados	[ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram	Cadeia de caracteres	Programa recomendado para o que atualizar	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 desta atividade de remediação (semelhante ao componente relacionado para uma recomendação de segurança)	Microsoft Silverlight
requesterEmail	Cadeia de caracteres	Endereço de e-mail do criador	globaladmin@UserName.contoso.com
requesterId	Cadeia de caracteres	ID de objeto do criador	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Cadeia de caracteres	As notas (texto livre) que o criador adicionou para esta atividade de remediação	Nulo
Scid	Cadeia de caracteres	SCID da recomendação de segurança relacionada	Nulo
Status	Cadeia de caracteres	Atividade de remediação status (Ativa/Concluída)	Ativo
statusLastModifiedOn	DateTime	Data em que o campo status foi atualizado	01-2021-12T18:54:11.5499487Z
targetDevices	Long	Número de dispositivos expostos a que esta remediação é aplicável	43
Título	String	Título desta atividade de remediação	Atualizar o Microsoft Silverlight
Tipo	String	Tipo de remediaçã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

Dica

Você deseja aprender mais? Engage com a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Ponto de Extremidade Tech Community.

Compartilhar via