Lista alla åtgärdsaktiviteter

Gäller för:

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

Viktigt

En del information gäller förinstallerad produkt som kan ha ändrats mycket innan den släpps kommersiellt. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, med avseende på den information som anges här.

Anteckning

Om du är myndighetskund i USA kan du använda de URI:er som visas i Microsoft Defender för Slutpunkt för kunder inom myndigheter i USA.

Tips

För bättre prestanda kan du använda servern närmare din geografiska plats:

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

API-beskrivning

Returnerar information om alla åtgärder.

Läs mer om åtgärder.

URL: HÄMTA: /api/remediationTasks
Stöder OData V4-frågor.
Operatorer som stöds av OData:
$filter på: createdon och status egenskaper.
$top med maxvärdet 10 000.
$skip.
Se exempel på OData-frågor med Microsoft Defender för Slutpunkt.

Behörigheter

En av följande behörigheter krävs för att anropa detta API. Mer information, inklusive hur du väljer behörigheter, finns i Använda Microsoft Defender för slutpunkts-API:er för mer information.

Behörighetstyp Behörighet Visningsnamn för behörighet
Program RemediationTasks.Read.All 'Läsa sårbarhetsinformation om hot och sårbarhetshantering'
Delegerat (arbets- eller skolkonto) RemediationTask.Read 'Läsa sårbarhetsinformation om hot och sårbarhetshantering'

Egenskaper

Egenskap (ID) Datatyp Beskrivning Exempel på ett returnerat värde
Kategori Sträng Kategori för åtgärdsaktiviteten (konfiguration av programvara/säkerhet) Programvara
completerEmail Sträng Om åtgärdsaktiviteten har slutförts manuellt av någon innehåller den här kolumnen deras e-postadress Null
completerId Sträng Om åtgärdsaktiviteten har slutförts manuellt av någon innehåller den här kolumnen deras objekt-ID Null
completionMethod Sträng En åtgärdsaktivitet kan slutföras "automatiskt" (om alla enheter är korrigerade) eller "manuellt" av en person som väljer "markera som slutförd" Automatisk
createdOn DateTime Tidpunkten då den här åtgärdsaktiviteten skapades 2021-01-12T18:54:11.5499478Z
Beskrivning Sträng Beskrivning av den här åtgärdsaktiviteten Uppdatera Microsoft Silverlight till en senare version för att minimera kända säkerhetsproblem som påverkar dina enheter.
dueOn DateTime Förfallodatum som skapare uppsättningen för den här åtgärdsaktiviteten 2021-01-13T00:00:00Z
fixedDevices . Antalet enheter som har åtgärdats 2
ID Sträng ID för den här åtgärdsaktiviteten 097d9735-5479-4899-b1b7-77398899df92
nameId Sträng Relaterade produktnamn Microsoft Silverlight
Prioritet Sträng Prioritet för skaparuppsättningen för den här åtgärdsaktiviteten (Hög\Medel\Låg) Högsta
productId Sträng Relaterade produkt-ID microsoft-_-silverlight
productivityImpactRemediationType Sträng Några konfigurationsändringar kan endast begäras för enheter som inte påverkar användarna. Det här värdet anger valet mellan "alla exponerade enheter" eller "endast enheter utan påverkan från användare". AllExposedAssets
rbacGroupNames Sträng Gruppnamn för relaterade enheter [ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram Sträng Rekommenderat program att uppgradera till Null
recommendedVendor Sträng Rekommenderad leverantör att uppgradera till Null
recommendedVersion Sträng Rekommenderad version att uppdatera/uppgradera till Null
relatedComponent Sträng Relaterad komponent i den här åtgärdsaktiviteten (som liknar den relaterade komponenten för en säkerhetsrekommendationer) Microsoft Silverlight
requesterEmail Sträng E-postadress skapad globaladmin@UserName.contoso.com
requesterId Sträng Creator-objekt-ID r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes Sträng Anteckningarna (fri text) som skaparen har lagt till för den här åtgärdsaktiviteten Null
Scid Sträng SCID för relaterad säkerhetsrekommendationer Null
Status Sträng Status för åtgärdsaktivitet (Aktiv/slutförd) Aktiv
statusLastModifiedOn DateTime Datum när statusfältet uppdaterades 2021-01-12T18:54:11.5499487Z
targetDevices Long Antal exponerade enheter som denna åtgärd gäller för 43
Rubrik Sträng Rubrik för den här åtgärdsaktiviteten Uppdatera Microsoft Silverlight
Typ Sträng Åtgärdstyp Update
vendorId Sträng Relaterade leverantörsnamn Microsoft

Exempel

Exempel på förfrågan

GET https://api-luna.securitycenter.windows.com/api/remediationtasks/

Svarsexempel

{
    "@odata.context": "https://wpatdadi-luna-stg.cloudapp.net/api/$metadata#RemediationTasks",
    "value": [
        {
            "id": "03942ef5-aewb-4w6e-b555-d6a97013844w",
            "title": "Update Microsoft Silverlight",
            "createdOn": "2021-02-10T13:20:36.4718166Z",
            "requesterId": "65548a1d-ef00-4a7a-8d19-1b967b5c36f4",
            "requesterEmail": "user1@contoso.com",
            "status": "Active",
            "statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z",
            "description": "Update Silverlight to a later version  to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.",
            "relatedComponent": "Microsoft Silverlight",
            "targetDevices": 18511,
            "rbacGroupNames": [
                "UnassignedGroup",
                "hhh"
            ],
            "fixedDevices": 2866,
            "requesterNotes": "test",
            "dueOn": "2021-02-11T00:00:00Z",
            "category": "Software",
            "productivityImpactRemediationType": null,
            "priority": "Medium",
            "completionMethod": null,
            "completerId": null,
            "completerEmail": null,
            "scid": null,
            "type": "Update",
            "productId": "microsoft-_-silverlight",
            "vendorId": "microsoft",
            "nameId": "silverlight",
            "recommendedVersion": null,
            "recommendedVendor": null,
            "recommendedProgram": null
        }
    ]
}

Se även