Compartilhar via

Listar incidentTasks

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.

Obtenha tarefas de incidentes que Especialistas do Microsoft Defender para XDR identificadas para remediação.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ❌ ❌ ❌

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissão com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Importante

Para acesso delegado através de contas escolares ou profissionais, tem de ser atribuída ao utilizador com sessão iniciada uma função de Microsoft Entra suportada ou uma função personalizada que conceda as permissões necessárias para esta operação. Esta operação suporta as seguintes funções incorporadas, que fornecem apenas o menor privilégio necessário:

  • Leitor de Segurança
  • Leitor Global
  • Operador de Segurança
  • Administrador de Segurança

Solicitação HTTP

GET /security/incidentTasks

Parâmetros de consulta opcionais

Este método suporta estes parâmetros de consulta OData para personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.

Parâmetro Tipo Descrição
$filter string Filtrar resultados por valores de propriedade. Propriedades suportadas: incidentId (eq), status (eq), tipo (eq), lastUpdateDateTime (eq), createdDateTime (eq), actionType (eq).
$orderby cadeia de caracteres Ordene os resultados por valores de propriedade. Propriedade suportada: lastUpdateDateTime.
$top inteiro Defina o tamanho da página dos resultados. O tamanho da página predefinido é de 500 resultados e o máximo é de 500 resultados.
$select string Escolha propriedades específicas a incluir nos resultados.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objetos security-incidentTask no corpo da resposta.

Exemplos

Solicitação

GET https://graph.microsoft.com/beta/security/incidentTasks

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "collection(#microsoft.graph.security.incidentTask)",
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.incidentTask",
      "id": "213213",
      "incident": {
        "@odata.type": "#microsoft.graph.security.incident",
        "id": "123"
      },
      "status": "open",
      "source": "defenderExpertsXDR",
      "displayName": "Isolate device testmachine20",
      "description": "This action will isolate device testmachine20 from the network.",
      "createdDateTime": "2023-06-26T19:07:39.7433333Z",
      "createdByDisplayName": "Defender Experts",
      "lastModifiedDateTime": "2023-06-27T10:49:33.98Z",
      "lastModifiedByDisplayName": "bealfasi",
      "actionType": "isolateDevice",
      "actionStatus": "notStarted",
      "responseAction": {
        "@odata.type": "#microsoft.graph.security.isolateDeviceResponseAction",
        "isolationType": "full",
        "identifierValue": "02851525-dc00-438b-83f5-3b2947bf4a48"
      }
    }
  ]
}
  • Last updated on