incidentTask resource type

Espaço de nomes: microsoft.graph.security

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa uma ação de remediação para um incidente. Quando Especialistas do Microsoft Defender para XDR identifica uma ação necessária, cria uma tarefa para que possa rever e agir. Reveja e tome medidas nestas tarefas através do portal ou através desta API.

Herda de microsoft.graph.entity.

Métodos

Método	Tipo de retorno	Descrição
List	microsoft.graph.security.incidentA coleção de tarefas	Obtenha objetos de tarefas de incidentes e as respetivas propriedades.
Get	microsoft.graph.security.incidentTask	Ler propriedades e relações de uma tarefa de incidente.
Atualizar	microsoft.graph.security.incidentTask	Atualize a status de uma tarefa de incidente.
Executar ação de resposta	Nenhum	Execute uma ação de remediação numa tarefa de incidente. Limitado aos tipos de ação suportados.

Propriedades

Propriedade	Tipo	Descrição
actionStatus	microsoft.graph.security.incidentTaskActionStatus	A execução status da ação. Os valores possíveis são: notStarted, inProgress, partiallyCompleted, completed, failed, unknownFutureValue. Para obter mais informações, veja incidentTaskActionStatus values (Valores incidentTaskActionStatus).
actionType	microsoft.graph.security.incidentTaskActionType	A ação de remediação a executar. Os valores possíveis são: text, , isolateDevice, runAntiVirusScanstopAndQuarantineFile, collectInvestigationPackage, restrictAppExecution, submitIocRule, forceUserPasswordReset, disableUser, , markUserAsCompromised, requireSignIn, , hardDeleteEmail, softDeleteEmail, , unIsolateDevice, unRestrictAppExecution, , enableUser, . unknownFutureValue Para obter mais informações, veja incidentTaskActionType values (Valores incidentTaskActionType).
createdByDisplayName	Cadeia de caracteres	Nome da entidade que criou a tarefa. Somente leitura.
createdDateTime	DateTimeOffset	Tempo de criação da tarefa. Somente leitura.
description	Cadeia de caracteres	Descrição da ação de remediação.
displayName	String	Título da tarefa.
id	Cadeia de caracteres	Identificador GUID exclusivo para a tarefa.
lastModifiedByDisplayName	Cadeia de caracteres	Nome da entidade que atualizou a tarefa pela última vez. Somente leitura.
lastModifiedDateTime	DateTimeOffset	Hora da última atualização da tarefa. Somente leitura.
responseAction	microsoft.graph.security.incidentTaskResponseAction	A ação de resposta.
source	microsoft.graph.security.incidentTaskSource	Origem da tarefa. Os valores possíveis são: defenderExpertsGuidedResponse, defenderExpertsManagedResponse, unknownFutureValue. Para obter mais informações, veja incidentTaskSource values (Valores incidentTaskSource).
status	microsoft.graph.security.incidentTaskStatus	Status de tarefas atual. Esta propriedade é a única propriedade que pode atualizar. Os valores possíveis são: open, inProgress, completed, failed, notRelevant, unknownFutureValue. Para obter mais informações, veja incidentTaskStatus values (Valores incidentTaskStatus).

incidentTaskActionStatus values (valores incidentTaskActionStatus)

Member	Descrição
notStarted	A ação relacionada com a tarefa do incidente não é iniciada.
inProgress	A ação relacionada com a tarefa do incidente é inProgress.
parcialmente Concluído	A ação relacionada com a tarefa do incidente está parcialmente concluída.
concluído	A ação relacionada com a tarefa do incidente está concluída.
falha	A ação relacionada com a tarefa do incidente falhou.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

incidentTaskActionType valores

Member	Descrição
texto	A ação pode ser qualquer texto livre, por exemplo, o SOC pode orientar o cliente para formatar o respetivo dispositivo.
isolateDevice	Utiliza Microsoft Defender para Ponto de Extremidade para aplicar isolamento de rede completo, impedindo que o dispositivo se ligue a qualquer aplicação ou serviço.
stopAndQuarantineFile	Utiliza Microsoft Defender para Ponto de Extremidade para eliminar um ficheiro do dispositivo.
runAntiVirusScan	Efetua Microsoft Defender análise do Antivírus no dispositivo.
collectInvestigationPackage	Utiliza Microsoft Defender para Ponto de Extremidade para recolher registos de dispositivos e armazena-os num ficheiro ZIP.
restrictAppExecution	Define restrições no dispositivo para permitir que apenas os executáveis assinados com um certificado emitido pela Microsoft sejam executados.
submitIocRule	Submeta a regra do COI.
forceUserPasswordReset	Força o utilizador a repor a palavra-passe.
disableUser	Impede temporariamente um utilizador de iniciar sessão no local.
markUserAsCompromised	Define o nível de risco dos utilizadores como "alto" no Azure Active Directory.
requireSignIn	Requer que o utilizador inicie sessão novamente.
hardDeleteEmail	Elimina a mensagem de e-mail.
softDeleteEmail	Move a mensagem de e-mail para a pasta eliminada.
unIsolateDevice	Reverte a ação de resposta isolateDevice.
unRestrictAppExecution	Reverte a ação de resposta restrictAppExecution.
enableUser	Reverte a ação de resposta disableUser.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

incidentTaskSource values (valores incidentTaskSource)

Member	Descrição
defenderExpertsGuidedResponse	A tarefa de incidente dos Especialistas em Defender está pendente do cliente para execução.
defenderExpertsManagedResponse	A execução de tarefas de incidentes dos Especialistas em Defender é efetuada por Especialistas do Defender.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

incidentTaskStatus values (valores incidentTaskStatus)

Member	Descrição
abrir	A tarefa do incidente está marcada como aberta.
inProgress	A tarefa do incidente está marcada como em curso.
concluído	A tarefa do incidente está marcada como concluída.
falha	A tarefa do incidente está marcada como falhada. A execução da falha na ação define a tarefa do incidente status também falhou.
notRelevant	A tarefa do incidente é marcada como não relevante.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

Relações

Relação	Tipo	Descrição
incidente	microsoft.graph.security.incident	Obrigatório. O incidente que contém esta tarefa. Tem de conter um ID de incidente válido.

Representação JSON

O JSON seguinte mostra a estrutura do tipo de recurso.

{
  "@odata.type": "#microsoft.graph.security.incidentTask",
  "id": "String (identifier)",
  "status": "String",
  "source": "String",
  "displayName": "String",
  "description": "String",
  "createdDateTime": "String (timestamp)",
  "createdByDisplayName": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedByDisplayName": "String",
  "actionStatus": "String",
  "actionType": "String",
  "incident": {
    "@odata.type": "microsoft.graph.security.incident",
    "id": "String"
  }
}