Ottenere un'attività correttiva per ID
Si applica a:
- Microsoft Defender per endpoint Piano 1
- Microsoft Defender per endpoint
- Gestione delle vulnerabilità di Microsoft Defender
- Microsoft Defender XDR
Se si desidera provare Microsoft Defender per endpoint, Iscriversi per una versione di valutazione gratuita.
Si vuole provare Gestione vulnerabilità di Microsoft Defender? Altre informazioni su come iscriversi alla versione di valutazione dell'anteprima pubblica di Microsoft Defender Vulnerability Management.
Importante
Alcune informazioni in questo articolo fanno riferimento alle caratteristiche di un prodotto prima del rilascio, che possono essere modificate sostanzialmente prima della distribuzione al pubblico. Microsoft non fornisce alcuna garanzia, esplicita o implicita, in relazione alle informazioni contenute in questo documento.
Nota
Se si è un cliente del governo degli Stati Uniti, usare gli URI elencati in Microsoft Defender per endpoint per i clienti del governo degli Stati Uniti.
Consiglio
Per ottenere prestazioni migliori, è possibile usare il server più vicino alla posizione geografica:
- 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
Descrizione DELL'API
Restituisce informazioni per l'attività di correzione specificata. Presenta le stesse colonne dell'attività Recupera tutte le correzioni, ma restituisce i risultati solo per l'attività di correzione specificata.
Altre informazioni sulle attività di correzione.
Elencare un'attività di correzione specificata per (ID)
URL: GET: /api/remediationTasks/{id}
Autorizzazioni
Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, incluso come scegliere le autorizzazioni, vedere Usare le API di Microsoft Defender per endpoint per informazioni dettagliate.
Tipo di autorizzazione | Autorizzazione | Nome visualizzato autorizzazioni |
---|---|---|
Applicazione | RemediationTasks.Read.All | 'Leggere le informazioni sulla vulnerabilità di Gestione delle minacce e delle vulnerabilità' |
Delegato (account aziendale o dell'istituto di istruzione) | RemediationTask.Read.Read | 'Leggere le informazioni sulla vulnerabilità di Gestione delle minacce e delle vulnerabilità' |
Proprietà
Proprietà (ID) | Tipo di dati | Descrizione | Esempio di valore restituito |
---|---|---|---|
Category | Stringa | Categoria dell'attività di correzione (configurazione software/sicurezza) | Software |
completerEmail | Stringa | Se l'attività di correzione è stata completata manualmente da un utente, questa colonna contiene il messaggio di posta elettronica | Nullo |
completerId | Stringa | Se l'attività di correzione è stata completata manualmente da un utente, questa colonna contiene l'ID oggetto | Nullo |
completionMethod | Stringa | Un'attività di correzione può essere completata "automaticamente" (se vengono applicate patch a tutti i dispositivi) o "manualmente" da una persona che seleziona "contrassegna come completata" | Automatico |
createdOn | DateTime | Ora di creazione dell'attività di correzione | 2021-01-12T18:54:11.5499478Z |
Descrizione | Stringa | Descrizione di questa attività di correzione | Aggiornare Microsoft Silverlight a una versione successiva per attenuare le vulnerabilità note che interessano i dispositivi. |
dueOn | DateTime | Data di scadenza impostata dall'autore per questa attività di correzione | 2021-01-13T00:00:00Z |
fixedDevices | Numero di dispositivi che sono stati corretti | 2 | |
ID | Stringa | ID di questa attività di correzione | 097d9735-5479-4899-b1b7-77398899df92 |
nameId | Stringa | Nome del prodotto correlato | Microsoft Silverlight |
Priorità | Stringa | Priorità impostata dall'autore per questa attività di correzione (High\Medium\Low) | Alto |
Productid | Stringa | ID prodotto correlato | microsoft-_-silverlight |
productivityImpactRemediationType | Stringa | È possibile richiedere alcune modifiche alla configurazione solo per i dispositivi che non influiscono sugli utenti. Questo valore indica la selezione tra "tutti i dispositivi esposti" o "solo i dispositivi senza impatto sull'utente". | AllExposedAssets |
rbacGroupNames | Stringa | Nomi di gruppi di dispositivi correlati | [ "Server Windows", "Windows 11", "Windows 10" ] |
recommendedProgram | Stringa | Programma consigliato per l'aggiornamento a | Nullo |
recommendedVendor | Stringa | Fornitore consigliato per l'aggiornamento a | Nullo |
recommendedVersion | Stringa | Versione consigliata per l'aggiornamento/aggiornamento a | Nullo |
relatedComponent | Stringa | Componente correlato di questa attività di correzione (simile al componente correlato per una raccomandazione di sicurezza) | Microsoft Silverlight |
richiedenteEmail | Stringa | Indirizzo di posta elettronica dell'autore | globaladmin@UserName.contoso.com |
requesterId | Stringa | ID oggetto creatore | r647211f-2e16-43f2-a480-16ar3a2a796r |
requesterNotes | Stringa | Note (testo libero) aggiunte dall'autore per questa attività di correzione | Nullo |
Scid | Stringa | SCID della raccomandazione di sicurezza correlata | Nullo |
Stato | Stringa | Stato dell'attività di correzione (Attivo/Completato) | Attivazione |
statusLastModifiedOn | DateTime | Data di aggiornamento del campo stato | 2021-01-12T18:54:11.5499487Z |
targetDevices | Lungo | Numero di dispositivi esposti a cui è applicabile questa correzione | 43 |
Titolo | Stringa | Titolo di questa attività di correzione | Microsoft Silverlight |
Tipo | Stringa | Tipo di correzione | Update |
vendorId | Stringa | Nome fornitore correlato | Microsoft |
Esempio
Esempio di richiesta
GET https://api.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c
Esempio di risposta
{
"@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
}
Vedere anche
- Metodi e proprietà di correzione
- Elencare tutte le attività correttive
- Elencare i dispositivi esposti a un'attività correttiva
- Gestione delle vulnerabilità di Microsoft Defender
- Vulnerabilità nell'organizzazione
Consiglio
Per saperne di più, Collaborare con la community di Microsoft Security nella community tech: Microsoft Defender per endpoint Tech Community.