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

Článek
08/14/2024

Platí pro:

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

Chcete si prožít správu ohrožení zabezpečení v programu Microsoft Defender? Přečtěte si další informace o tom, jak se můžete zaregistrovat ke zkušební verzi Public Preview správy ohrožení zabezpečení v programu Microsoft Defender.

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 programu 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
ina.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)

Adresa 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ě toho, jak zvolit oprávnění, najdete v tématu Použití rozhraní MICROSOFT Defender for Endpoint API.

Typ oprávnění	Povolení	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.	Nula
completerId	String	Pokud někdo ručně dokončil aktivitu nápravy, obsahuje tento sloupec ID objektu.	Nula
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	Datum a čas	Č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	Datum a čas	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 Servery", "Windows 11", "Windows 10" ]
doporučenýprogram	String	Doporučený program pro upgrade na	Nula
recommendedVendor	String	Doporučený dodavatel pro upgrade na	Nula
doporučenáverze	String	Doporučená verze pro aktualizaci nebo upgrade na	Nula
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	Nula
Scid	String	SCID souvisejícího doporučení zabezpečení	Nula
Stav	String	Stav aktivity nápravy (Aktivní/Dokončeno)	Aktivní
statusLastModifiedOn	Datum a čas	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? Spojte se s komunitou zabezpečení Microsoftu v naší technické komunitě: Technická komunita Microsoft Defenderu for Endpoint.

Sdílet prostřednictvím