Api de inventario de software de lista

Descripción de la API

Recupera el inventario de software de la organización.

Admite consultas OData V4. Operadores compatibles con OData:

• $filter en las propiedades siguientes:
  • id
  • name
  • vendor
• $top con un valor máximo de 10 000.
• $skip

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

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	Software.Read.All	"Leer la información del software de administración de amenazas y vulnerabilidades"
Delegado (cuenta profesional o educativa)	Software.Read	"Leer la información del software de administración de amenazas y vulnerabilidades"

Solicitud HTTP

GET /api/Software

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 200 OK con el inventario de software en el cuerpo.

Ejemplo

Ejemplo de solicitud

Aquí tiene un ejemplo de la solicitud.

GET https://api.security.microsoft.com/api/Software

Ejemplo de respuesta

Este es un ejemplo de la respuesta:

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
    "value": [
            {
                "id": "microsoft-_-edge",
                "name": "edge",
                "vendor": "microsoft",
                "weaknesses": 467,
                "publicExploit": true,
                "activeAlert": false,
                "exposedMachines": 172,
                "impactScore": 2.39947438
            }
            ...
        ]
}