alert: updateAlerts

Namespace: microsoft.graph

Importante

APIs na /beta versão 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 em v1.0, use o seletor De versão.

Atualize vários alertas em uma solicitação em vez de várias solicitações.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) SecurityEvents.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application SecurityEvents.ReadWrite.All

Solicitação HTTP

POST /security/alerts/updateAlerts

Cabeçalhos de solicitação

Nome Descrição
Authorization Portador {código}

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação. Cada entidade deve ter propriedades id e vendorInformation. Para obter detalhes sobre as propriedades que podem ser atualizadas, consulte update alert.

Parâmetro Tipo Descrição
valor conjunto alerta Coleção de alertas a ser atualizado. Cada entidade deve ter id, vendorInformation e outras propriedades editáveis a serem atualizadas.

Resposta

Se tiver êxito, este método retornará o código de resposta e o objeto 200, OK da coleção de alertas no corpo da resposta.

Exemplos

O exemplo a seguir mostra como chamar essa API.

Solicitação

Este é um exemplo de solicitação.

POST https://graph.microsoft.com/beta/security/alerts/updateAlerts
Content-type: application/json

{
  "value": [
    {
      "assignedTo": "String",
      "closedDateTime": "String (timestamp)",
      "comments": ["String"],
      "feedback": {"@odata.type": "microsoft.graph.alertFeedback"},
      "id": "String (identifier)",
      "status": {"@odata.type": "microsoft.graph.alertStatus"},
      "tags": ["String"],
      "vendorInformation":
        {
          "provider": "String",
          "vendor": "String"
        }
    }
  ]
}

Resposta

Este é um exemplo de resposta.

Observação

O objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.

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

{
  "value": [
    {
      "activityGroupName": "activityGroupName-value",
      "assignedTo": "assignedTo-value",
      "azureSubscriptionId": "azureSubscriptionId-value",
      "azureTenantId": "azureTenantId-value",
      "category": "category-value",
      "closedDateTime": "datetime-value"
    }
  ]
}