Pobierz jedną akcję korygującą według identyfikatora

Artykuł
08/14/2024

Dotyczy:

Chcesz poznać usługę ochrony punktu końcowego w usłudze Microsoft Defender? Utwórz konto bezpłatnej wersji próbnej.

Chcesz skorzystać z zarządzania lukami w zabezpieczeniach usługi Microsoft Defender? Dowiedz się więcej o tym, jak można zarejestrować się w publicznej wersji próbnej usługi Microsoft Defender Vulnerability Management w wersji zapoznawczej.

Ważna

Niektóre informacje zawarte w tym artykule odnoszą się do wersji wstępnej produktu, który może zostać znacznie zmodyfikowany do czasu wydania wersji komercyjnej. Firma Microsoft nie udziela żadnych gwarancji, wyrażonych ani dorozumianych, w odniesieniu do informacji podanych tutaj.

Uwaga

Jeśli jesteś klientem rządowym USA, użyj identyfikatorów URI wymienionych w usłudze Microsoft Defender for Endpoint dla klientów rządowych USA.

Porada

Aby uzyskać lepszą wydajność, możesz użyć serwera bliżej lokalizacji geograficznej:

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

Opis interfejsu API

Zwraca informacje dotyczące określonego działania korygowania. Przedstawia te same kolumny co działanie Pobierz wszystkie korygowanie", ale zwraca wyniki tylko dla jednego określonego działania korygowania.

Dowiedz się więcej o działaniach korygowania.

Wyświetl listę określonego działania korygowania (ID)

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

Uprawnienia

Do wywołania tego interfejsu API jest wymagane jedno z następujących uprawnień. Aby dowiedzieć się więcej, w tym jak wybrać uprawnienia, zobacz Używanie interfejsów API usługi Microsoft Defender dla punktów końcowych, aby uzyskać szczegółowe informacje.

Typ uprawnień	Uprawnienie	Nazwa wyświetlana uprawnień
Aplikacja	RemediationTasks.Read.All	"Odczytywanie informacji o lukach w zabezpieczeniach dotyczących zarządzania zagrożeniami i lukami w zabezpieczeniach"
Delegowane (konto służbowe)	RemediationTask.Read.Read	"Odczytywanie informacji o lukach w zabezpieczeniach dotyczących zarządzania zagrożeniami i lukami w zabezpieczeniach"

Właściwości

Właściwość (ID)	Typ danych	Opis	Przykład zwracanej wartości
Kategoria	Ciąg	Kategoria działania korygowania (konfiguracja oprogramowania/zabezpieczeń)	Oprogramowanie
completerEmail	Ciąg	Jeśli działanie korygujące zostało wykonane ręcznie przez kogoś, ta kolumna zawiera adres e-mail	Zero
completerId	Ciąg	Jeśli działanie korygowania zostało wykonane ręcznie przez kogoś, ta kolumna zawiera identyfikator obiektu	Zero
completionMethod	Ciąg	Działanie korygowania może zostać wykonane "automatycznie" (jeśli wszystkie urządzenia zostaną poprawione) lub "ręcznie" przez osobę, która wybierze pozycję "oznacz jako ukończone"	Automatyczne
createdOn	Data/godzina	Czas utworzenia tego działania korygowania	2021-01-12T18:54:11.5499478Z
Opis	Ciąg	Opis tego działania korygowania	Zaktualizuj program Microsoft Silverlight do nowszej wersji, aby ograniczyć znane luki w zabezpieczeniach wpływające na urządzenia.
dueOn	Data/godzina	Data ukończenia ustawiona przez twórcę dla tego działania korygowania	2021-01-13T00:00:00Z
fixedDevices		Liczba urządzeń, które zostały naprawione	2
ID	Ciąg	Identyfikator tego działania korygowania	097d9735-5479-4899-b1b7-77398899df92
nameId	Ciąg	Pokrewna nazwa produktu	Microsoft Silverlight
Priority (Priorytet)	Ciąg	Priorytet dla tego działania korygowania ustawionego przez twórcę (High\Medium\Low)	High (Wysoki)
Productid	Ciąg	Identyfikator produktu pokrewne	microsoft-_-silverlight
productivityImpactRemediationType	Ciąg	Można zażądać kilku zmian konfiguracji tylko w przypadku urządzeń, które nie mają wpływu na użytkowników. Ta wartość wskazuje wybór między "wszystkimi uwidocznionymi urządzeniami" lub "tylko urządzeniami bez wpływu na użytkownika".	AllExposedAssets
rbacGroupNames	Ciąg	Nazwy powiązanych grup urządzeń	[ "Windows Servers", "Windows 11", "Windows 10" ]
recommendedProgram	Ciąg	Zalecany program do uaktualnienia do	Zero
recommendedVendor	Ciąg	Zalecany dostawca do uaktualnienia do	Zero
recommendedVersion	Ciąg	Zalecana wersja do aktualizacji/uaktualnienia do	Zero
relatedComponent	Ciąg	Powiązany składnik tego działania korygowania (podobny do powiązanego składnika zalecenia dotyczącego zabezpieczeń)	Microsoft Silverlight
requesterEmail	Ciąg	Adres e-mail twórcy	globaladmin@UserName.contoso.com
requesterId	Ciąg	Identyfikator obiektu twórcy	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Ciąg	Notatki (bezpłatny tekst) dodane przez twórcę dla tego działania korygowania	Zero
Scid	Ciąg	SCID powiązanego zalecenia dotyczącego zabezpieczeń	Zero
Stan	Ciąg	Stan działania korygowania (aktywny/ukończony)	Aktywny
statusLastModifiedOn	Data/godzina	Data aktualizacji pola stanu	2021-01-12T18:54:11.5499487Z
targetDevices	Długi	Liczba uwidocznionych urządzeń, których dotyczy to korygowanie	43
Tytuł	Ciąg	Tytuł tego działania korygowania	Microsoft Silverlight
Wpisać	Ciąg	Typ korygowania	Aktualizacja
vendorId	Ciąg	Nazwa powiązanego dostawcy	Microsoft

Przykład

Przykład żądania

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

Przykład odpowiedzi

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

Zobacz też