Condividi tramite


Elencare tutte le attività correttive

Si applica a:

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 su tutte le attività di correzione.

Altre informazioni sulle attività di correzione.

URL: GET: /api/remediationTasks
Supporta le query OData V4.
Operatori supportati da OData:
$filter on: createdon e status proprietà.
$top con un valore massimo di 10.000.
$skip.
Vedere gli esempi nelle query OData con Microsoft Defender per endpoint.

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 '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 Aggiornare 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/

Esempio di risposta

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks",
    "value": [
        {
            "id": "03942ef5-aewb-4w6e-b555-d6a97013844w",
            "title": "Update Microsoft Silverlight",
            "createdOn": "2021-02-10T13:20:36.4718166Z",
            "requesterId": "65548a1d-ef00-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

Consiglio

Per saperne di più, Collaborare con la community di Microsoft Security nella community tech: Microsoft Defender per endpoint Tech Community.