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

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.