Exportación de la evaluación de líneas base de seguridad por dispositivo

Se aplica a: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2, Microsoft Defender Vulnerability Management

Hay diferentes llamadas API para obtener diferentes tipos de datos. En general, cada llamada API contiene los datos necesarios para los dispositivos de la organización.

Respuesta JSON La API extrae todos los datos de la organización como respuestas JSON. Este método es mejor para organizaciones pequeñas con menos de 100 K dispositivos. La respuesta está paginada, por lo que puede usar el campo @odata.nextLink de la respuesta para capturar los resultados siguientes.
a través de archivos Esta solución de API permite extraer grandes cantidades de datos de forma más rápida y confiable. Por lo tanto, se recomienda para organizaciones grandes, con más de 100 K dispositivos. Esta API extrae todos los datos de la organización como archivos de descarga. La respuesta contiene direcciones URL para descargar todos los datos de Azure Storage. Puede descargar datos de Azure Storage de la siguiente manera:
- Llame a la API para obtener una lista de direcciones URL de descarga con todos los datos de la organización.
- Descargue todos los archivos mediante las direcciones URL de descarga y procese los datos como desee.

Los datos recopilados mediante "respuesta JSON o a través de archivos" son la instantánea actual del estado actual. No contiene datos históricos. Para recopilar datos históricos, los clientes deben guardar los datos en sus propios almacenamientos de datos.

Nota:

A menos que se indique lo contrario, todos los métodos de evaluación de línea base de seguridad de exportación enumerados son exportación completa y por dispositivo (también denominados por dispositivo)

1. Exportación de la evaluación de líneas base de seguridad (respuesta JSON)

Descripción del método de API 1.1

Devuelve todas las evaluaciones de líneas base de seguridad para todos los dispositivos, por dispositivo. Devuelve una tabla con una entrada independiente para cada combinación única de DeviceId, ProfileId y ConfigurationId.

1.2 Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, consulte Uso de Microsoft Defender para punto de conexión API para obtener más información.

Tipo de permiso	Permiso	Nombre para mostrar del permiso
Aplicación	SecurityBaselinesAssessment.Read.All	"Leer toda la información de las evaluaciones de líneas de base de seguridad"
Delegado (cuenta profesional o educativa)	SecurityBaselinesAssessment.Read	"Leer la información de las evaluaciones de líneas de base de seguridad"

1.3 Limitaciones

El tamaño máximo de página es de 200 000.
Las limitaciones de velocidad de esta API son 30 llamadas por minuto y 1000 llamadas por hora.

1.4 Parámetros

pageSize (valor predeterminado = 50 000): número de resultados en respuesta.
$top: número de resultados que se van a devolver (no devuelve @odata.nextLink y, por lo tanto, no extrae todos los datos).

1.5 Solicitud HTTP

GET /api/machines/baselineComplianceAssessmentByMachine

Propiedades 1.6 (respuesta JSON)

Nota:

Cada registro tiene aproximadamente 1 KB de datos. Debe tener esto en cuenta al elegir el parámetro pageSize correcto.

Es posible que se devuelvan algunas columnas adicionales en la respuesta. Estas columnas son temporales y pueden quitarse. Use solo las columnas documentadas.

Las propiedades definidas en la tabla siguiente se enumeran alfabéticamente por identificador de propiedad. Al ejecutar esta API, la salida resultante no se devolverá necesariamente en el mismo orden que se muestra en esta tabla.

Propiedad (ID)	Tipo de datos	Description
configurationId	Cadena	Identificador único de una configuración específica en el punto de referencia de línea base.
profileId	Cadena	Identificador único para el perfil evaluado.
deviceId	Cadena	Identificador único del dispositivo en el servicio.
deviceName	Cadena	Nombre de dominio completo (FQDN) del dispositivo.
isApplicable	Booleano	Indica si la configuración es aplicable a este dispositivo.
isCompliant	Booleano	Indica si el dispositivo es compatible con la configuración.
id	Cadena	Identificador único del registro, que es una combinación de DeviceId, ProfileId y ConfigurationId.
osVersion	Cadena	Versión específica del sistema operativo que se ejecuta en el dispositivo.
osPlatform	Cadena	Plataforma del sistema operativo que se ejecuta en el dispositivo. Sistemas operativos específicos con variaciones dentro de la misma familia, como Windows 10 y Windows 11. Consulte Sistemas operativos y plataformas compatibles con MDVM para obtener más información.
rbacGroupId	Int	Identificador del grupo de control de acceso basado en rol (RBAC). Si el dispositivo no está asignado a ningún grupo de RBAC, el valor será "Sin asignar". Si la organización no contiene ningún grupo de RBAC, el valor será "Ninguno".
rbacGroupName	Cadena	El grupo de control de acceso basado en rol (RBAC). Si el dispositivo no está asignado a ningún grupo de RBAC, el valor será "Sin asignar". Si la organización no contiene ningún grupo de RBAC, el valor será "Ninguno".
DataCollectionTimeOffset	DateTime	El momento en que se recopilaron los datos del dispositivo. Es posible que este campo no aparezca si no se recopilaron datos.
ComplianceCalculationTimeOffset	DateTime	El momento en que se realizó el cálculo de la evaluación.
RecommendedValue	Cadena	Conjunto de valores esperados para que la configuración actual del dispositivo sea reclamada.
CurrentValue	Cadena	Conjunto de valores detectados que se encuentran en el dispositivo.
Origen	String	La ruta de acceso del Registro u otra ubicación usada para determinar la configuración actual del dispositivo.

Ejemplo 1.7

1.7.1 Ejemplo de solicitud

GET https://api.security.microsoft.com/api/machines/BaselineComplianceAssessmentByMachine

Ejemplo de respuesta 1.7.2

{
"@odata.context": " https://api.security.microsoft.com /api/$metadata#Collection(microsoft.windowsDefenderATP.api.AssetBaselineAssessment)",
"value": [
{
    "id": "0000682575d5d473e82ed4d8680425d152411251_9e1b90be-e83e-485b-a5ec-4a429412e734_1.1.1",
    "configurationId": "1.1.1",
    "deviceId": "0000682575d5d473242222425d152411251",
    "deviceName": " ComputerPII_365f5c0bb7202c163937dad3d017969b2d760eb4.DomainPII_29596 ",
    "profileId": "9e1b90be-e83e-485b-a5ec-4a429412e734",
    "osPlatform": "WindowsServer2019",
    "osVersion": "10.0.17763.2330",
    "rbacGroupId": 86,
    "rbacGroupName": "UnassignedGroup",
    "isApplicable": true,
    "isCompliant": false,
    "dataCollectionTimeOffset": "2021-12-22T00:08:02.478Z",
    "recommendedValue": [
                    "Greater than or equal '24'"
                ],
                "currentValue": [
                    "24"
                ],
                "source": [
                    "password_hist_len"
                ],
}

2. Exportación de la evaluación de líneas base de seguridad (a través de archivos)

2.1 Descripción del método de API

2.2 Limitaciones

Las limitaciones de frecuencia de esta API son 5 llamadas por minuto y 20 llamadas por hora.

Dirección URL 2.3

GET /api/machines/BaselineComplianceAssessmentExport

2.4 Parámetros

sasValidHours: el número de horas para las que son válidas las direcciones URL de descarga. El máximo es de 6 horas.

2.5 Propiedades (a través de archivos)

Nota:

Los archivos están comprimidos con GZIP & en formato JSON multilínea.
Las direcciones URL de descarga son válidas durante 1 hora a menos que se use el sasValidHours parámetro .
Para maximizar las velocidades de descarga, asegúrese de que está descargando los datos de la misma región Azure donde residen los datos.
Es posible que se devuelvan algunas columnas adicionales en la respuesta. Estas columnas son temporales y pueden quitarse. Use solo las columnas documentadas.

Propiedad (ID)	Tipo de datos	Description
Exportación de archivos	array[string]	Una lista de direcciones URL de descarga para los archivos que contienen la instantánea actual de la organización.
GeneratedTime	Cadena	Hora en que se generó la exportación.

2.6 Ejemplos

2.6.1 Ejemplo de solicitud

GET https://api.security.microsoft.com/api/machines/BaselineComplianceAssessmentExport

Ejemplo de respuesta 2.6.2

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",
    "exportFiles":
    [
    "https://tvmexportexternalstgeus.blob.core.windows.net/temp-1ebd3d09-d06a-4aad-ab80-ebc536cec61c/2021-12-22/0500/BaselineAssessmentExport/json/OrgId= OrgId=<Org Id>/_RbacGroupId=<Rbac Group Id>/part-00000-c09dfd00-2278-4735-b23a-71733751fcbc.c000.json.gz?sv=ABCD",
   "https://tvmexportexternalstgeus.blob.core.windows.net/temp-1ebd3d09-d06a-4aad-ab80-ebc536cec61c/2021-12-22/0500/BaselineAssessmentExport/json/OrgId=<Org Id>/_RbacGroupId=<Rbac Group Id>/part-00001-c09dfd00-2278-4735-b23a-71733751fcbc.c000.json.gz?sv= ABCD",
    ],
    "generatedTime": "2021-01-11T11:01:00Z"
}

Vea también

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-11-25

Compartir a través de

Exportación de la evaluación de líneas base de seguridad por dispositivo

1. Exportación de la evaluación de líneas base de seguridad (respuesta JSON)

Descripción del método de API 1.1

1.2 Permisos

1.3 Limitaciones

1.4 Parámetros

1.5 Solicitud HTTP

Propiedades 1.6 (respuesta JSON)

Ejemplo 1.7

1.7.1 Ejemplo de solicitud

Ejemplo de respuesta 1.7.2

2. Exportación de la evaluación de líneas base de seguridad (a través de archivos)

2.1 Descripción del método de API

2.2 Limitaciones

Dirección URL 2.3

2.4 Parámetros

2.5 Propiedades (a través de archivos)

2.6 Ejemplos

2.6.1 Ejemplo de solicitud

Ejemplo de respuesta 2.6.2

Vea también

Comentarios

Recursos adicionales