API de Indicadores de Lista

Artigo
05/03/2024

Aplica-se a:

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

Observação

Se você for um cliente do governo dos EUA, use as URIs listadas em Microsoft Defender para Ponto de Extremidade para clientes do governo dos EUA.

Dica

Para obter um melhor desempenho, você pode usar 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

Descrição da API

Recupera uma coleção de todos os Indicadores ativos.

Dá suporte a consultas OData V4.

A consulta do $filter OData tem suporte em: application, , createdByDisplayName, expirationTime, generateAlert, title, rbacGroupNames, indicatorValuerbacGroupIds, , indicatorType, , creationTimeDateTimeUtc, , createdBy, , actione severity propriedades.
$stop com valor máximo de 10.000.
$skip.

Consulte exemplos em consultas OData com Microsoft Defender para Ponto de Extremidade.

Limitações

As limitações de taxa para essa API são 100 chamadas por minuto e 1.500 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 da exibição de 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, esse método retornará 200, código de resposta Ok com uma coleção de entidades Indicator .

Observação

Se o Aplicativo tiver Ti.ReadWrite.All permissão, ele será exposto a todos os Indicadores. Caso contrário, ele será exposto apenas aos Indicadores criados.

Exemplo 1

Solicitação de exemplo 1

Aqui está um exemplo de uma solicitação que obtém todos os indicadores.

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

Exemplo 1 de resposta

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

Solicitação de exemplo 2

Aqui está um exemplo de uma solicitação que obtém todos os Indicadores com AlertAndBlock ação.

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

Exemplo 2 de resposta