API de indicadores de lista

Artículo
05/03/2024

Se aplica a:

¿Quiere experimentar Microsoft Defender para punto de conexión? Regístrese para obtener una prueba gratuita.

Nota:

Si es un cliente del Gobierno de EE. UU., use los URI que aparecen en Microsoft Defender para punto de conexión para clientes del Gobierno de EE. UU.

Sugerencia

Para mejorar el rendimiento, puede usar el servidor más cercano a la ubicación 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

Descripción de la API

Recupera una colección de todos los indicadores activos.

Admite consultas OData V4.

La consulta de $filter OData se admite en las propiedades , application, createdByDisplayName, generateAlertexpirationTime, title, rbacGroupNames, rbacGroupIds, indicatorValueindicatorType, creationTimeDateTimeUtc, , createdBy, actiony severity .
$stop con un valor máximo de 10 000.
$skip.

Consulte ejemplos en consultas de OData con Microsoft Defender para punto de conexión.

Limitaciones

Las limitaciones de velocidad de esta API son 100 llamadas por minuto y 1500 llamadas por hora.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para más información, incluido cómo elegir permisos, consulte Introducción.

Tipo de permiso	Permiso	Nombre para mostrar del permiso
Aplicación	Ti.ReadWrite	`Read and write Indicators`
Aplicación	Ti.ReadWrite.All	`Read and write All Indicators`
Delegado (cuenta profesional o educativa)	Ti.ReadWrite	`Read and write Indicators`

Solicitud HTTP

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

Encabezados de solicitud

Nombre	Tipo	Descripción
Authorization	Cadena	{token} de portador. Necesario.

Cuerpo de la solicitud

En blanco

Respuesta

Si se ejecuta correctamente, este método devuelve el código de respuesta 200, Ok con una colección de entidades Indicator .

Nota:

Si la aplicación tiene Ti.ReadWrite.All permiso, se expondrá a todos los indicadores. De lo contrario, solo se expondrá a los indicadores que creó.

Ejemplo 1

Solicitud de ejemplo 1

Este es un ejemplo de una solicitud que obtiene todos los indicadores.

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

Respuesta de ejemplo 1

Este es un ejemplo de la respuesta:

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" ]
        }
        ...
    ]
}

Ejemplo 2

Solicitud de ejemplo 2

Este es un ejemplo de una solicitud que obtiene todos los indicadores con AlertAndBlock acción.

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

Respuesta del ejemplo 2