Partilhar via

Listar todas as atividades de remediação

  • Artigo

Aplica-se a:

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

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

Importante

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

Nota

Se for um cliente do Us Government, utilize os URIs listados no Microsoft Defender para Endpoint para clientes do Us Government.

Sugestão

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

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 Endpoint.

Permissões

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

Tipo de permissão Permissão Nome a apresentar da permissão
Aplicação RemediationTasks.Read.All "Ler informações sobre vulnerabilidades da Gestão de Ameaças e Vulnerabilidades"
Delegado (conta escolar ou profissional) 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 Cadeia Categoria da atividade de remediação (Configuração de software/segurança) Software
completerEmail Cadeia 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 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 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 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 ID desta atividade de remediação 097d9735-5479-4899-b1b7-77398899df92
nameId Cadeia Nome do produto relacionado Microsoft Silverlight
Priority Cadeia Prioridade do conjunto de criadores para esta atividade de remediação (Alto\Médio\Baixo) High
productId Cadeia ID do produto relacionado microsoft-_-silverlight
productivityImpactRemediationType Cadeia 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 Nomes de grupos de dispositivos relacionados [ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram Cadeia Programa recomendado para o que atualizar Nulo
recommendedVendor Cadeia Fornecedor recomendado para atualizar para Nulo
recommendedVersion Cadeia Versão recomendada para atualizar/atualizar para Nulo
relatedComponent Cadeia Componente relacionado desta atividade de remediação (semelhante ao componente relacionado para uma recomendação de segurança) Microsoft Silverlight
requesterEmail Cadeia Endereço de e-mail do criador globaladmin@UserName.contoso.com
requesterId Cadeia ID de objeto do criador r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes Cadeia As notas (texto livre) que o criador adicionou para esta atividade de remediação Nulo
Scid Cadeia SCID da recomendação de segurança relacionada Nulo
Estado Cadeia Estado da atividade de remediação (Ativo/Concluído) Ativo
statusLastModifiedOn DateTime Data em que o campo de estado foi atualizado 01-2021-12T18:54:11.5499487Z
targetDevices Longo Número de dispositivos expostos a que esta remediação é aplicável 43
Cargo Cadeia Título desta atividade de remediação Atualizar o Microsoft Silverlight
Tipo Cadeia Tipo de remediação Update
vendorId Cadeia Nome do fornecedor relacionado Microsoft

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

Sugestão

Quer saber mais? Engage com a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Endpoint Tech Community.