Få en åtgärdsaktivitet med ID
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 för den angivna åtgärdsaktiviteten. Visar samma kolumner som Hämta all åtgärdsaktivitet" men returnerar endast resultat för den angivna åtgärdsaktiviteten.
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 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.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", "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 | 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/03942ef5-aecb-4c6e-b555-d6a97013844c
Svarsexempel
{
"@odata.context": "https://wpatdadi-luna-stg.cloudapp.net/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
}