API di inventario software elencoList software inventory API

Si applica a: Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

Nota

Se sei un cliente us government, usa gli URI elencati in Microsoft Defender for Endpoint per i clienti del governo statunitense.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Suggerimento

Per ottenere prestazioni migliori, è possibile utilizzare il server più vicino alla posizione geografica:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

Recupera l'inventario software dell'organizzazione.Retrieves the organization software inventory.

AutorizzazioniPermissions

Per chiamare questa API è necessaria una delle autorizzazioni seguenti.One of the following permissions is required to call this API. Per altre informazioni, inclusa la scelta delle autorizzazioni, vedi Usare Le API di Microsoft Defender per endpoint per i dettagli.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Tipo di autorizzazionePermission type AutorizzazionePermission Nome visualizzato autorizzazionePermission display name
ApplicazioneApplication Software.Read.AllSoftware.Read.All "Leggere informazioni sul software di gestione delle minacce e delle vulnerabilità"'Read Threat and Vulnerability Management Software information'
Delegato (account aziendale o dell'istituto di istruzione)Delegated (work or school account) Software.ReadSoftware.Read "Leggere informazioni sul software di gestione delle minacce e delle vulnerabilità"'Read Threat and Vulnerability Management Software information'

Richiesta HTTPHTTP request

GET /api/Software

Intestazioni di richiestaRequest headers

NameName TipoType DescrizioneDescription
AutorizzazioneAuthorization StringaString Bearer {token}.Bearer {token}. Obbligatorio.Required.

Corpo della richiestaRequest body

VuotoEmpty

RispostaResponse

Se ha esito positivo, questo metodo restituisce 200 OK con l'inventario software nel corpo.If successful, this method returns 200 OK with the software inventory in the body.

EsempioExample

RichiestaRequest

Ecco un esempio della richiesta.Here is an example of the request.

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

RispostaResponse

Ecco un esempio di risposta.Here is an example of the response.

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