Obter uma atividade de correção por ID

Artigo
08/14/2024

Aplica-se a:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade? 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 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 Us Government, utilize os URIs listados no Microsoft Defender para Endpoint 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 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

Uma das seguintes permissões é necessária 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
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.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	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	Long	Número de dispositivos expostos a que esta remediação é aplicável	43
Título	String	Título desta atividade de remediaçã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/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
}

Confira também