Skip to content

Latest commit

 

History

History
107 lines (77 loc) · 3.03 KB

get-software-ver-distribution.md

File metadata and controls

107 lines (77 loc) · 3.03 KB
Raw
title description ms.service ms.author author ms.localizationpriority manager audience ms.collection ms.topic ms.subservice ms.custom search.appverid ms.date
List software version distribution
Retrieves a list of your organization's software version distribution
defender-endpoint
siosulli
siosulli
medium
deniseb
ITPro
m365-security
tier3
must-keep
reference
reference
api
met150
12/18/2020

List software version distribution

[!INCLUDE Microsoft Defender XDR rebranding]

Applies to:

Want to experience Microsoft Defender for Endpoint? Sign up for a free trial.

[!includeMicrosoft Defender for Endpoint API URIs for US Government]

[!includeImprove request performance]

[!includePrerelease information]

Retrieves a list of your organization's software version distribution.

Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Permission type Permission Permission display name
Application Software.Read.All 'Read Threat and Vulnerability Management Software information'
Delegated (work or school account) Software.Read 'Read Threat and Vulnerability Management Software information'

HTTP request

GET /api/Software/{Id}/distributions

Request headers

Name Type Description
Authorization String Bearer {token}.Required.

Request body

Empty

Response

If successful, this method returns 200 OK with a list of software distributions data in the body.

Example

Request example

Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/Software/microsoft-_-edge/distributions

Response example

Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Distributions",
    "value": [
        {
            "version": "11.0.17134.1039",
            "installations": 1,
            "vulnerabilities": 11
        },
        {
            "version": "11.0.18363.535",
            "installations": 750,
            "vulnerabilities": 0
        }
        ...
    ]
}

Related topics