Få en åtgärdsaktivitet med ID

Artikel
02/20/2025

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
ina.api.security.microsoft.com

API-beskrivning

Returnerar information för den angivna reparationsaktiviteten. Visar samma kolumner som Hämta all reparationsaktivitet", men returnerar endast resultat för den angivna reparationsaktiviteten.

Läs mer om reparationsaktiviteter.

Lista en angiven åtgärdsaktivitet för (ID)

URL: GET: /api/remediationTasks/{id}

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.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	Noll
completerId	Sträng	Om reparationsaktiviteten slutfördes manuellt av någon innehåller den här kolumnen deras objekt-ID	Noll
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	Noll
recommendedVendor	Sträng	Rekommenderad leverantör att uppgradera till	Noll
recommendedVersion	Sträng	Rekommenderad version att uppdatera/uppgradera till	Noll
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	Noll
Scid	Sträng	SCID för den relaterade säkerhetsrekommendationsen	Noll
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	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/03942ef5-aecb-4c6e-b555-d6a97013844c

Svarsexempel

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks/$entity",
    "id": "03942ef5-aecb-4c6e-b555-d6a97013844c",
    "title": "Update Microsoft Silverlight",
    "createdOn": "2021-02-10T13:20:36.4718166Z",
    "requesterId": "65548a1d-efo0-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