Obter uma atividade de remediação por ID
Aplica-se a:
- API do Microsoft Defender para Endpoint 1
- Microsoft Defender para Endpoint
- 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.
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
- ina.api.security.microsoft.com
Descrição da API
Devolve informações para a atividade de remediação especificada. Apresenta as mesmas colunas que Obter toda a atividade de remediação", mas devolve resultados apenas para uma atividade de remediação especificada.
Saiba mais sobre as atividades de remediação.
Listar uma atividade de remediação especificada para (ID)
URL: GET: /api/remediationTasks/{id}
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.
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.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 | 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/03942ef5-aecb-4c6e-b555-d6a97013844c
Exemplo de resposta
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks/$entity",
"id": "03942ef5-aecb-4c6e-b555-d6a97013844c",
"title": "Update Microsoft Silverlight",
"createdOn": "2021-02-10T13:20:36.4718166Z",
"requesterId": "65548a1d-efo0-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
- Listar todas as atividades de remediação
- Listar os dispositivos expostos de uma atividade de remediação
- Gestão de Vulnerabilidade do Microsoft Defender
- Vulnerabilidades na sua organização
Sugestão
Quer saber mais? Contacte a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Endpoint Tech Community.