Partilhar via


Versões de API das APIs REST do Microsoft Sentinel

Este artigo lista as versões atuais e anteriores das APIs REST do Microsoft Sentinel.

Observação

A partir da versão 2021-09-01-preview, cada versão Preview contém todos os grupos de operações Preview. A partir da versão 2021-10-01, cada versão estável contém todos os grupos de operação estáveis. Se um grupo de operações não tiver sido alterado desde a última versão, ele será transferido as-is para a nova versão.

Versões de pré-visualização

Para tirar partido de todas as funcionalidades de Pré-visualização Pública mais recentes, utilize a versão de pré-visualização mais recente. As versões de visualização também são lançadas para testar novas funcionalidades, coletar feedback e identificar e corrigir problemas. As APIs de pré-visualização estão disponíveis nos Termos de Utilização Suplementares do para Pré-visualizações do Microsoft Azure.

Versão da API Especificação Atualizações da API
2025-04-01-preview Especificação Swagger Nota de lançamento
2025-01-01-preview Especificação Swagger Nota de lançamento
2024-10-01-preview Especificação Swagger Nota de lançamento
2024-04-01-preview Especificação Swagger Nota de lançamento
2024-01-01-preview Especificação Swagger Nota de lançamento
2023-12-01-preview Especificação Swagger Nota de lançamento
2023-10-01-preview Especificação Swagger Nota de lançamento
2023-09-01-preview Especificação Swagger
2023-08-01-preview Especificação Swagger Nota de lançamento
2023-07-01-preview Especificação Swagger Nota de lançamento
2023-06-01-preview Especificação Swagger Nota de lançamento
2023-05-01-preview Especificação Swagger Nota de lançamento
2023-04-01-preview Especificação Swagger Nota de lançamento
2023-03-01-preview Especificação Swagger Nota de lançamento
2023-02-01-preview Especificação Swagger Nota de lançamento
2022-12-01-preview Especificação Swagger Nota de lançamento
2022-11-01-preview Especificação Swagger Nota de lançamento
2022-10-01-preview Especificação Swagger Nota de lançamento
2022-09-01-preview Especificação Swagger Nota de lançamento
2022-08-01-preview Especificação Swagger Nota de lançamento
2022-07-01-preview Especificação Swagger
2022-06-01-preview Especificação Swagger
2022-05-01-preview Especificação Swagger
2022-04-01-preview Especificação Swagger
2022-01-01-preview Especificação Swagger
2021-10-01-preview Especificação Swagger Nota de lançamento
2021-09-01-preview Especificação Swagger Nota de lançamento
2021-03-01-preview Especificação Swagger
2019-01-01-preview Especificação Swagger

Versões estáveis

Use a versão estável mais recente quando quiser acessar os recursos mais recentes disponíveis em geral (GA).

Versão da API Especificação Atualizações da API
2025-03-01 Especificação Swagger Nota de lançamento
2024-09-01 Especificação Swagger Nota de lançamento
2024-03-01 Especificação Swagger Nota de lançamento
2023-11-01 Especificação Swagger Nota de lançamento
2023-02-01 Especificação Swagger Nota de lançamento
2022-11-01 Especificação Swagger
2022-08-01 Especificação Swagger Nota de lançamento
2021-10-01 Especificação Swagger Nota de lançamento
2021-04-01 Especificação Swagger Nota de lançamento
2020-01-01 Especificação Swagger Nota de lançamento

Notas de versão

2025-04-01-visualização

Esta versão da API é a versão Preview atual das APIs REST do Microsoft Sentinel. Ele inclui todos os recursos Preview & GA lançados anteriormente.

2025-03-01

Esta versão da API é a versão atual disponível em geral (GA) das APIs REST do Microsoft Sentinel. Os recursos geralmente disponíveis nesta versão incluem:

  • ContentProductPackages
    • Adicionado suporte para $search na API de listagem contentProductPackages.
    • Adicionado suporte para o novo contentTypes SummaryRule.
  • SourceControl

2025-01-01-visualização

Ele inclui todos os recursos Preview & GA lançados anteriormente.

  • Regras de automação
    • Adicione um novo tipo de condição de regra de automação (IncidentCustomDetectionRuleIds) para permitir o acionamento de regras de automação para incidentes que contenham alertas criados por regras de deteção personalizadas específicas.
    • Adicione um novo tipo de condição de regra de automação (IncidentAlertTitle) para permitir o acionamento de regras de automação com base em títulos de alertas no incidente de acionamento.
  • Controles de origem
    • A especificação e a documentação atuais usam a ortografia "AnalyticRule" no campo {properties.contentTypes}, mas nosso serviço reconhece apenas "AnalyticsRule". O comportamento do serviço está correto, por isso gostaríamos de corrigir a especificação - link
  • Incidentes
  • Adicione 2 novas propriedades a IncidentAdditionalData para permitir o rastreamento de incidentes mesclados ou redirecionados: + mergedIncidentUrl: A URL do incidente em que o incidente atual foi mesclado + mergedIncidentNumber: o número do incidente no qual o incidente atual foi mesclado
  • Remover a ação "Criar equipa".

2024-10-01-pré-visualização

Ele inclui todos os recursos Preview & GA lançados anteriormente.

  • ContentProductPackages
    • Adicionado suporte para $search na API de listagem contentProductPackages.
    • Adicionado suporte para o novo contentTypes SummaryRule.
  • Conector de dados
    • Adicionado novo tipo de conector de dados PurviewAudit.

2024-09-01

Os recursos geralmente disponíveis nesta versão incluem:

2024-04-01-visualização

Ele inclui todos os recursos Preview & GA lançados anteriormente.

  • Inteligência de ameaças
    • Adicionadas novas APIs CRUD de TI, ações em massa, regras de ingestão
  • BusinessApplicationAgents
    • Novos recursos introduzidos
      • BusinessApplicationAgents/Sistemas/Ações

2024-03-01

Os recursos geralmente disponíveis nesta versão incluem:

  • Tarefas de incidentes
    • Adicione tarefas como um recurso aninhado para incidentes e a capacidade de criar tarefas a partir de regras de automação
  • Playbook manual gatilho
    • Adicionar capacidade de acionar manualmente um manual sobre um incidente, entidade ou alerta

2024-01-01-pré-visualização

Ele inclui todos os recursos Preview & GA lançados anteriormente.

  • Conectores de dados
    • Adicionado novo tipo de conector RestApiPoller
  • Enriquecimento
    • Novos pontos de extremidade adicionados
      • ListGeodataByIp
      • ListWhoisByDomain
  • Recomendações
    • Dividiu a Recomendação em várias Sugestões.
    • Adicionado um novo estado "InProgress" e alterado os existentes.
    • Novo endpoint adicionado
      • triggerEvaluation
  • Inteligência de ameaças
    • Novos pontos de extremidade adicionados
      • Consulta
      • Contagem

2023-12-01-pré-visualização

Ele inclui todos os recursos Preview & GA lançados anteriormente.

2023-11-01

Os recursos geralmente disponíveis nesta versão incluem:

  • Hub de conteúdo
    • Adicionado mais parâmetros OData suportados.

2023-10-01-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente e, além disso, os seguintes aprimoramentos:

  • Conectores de dados
    • DataConnectorDefinitions - Adicionada exceção para a palavra "Criterias" no arquivo cSpell.json.
  • Hub de conteúdo
    • Adicionado mais parâmetros OData suportados.

2023-08-01-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Gerenciador de espaços de trabalho
    • Alteração corretiva no nome do parâmetro WorkspaceManagerMember.

2023-07-01-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Conectores de dados
    • Novo ponto de extremidade de API adicionado para gerenciar definições de conector de dados.

2023-06-01-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Controles de origem
    • Adicionada capacidade de gerenciar conexões de controle do código-fonte via API adicionando parâmetros de acesso ao repositório.

2023-05-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

2023-04-01-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Gerenciador de espaços de trabalho

    • O Microsoft Sentinel Workspace Manager permite que clientes e parceiros gerenciem vários espaços de trabalho do Microsoft Sentinel a partir de um ponto central. Os parâmetros de avaliação incluíram:
      • WorkspaceManagerConfigurations
      • WorkspaceManagerMembros
      • WorkspaceManagerGroups
      • WorkspaceManagerAtribuições
  • Caçadas

    • Ponto de extremidade Hunts adicionado

2023-03-01-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Manuais
    • de gatilho de entidade
    • Novo ponto de extremidade para permitir o acionamento manual de um playbook em uma entidade.

2023-02-01

Os recursos geralmente disponíveis nesta versão incluem:

2023-02-01-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Conectores de dados
  • Regras de alerta (também conhecidas como regras de análise)
    • Novos pontos de extremidade adicionados
      • triggeredAnalyticsRuleRuns – Get/GetAll
      • alertRules/{ruleId}/triggerRuleRun

2022-12-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Incidentes
    • Adicionar tarefas de incidentes como um recurso aninhado para incidentes

2022-11-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Recomendações
    • Versão da API de recomendações adicionada

2022-10-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

2022-09-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

2022-08-01

Os recursos geralmente disponíveis nesta versão incluem:

  • Regras de alerta (também conhecidas como regras de análise)
    • Suporte MITRE

2022-08-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Importações de ficheiros
    • Novo grupo de operação. Permite a adição em massa de indicadores ao Threat Intelligence. Saiba mais

01-10-2021

Esta versão inclui todos os recursos disponíveis em geral (GA) lançados anteriormente, além das seguintes adições:

2021-10-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

  • Regras de alerta (também conhecidas como regras de análise)
  • Regras de automação
    • Novo ponto de extremidade adicionado para executar playbooks sob demanda em incidentes.
  • Favoritos
    • Apoie as técnicas MITRE.
    • Suporte ao mapeamento estendido de entidades.
  • Conectores de dados
  • Incidentes

2021-09-01-pré-visualização

Esta versão inclui todos os recursos de visualização lançados anteriormente, além das seguintes adições:

2021-04-01

Os recursos geralmente disponíveis nesta versão incluem:

  • Incidentes
  • Inteligência de ameaças
  • Listas de observação
  • Incidentes

2020-01-01

Os recursos geralmente disponíveis nesta versão incluem:

  • Regras de alerta
  • Modelos de regras de alerta
  • Favoritos
  • Conectores de dados
  • Incidentes

Ver também

  • de documentação do Microsoft Sentinel
  • de referência de modelos Bicep & ARM