Lista alla åtgärdsaktiviteter

Artikel
05/03/2024

Gäller för:

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

Vill du uppleva Microsoft Defender – hantering av säkerhetsrisker? Läs mer om hur du kan registrera dig för Microsoft Defender – hantering av säkerhetsrisker utvärderingsversion av den offentliga förhandsversionen.

Viktigt

Viss information i den här artikeln gäller en förhyrd produkt som kan ändras avsevärt innan den släpps kommersiellt. Microsoft lämnar inga garantier, uttryckta eller underförstådda, med avseende på den information som tillhandahålls här.

Obs!

Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.

Tips

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

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com

API-beskrivning

Returnerar information om alla reparationsaktiviteter.

Läs mer om reparationsaktiviteter.

URL: GET: /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 Endpoint.

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	RemediationTasks.Read.All	"Läs information om sårbarhetshantering för hot och sårbarhetshantering"
Delegerat (arbets- eller skolkonto)	RemediationTask.Read	"Läs information om sårbarhetshantering för hot och sårbarhetshantering"

Egenskaper

Egenskap (ID)	Datatyp	Beskrivning	Exempel på ett returnerat värde
Kategori	Sträng	Åtgärdsaktivitetens kategori (programvaru-/säkerhetskonfiguration)	Programvara
completerEmail	Sträng	Om reparationsaktiviteten slutfördes manuellt av någon innehåller den här kolumnen deras e-post	Null
completerId	Sträng	Om reparationsaktiviteten slutfördes 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 korrigeras) eller "manuellt" av en person som väljer "markera som slutförd"	Automatisk
createdOn	Datetime	Tiden då den här reparationsaktiviteten skapades	2021-01-12T18:54:11.5499478Z
Beskrivning	Sträng	Beskrivning av den här reparationsaktiviteten	Uppdatera Microsoft Silverlight till en senare version för att minska kända sårbarheter som påverkar dina enheter.
dueOn	Datetime	Förfallodatum som skaparen har angett för den här reparationsaktiviteten	2021-01-13T00:00:00Z
fixedDevices	.	Antalet enheter som har åtgärdats	2
ID	Sträng	ID för den här reparationsaktiviteten	097d9735-5479-4899-b1b7-77398899df92
nameId	Sträng	Relaterat produktnamn	Microsoft Silverlight
Prioritet	Sträng	Prioritera den skapare som angetts för den här reparationsaktiviteten (High\Medium\Low)	Högsta
Produktionen	Sträng	Relaterat produkt-ID	microsoft-_-silverlight
productivityImpactRemediationType	Sträng	Några konfigurationsändringar kan bara 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 användarpåverkan".	AllExposedAssets
rbacGroupNames	Sträng	Relaterade enhetsgruppsnamn	[ "Windows-servrar", "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 reparationsaktiviteten (liknar den relaterade komponenten för en säkerhetsrekommendation)	Microsoft Silverlight
requesterEmail	Sträng	Skaparens e-postadress	globaladmin@UserName.contoso.com
requesterId	Sträng	Skaparobjekt-ID	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Sträng	Anteckningarna (fritext) som skaparen lade till för den här reparationsaktiviteten	Null
Scid	Sträng	SCID för den relaterade säkerhetsrekommendationsen	Null
Status	Sträng	Status för åtgärdsaktivitet (aktiv/slutförd)	Aktiv
statusLastModifiedOn	Datetime	Datum då statusfältet uppdaterades	2021-01-12T18:54:11.5499487Z
targetDevices	Lång	Antal exponerade enheter som den här reparationen gäller för	43
Rubrik	Sträng	Rubrik för den här reparationsaktiviteten	Uppdatera Microsoft Silverlight
Typ	Sträng	Reparationstyp	Update
vendorId	Sträng	Relaterat leverantörsnamn	Microsoft

Exempel

Exempel på begäran

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

Svarsexempel

{
    "@odata.context": "https://api.securitycenter.windows.com/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