Získání jedné aktivity nápravy podle ID

Článek
05/03/2024

Platí pro:

Chcete vyzkoušet Defender pro Endpoint? Zaregistrujte se k bezplatné zkušební verzi.

Chcete si Microsoft Defender Správa zranitelností prožít? Přečtěte si další informace o tom, jak se můžete zaregistrovat ke zkušební verzi Microsoft Defender Správa zranitelností Public Preview.

Důležité

Některé informace v tomto článku se týkají předvydaného produktu, který může být před komerčním vydáním podstatně změněn. Společnost Microsoft neposkytuje na zde uvedené informace žádné záruky, vyjádřené ani předpokládané.

Poznámka

Pokud jste zákazníkem státní správy USA, použijte identifikátory URI uvedené v Microsoft Defender for Endpoint pro zákazníky státní správy USA.

Tip

Pro lepší výkon můžete použít server blíže k vašemu geografickému umístění:

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

Popis rozhraní API

Vrátí informace pro zadanou aktivitu nápravy. Zobrazí stejné sloupce jako Get all remediation activity" (Získat veškerou nápravnou aktivitu), ale vrátí výsledky pouze pro jednu zadanou aktivitu nápravy.

Přečtěte si další informace o nápravě.

Výpis zadané aktivity nápravy pro (ID)

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

Oprávnění

K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění. Další informace, včetně postupu výběru oprávnění, najdete v tématu Použití rozhraní MICROSOFT DEFENDER FOR ENDPOINT API.

Typ oprávnění	Oprávnění	Zobrazovaný název oprávnění
Application	RemediationTasks.Read.All	"Přečtěte si informace o ohrožení zabezpečení správy hrozeb a ohrožení zabezpečení"
Delegovaný (pracovní nebo školní účet)	RemediationTask.Read.Read	"Přečtěte si informace o ohrožení zabezpečení správy hrozeb a ohrožení zabezpečení"

Vlastnosti

Vlastnost (ID)	Datový typ	Popis	Příklad vrácené hodnoty
Kategorie	String	Kategorie aktivity nápravy (konfigurace softwaru nebo zabezpečení)	Software
completerEmail	String	Pokud aktivitu nápravy někdo ručně dokončil, obsahuje tento sloupec jeho e-mail.	Null
completerId	String	Pokud někdo ručně dokončil aktivitu nápravy, obsahuje tento sloupec ID objektu.	Null
dokončeníMethod	String	Nápravnou aktivitu může dokončit "automaticky" (pokud jsou všechna zařízení opravena) nebo "ručně" osobou, která vybere možnost Označit jako dokončené.	Automatické
createdOn	Datetime	Čas vytvoření této nápravné aktivity	2021-01-12T18:54:11.5499478Z
Popis	String	Popis této nápravné aktivity	Aktualizujte Microsoft Silverlight na novější verzi, abyste mohli zmírnit známé chyby zabezpečení ovlivňující vaše zařízení.
dueOn	Datetime	Termín splnění, který tvůrce nastavil pro tuto nápravnou aktivitu	2021-01-13T00:00:00Z
fixedDevices		Počet zařízení, která byla opravena	2
ID	String	ID této nápravné aktivity	097d9735-5479-4899-b1b7-77398899df92
id názvu	String	Název souvisejícího produktu	Microsoft Silverlight
Priority (Priorita)	String	Priorita, která tvůrce nastavil pro tuto nápravnou aktivitu (Vysoká\Střední\Nízká)	High (Vysoká)
Productid	String	ID souvisejícího produktu	microsoft-_-silverlight
productivityImpactRemediationType	String	Několik změn konfigurace je možné vyžadovat jenom u zařízení, která nemají vliv na uživatele. Tato hodnota označuje výběr mezi "všechna vystavená zařízení" nebo "pouze zařízení bez dopadu na uživatele".	AllExposedAssets
rbacGroupNames	String	Související názvy skupin zařízení	[ "Windows Servers", "Windows 11", "Windows 10" ]
doporučenýprogram	String	Doporučený program pro upgrade na	Null
recommendedVendor	String	Doporučený dodavatel pro upgrade na	Null
doporučenáverze	String	Doporučená verze pro aktualizaci nebo upgrade na	Null
relatedComponent	String	Související komponenta této nápravné aktivity (podobná související komponentě pro doporučení zabezpečení)	Microsoft Silverlight
requesterEmail	String	E-mailová adresa tvůrce	globaladmin@UserName.contoso.com
requesterId	String	ID objektu tvůrce	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	String	Poznámky (volný text), které tvůrce přidal pro tuto nápravnou aktivitu	Null
Scid	String	SCID souvisejícího doporučení zabezpečení	Null
Stav	String	Stav aktivity nápravy (Aktivní/Dokončeno)	Aktivní
statusLastModifiedOn	Datetime	Datum, kdy bylo pole stavu aktualizováno	2021-01-12T18:54:11.5499487Z
targetDevices	Dlouhé	Počet vystavených zařízení, na která se tato náprava vztahuje	43
Title	String	Název této nápravné aktivity	Microsoft Silverlight
Typ	String	Typ nápravy	Aktualizovat
vendorId	String	Název souvisejícího dodavatele	Microsoft

Příklad

Příklad požadavku

GET https://api.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c

Příklad odpovědi

{
    "@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
}

Viz také

Tip

Chcete se dozvědět více? Engage s komunitou Microsoft Security v naší technické komunitě: Microsoft Defender for Endpoint Tech Community.

Sdílet prostřednictvím