Ottenere un'attività correttiva per ID

Articolo
05/03/2024

Si applica a:

Se si desidera provare Microsoft Defender per endpoint, Iscriversi per una versione di valutazione gratuita.

Vuoi provare Gestione delle vulnerabilità di Microsoft Defender? Altre informazioni su come iscriversi alla versione di valutazione dell'anteprima pubblica Gestione delle vulnerabilità di Microsoft Defender.

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

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, inclusa la scelta delle autorizzazioni, vedere Usare le API 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	Null
completerId	Stringa	Se l'attività di correzione è stata completata manualmente da un utente, questa colonna contiene l'ID oggetto	Null
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)	Fortemente
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	Null
recommendedVendor	Stringa	Fornitore consigliato per l'aggiornamento a	Null
recommendedVersion	Stringa	Versione consigliata per l'aggiornamento/aggiornamento a	Null
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	Null
Scid	Stringa	SCID della raccomandazione di sicurezza correlata	Null
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