Exportera programinventeringsutvärdering utan produktkod per enhet

Artikel
04/27/2024

Gäller för:

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Det här API:et returnerar alla data för installerad programvara som inte har en Common Platform Enumeration (CPE) per enhet. Informationen som returneras av det här API:et, tillsammans med den information som returneras av API:et För utvärdering av programinventering för programvara som har en CPE, ger dig fullständig insyn i programvaran som är installerad i organisationen och de enheter som den är installerad på.

Obs!

Programvaruprodukter utan CPE stöds inte av sårbarhetshantering. De visas på sidan för programvaruinventering, men eftersom processorer används av sårbarhetshantering för att identifiera programvaran och eventuella sårbarheter, information som, kryphål, antal exponerade enheter och svagheter kommer inte att vara tillgängliga för dem. Mer information finns i Programvaruinventering.

Olika API-anrop hämtar olika typer av data. Eftersom mängden data kan vara stor finns det två sätt att hämta dem:

Exportera JSON-svar för utvärdering av programvaruinventering för icke-produktkod API:et hämtar alla data i din organisation som Json-svar. Den här metoden passar bäst för små organisationer med mindre än 100 K-enheter. Svaret är sidnumrerat, så du kan använda fältet @odata.nextLink från svaret för att hämta nästa resultat.
Exportera programinventeringsutvärdering utan produktkod via filer Med den här API-lösningen kan du hämta större mängder data snabbare och mer tillförlitligt. Därför rekommenderas det för stora organisationer med fler än 100 K-enheter. Det här API:et hämtar alla data i din organisation som nedladdningsfiler. Svaret innehåller URL:er för att ladda ned alla data från Azure Storage. Med det här API:et kan du ladda ned alla dina data från Azure Storage på följande sätt:
- Anropa API:et för att hämta en lista över nedladdnings-URL:er med alla organisationsdata.
- Ladda ned alla filer med hjälp av nedladdnings-URL:er och bearbeta data som du vill.

Data som samlas in (antingen med Json-svar eller via filer) är den aktuella ögonblicksbilden av det aktuella tillståndet. Den innehåller inte historiska data. För att samla in historiska data måste kunderna spara data i sina egna datalagringar.

Obs!

Om inget annat anges är alla exportutvärderingsmetoder som anges fullständig export och per enhet (kallas även per enhet).

1. Exportera programinventeringsutvärdering utan produktkod (JSON-svar)

Beskrivning av 1.1 API-metod

Det här API-svaret innehåller alla data för installerad programvara som inte har en Common Platform Enumeration (CPE) per enhet. Returnerar en tabell med en post för varje unik kombination av DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.

Begränsningar

Maximal sidstorlek är 200 000.
Frekvensbegränsningar för det här API:et är 30 anrop per minut och 1 000 anrop per timme.

1.2 Behörigheter

En av följande behörigheter krävs för att anropa det här API:et. Mer information om hur du väljer behörigheter finns i Använda Microsoft Defender för Endpoint-API:er.

Behörighetstyp	Behörighet	Visningsnamn för behörighet
Program	Software.Read.All	"Läs programvaruinformation om hot- och sårbarhetshantering"
Delegerat (arbets- eller skolkonto)	Software.Read	"Läs programvaruinformation om hot- och sårbarhetshantering"

1.3 URL

GET /api/machines/SoftwareInventoryNoProductCodeByMachine

1.4 Parametrar

pageSize (standard = 50 000): Antal resultat som svar.
$top: Antal resultat som ska returneras (returneras @odata.nextLink inte och hämtar därför inte alla data)

1.5 Egenskaper

Obs!

Varje post är cirka 0,5 KB data. Du bör ta hänsyn till detta när du väljer rätt pageSize-parameter åt dig.
Egenskaperna som definieras i följande tabell visas i alfabetisk ordning efter egenskaps-ID. När du kör det här API:et returneras inte nödvändigtvis de resulterande utdata i samma ordning som anges i den här tabellen.
Vissa ytterligare kolumner kan returneras i svaret. Dessa kolumner är tillfälliga och kan tas bort. Använd endast de dokumenterade kolumnerna.

Egenskap (ID)	Datatyp	Beskrivning
Deviceid	sträng	Unik identifierare för enheten i tjänsten.
DeviceName	sträng	Fullständigt kvalificerat domännamn (FQDN) för enheten.
OSPlatform	sträng	Plattform för operativsystemet som körs på enheten. Dessa är specifika operativsystem med variationer inom samma familj, till exempel Windows 10 och Windows 11. Mer information finns i Operativsystem, plattformar och funktioner som stöds .
RbacGroupName	sträng	Den rollbaserade åtkomstkontrollgruppen (RBAC). Om den här enheten inte har tilldelats någon RBAC-grupp blir värdet "Ej tilldelad". Om organisationen inte innehåller några RBAC-grupper blir värdet "Ingen".
RbacGroupId	sträng	Grupp-ID för rollbaserad åtkomstkontroll (RBAC).
SoftwareLastSeenTimestamp	sträng	Senaste gången den här programvaran visades på enheten.
SoftwareName	sträng	Namnet på programvaruprodukten.
SoftwareVendor	sträng	Namnet på programvaruleverantören.
SoftwareVersion	sträng	Versionsnummer för programvaruprodukten.

1.6 Exempel

1.6.1 Exempel på begäran

https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryNoProductCodeByMachine?pageSize=3  &sinceTime=2021-05-19

1.6.2 Svarsexempel

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.AssetNonCpeSoftware)",
    "value": [
        {
           "deviceId": "1234512345123451234512345",
            "rbacGroupId": 11,
            "rbacGroupName": "London",
            "deviceName": "Device1",
            "osPlatform": "Windows11",
            "softwareVendor": "microsoft",
            "softwareName": "vs_communitymsi",
            "softwareVersion": "11.11.31111.1",
            "softwareLastSeenTimestamp": "2021-01-30 11:31:12.271"
        },
        {
            "deviceId": "232323232323232322323232323",
            "rbacGroupId": 23,
            "rbacGroupName": "Tokyo",
            "deviceName": "Device23",
            "osPlatform": "Windows10",
            "softwareVendor": "intel",
            "softwareName": "intel®_software_installer",
            "softwareVersion": "22.20.2.2",
            "softwareLastSeenTimestamp": "2022-05-30 15:35:12.271"
        },
        {
            "deviceId": "6565656565",
            "rbacGroupId": 65,
            "rbacGroupName": "Center",
            "deviceName": "Device56",
            "osPlatform": "Windows10",
            "softwareVendor": "Lob Apps",
            "softwareName": "Headtrax",
            "softwareVersion": "60.273.3",
            "softwareLastSeenTimestamp": "2022-05-05 15:35:12.271"
        },
    ],
        "@odata.nextLink": "https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryNoProductCodeByMachine?pagesize=3%20%20&sincetime=2021-05-19&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMi0wNS0zMC8xMTAxLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

2. Exportera programinventeringsutvärdering utan produktkod (via filer)

Beskrivning av 2.1 API-metod

2.1.1 Begränsningar

Hastighetsbegränsningar för det här API:et är 5 anrop per minut och 20 anrop per timme.

2.2 Behörigheter

En av följande behörigheter krävs för att anropa det här API:et. Mer information om hur du väljer behörigheter finns i Använda Microsoft Defender för Endpoint-API:er.

Behörighetstyp	Behörighet	Visningsnamn för behörighet
Program	Software.Read.All	"Läs programvaruinformation om hot- och sårbarhetshantering"
Delegerat (arbets- eller skolkonto)	Software.Read	"Läs programvaruinformation om hot- och sårbarhetshantering"

2.3 URL

GET /api/machines/SoftwareInventoryNonCpeExport

Parametrar

sasValidHours: Antalet timmar som nedladdnings-URL:erna är giltiga i (högst 24 timmar)

2.5 Egenskaper

Obs!

Filerna är gzip-komprimerade & i JSON-format med flera ledningar.
Nedladdnings-URL:erna är endast giltiga i 3 timmar. Annars kan du använda parametern .
För maximal nedladdningshastighet för dina data kan du se till att du laddar ned från samma Azure-region som dina data finns i.

Egenskap (ID)	Datatyp	Beskrivning	Exempel på ett returnerat värde
Exportera filer	array[string]	En lista över nedladdnings-URL:er för filer som innehåller den aktuella ögonblicksbilden av organisationen	"[Https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"]
GeneratedTime	sträng	Tiden då exporten genererades.	2021-05-20T08:00:00Z

2.6 Exempel

2.6.1 Exempel på begäran

GET https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryNonCpeExport

2.6.2 Svarsexempel

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",
    "exportFiles": [
        "https://tvmexportexternalprdcanc.blob.core.windows.net/temp-ffd80447-7b3d-4ad2-b366-f0979b129662/2022-05-30/1101/NonCpeSoftwareInventory/json/OrgId=47d41a0c-188d-46d3-bbea-a93dbc0bfcaa/_RbacGroupId=1/part-00337-5e15412b-5c85-4896-ac60-b7b3ab8da096.c000.json.gz?sv=2020-08-04&st=2022-05-30T13%3A41%3A59Z&se=2022-05-30T16%3A41%3A59Z&sr=b&sp=r&sig=aHnmuOKlIvpR0PsdamYfmCCDZ1nhpuXBzK2%2FkJ9xTpg%3D",
        "https://tvmexportexternalprdcanc.blob.core.windows.net/temp-ffd80447-7b3d-4ad2-b366-f0979b129662/2022-05-30/1101/NonCpeSoftwareInventory/json/OrgId=47d41a0c-188d-46d3-bbea-a93dbc0bfcaa/_RbacGroupId=1/part-00338-5e15412b-5c85-4896-ac60-b7b3ab8da096.c000.json.gz?sv=2020-08-04&st=2022-05-30T13%3A41%3A59Z&se=2022-05-30T16%3A41%3A59Z&sr=b&sp=r&sig=0fQg%2Ft469x26KvPLmvctLl0g6DC38CNM3lXYi9dnFfo%3D",
        "https://tvmexportexternalprdcanc.blob.core.windows.net/temp-ffd80447-7b3d-4ad2-b366-f0979b129662/2022-05-30/1101/NonCpeSoftwareInventory/json/OrgId=47d41a0c-188d-46d3-bbea-a93dbc0bfcaa/_RbacGroupId=1/part-00339-5e15412b-5c85-4896-ac60-b7b3ab8da096.c000.json.gz?sv=2020-08-04&st=2022-05-30T13%3A41%3A59Z&se=2022-05-30T16%3A41%3A59Z&sr=b&sp=r&sig=P6HGHoLXXipMauBpLueoQVrwHL7qmvLoCjcij6ERx8o%3D",
        "https://tvmexportexternalprdcanc.blob.core.windows.net/temp-ffd80447-7b3d-4ad2-b366-f0979b129662/2022-05-30/1101/NonCpeSoftwareInventory/json/OrgId=47d41a0c-188d-46d3-bbea-a93dbc0bfcaa/_RbacGroupId=1/part-00340-5e15412b-5c85-4896-ac60-b7b3ab8da096.c000.json.gz?sv=2020-08-04&st=2022-05-30T13%3A41%3A59Z&se=2022-05-30T16%3A41%3A59Z&sr=b&sp=r&sig=VnpVct%2F8vdiIFTf2xXP9DF7ngWv1Zqew30q2jBPVghg%3D",
        "https://tvmexportexternalprdcanc.blob.core.windows.net/temp-ffd80447-7b3d-4ad2-b366-f0979b129662/2022-05-30/1101/NonCpeSoftwareInventory/json/OrgId=47d41a0c-188d-46d3-bbea-a93dbc0bfcaa/_RbacGroupId=1/part-00341-5e15412b-5c85-4896-ac60-b7b3ab8da096.c000.json.gz?sv=2020-08-04&st=2022-05-30T13%3A41%3A59Z&se=2022-05-30T16%3A41%3A59Z&sr=b&sp=r&sig=GY0zxMfEmr9v9fZBWYyKEtT2k%2F0ELQIlOP0ct%2B6SdGU%3D",
    ],
    "generatedTime": "2022-05-30T11:01:00Z"
}

Se även

Andra relaterade

Tips

Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender för Endpoint Tech Community.

Dela via

Exportera programinventeringsutvärdering utan produktkod per enhet

1. Exportera programinventeringsutvärdering utan produktkod (JSON-svar)

Beskrivning av 1.1 API-metod

Begränsningar

1.2 Behörigheter

1.3 URL

1.4 Parametrar

1.5 Egenskaper

1.6 Exempel

1.6.1 Exempel på begäran

1.6.2 Svarsexempel

2. Exportera programinventeringsutvärdering utan produktkod (via filer)

Beskrivning av 2.1 API-metod

2.1.1 Begränsningar

2.2 Behörigheter

2.3 URL

Parametrar

2.5 Egenskaper

2.6 Exempel

2.6.1 Exempel på begäran

2.6.2 Svarsexempel

Se även

Feedback

Ytterligare resurser