Indicadores de Eliminação em Lote

Aplica-se a:

Quer experimentar o Defender para Ponto Final? Inscrever-se para uma avaliação gratuita.

Nota

Se for um cliente do Us Government, utilize os URIs listados no Microsoft Defender para Endpoint para clientes do Us Government.

Sugestão

Para um melhor desempenho, pode utilizar o servidor mais próximo da localização geográfica:

Descrição da API

Elimina entidades indicadoras por ID.

As limitações de taxa para esta API são 30 chamadas por minuto e 1500 chamadas por hora.

Limite de tamanho do lote de até 500 IDs de Indicador .

É necessária uma das seguintes permissões para chamar esta API. Para saber mais, incluindo como escolher permissões, consulte Introdução.

Tipo de permissão	Permissão	Nome a apresentar da permissão
Aplicação	Ti.ReadWrite	"Indicadores ti de leitura e escrita"
Aplicação	Ti.ReadWrite.All	"Indicadores de leitura e escrita"

POST https://api.securitycenter.microsoft.com/api/indicators/BatchDelete

Sugestão

Para um melhor desempenho, pode utilizar o servidor mais próximo da localização geográfica:

Name	Tipo	Descrição
Autorização	Cadeia	Portador {token}. Obrigatório.

No corpo do pedido, forneça um objeto JSON com os seguintes parâmetros:

Parâmetro	Tipo	Descrição
IndicatorIds	Cadeia de Lista	Uma lista dos IDs dos indicadores a serem removidos. Obrigatório

Se todos os Indicadores existiam e foram eliminados com êxito – 204 OK sem conteúdo.

Se a lista de IDs do indicador estiver vazia ou exceder o limite de tamanho – 400 Pedido Incorreto.

Se algum ID de indicador for inválido - 400 Pedido Incorreto.

Se o requerente não estiver exposto aos grupos de dispositivos de nenhum indicador – 403 Proibido.

Se não tiver sido encontrado nenhum ID do Indicador – 404 Não Encontrado.

Eis um exemplo do pedido.

POST https://api.securitycenter.microsoft.com/api/indicators/BatchDelete

{
    "IndicatorIds": [ "1", "2", "5" ]
}