API de Indicadores de Lista

Artigo
02/20/2025

Aplica-se a:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita.

Observação

Se for um cliente do Governo norte-americano, utilize os URIs listados no Microsoft Defender para Ponto de Extremidade para clientes do Us Government.

Dica

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

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

Descrição da API

Obtém uma coleção de todos os Indicadores ativos.

Suporta consultas OData V4.

A consulta do $filter OData é suportada em: application, , createdByDisplayName, expirationTimegenerateAlert, title, rbacGroupNames, rbacGroupIds, indicatorValue, , indicatorType, creationTimeDateTimeUtc, , createdBy, e action, e severity propriedades.
$stop com o valor máximo de 10 000.
$skip.

Veja exemplos em Consultas OData com Microsoft Defender para Ponto de Extremidade.

Limitações

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

Permissões

Uma das seguintes permissões é necessária 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
Application	Ti.ReadWrite	`Read and write Indicators`
Application	Ti.ReadWrite.All	`Read and write All Indicators`
Delegado (conta corporativa ou de estudante)	Ti.ReadWrite	`Read and write Indicators`

Solicitação HTTP

GET https://api.securitycenter.microsoft.com/api/indicators

Cabeçalhos de solicitação

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

Corpo da solicitação

Vazio

Resposta

Se for bem-sucedido, este método devolve o código de resposta 200 Ok com uma coleção de entidades indicadoras .

Observação

Se a Aplicação tiver Ti.ReadWrite.All permissão, será exposta a todos os Indicadores. Caso contrário, será exposto apenas aos Indicadores que criou.

Exemplo 1

Pedido de exemplo 1

Eis um exemplo de um pedido que obtém todos os indicadores.

GET https://api.securitycenter.microsoft.com/api/indicators

Resposta de exemplo 1

Veja um exemplo de resposta.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Indicators",
    "value": [
        {
            "id": "995",
            "indicatorValue": "12.13.14.15",
            "indicatorType": "IpAddress",
            "action": "Alert",
            "application": "demo-test",
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T11:15:35.3688259Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "test",
            "rbacGroupNames": []
        },
        {
            "id": "996",
            "indicatorValue": "220e7d15b0b3d7fac48f2bd61114db1022197f7f",
            "indicatorType": "FileSha1",
            "action": "AlertAndBlock",
            "application": null,
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T10:54:23.2009016Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "TEST",
            "rbacGroupNames": [ "Group1", "Group2" ]
        }
        ...
    ]
}

Exemplo 2

Pedido de exemplo 2

Eis um exemplo de um pedido que obtém todos os Indicadores com AlertAndBlock ação.

GET https://api.securitycenter.microsoft.com/api/indicators?$filter=action+eq+'AlertAndBlock'

Resposta de exemplo 2