Partager via


Répertorier toutes les activités de correction

S’applique à :

Vous voulez découvrir Microsoft Defender pour point de terminaison ? Inscrivez-vous à un essai gratuit.

Vous souhaitez découvrir Microsoft Defender Vulnerability Management ? En savoir plus sur la façon dont vous pouvez vous inscrire à la version d’évaluation publique de Microsoft Defender Vulnerability Management.

Importante

Certaines informations contenues dans cet article concernent le produit en préversion, qui peut être considérablement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, explicite ou implicite, concernant les informations fournies ici.

Remarque

Si vous êtes un client du gouvernement des États-Unis, utilisez les URI répertoriés dans Microsoft Defender pour point de terminaison pour les clients du gouvernement des États-Unis.

Conseil

Pour de meilleures performances, vous pouvez utiliser le serveur plus près de votre emplacement géographique :

  • 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

Description de l’API

Retourne des informations sur toutes les activités de correction.

En savoir plus sur les activités de correction.

URL: GET : /api/remediationTasks
Prend en charge les requêtes OData V4.
Opérateurs pris en charge par OData :
$filter on : createdon propriétés et status .
$top avec la valeur maximale de 10 000.
$skip.
Consultez les exemples de requêtes OData avec Microsoft Defender pour point de terminaison.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour en savoir plus, notamment sur le choix des autorisations, consultez Utiliser les API Microsoft Defender pour point de terminaison pour plus d’informations.

Type d’autorisation Autorisation Nom complet de l’autorisation
Application RemediationTasks.Read.All « Lire les informations sur les vulnérabilités de gestion des menaces et des vulnérabilités »
Déléguée (compte professionnel ou scolaire) RemediationTask.Read « Lire les informations sur les vulnérabilités de gestion des menaces et des vulnérabilités »

Propriétés

Propriété (ID) Type de données Description Exemple de valeur retournée
Catégorie String Catégorie de l’activité de correction (configuration logicielle/sécurité) Logiciels
completerEmail Chaîne Si l’activité de correction a été effectuée manuellement par une personne, cette colonne contient son e-mail Null
completerId Chaîne Si l’activité de correction a été effectuée manuellement par une personne, cette colonne contient son ID d’objet Null
completionMethod Chaîne Une activité de correction peut être effectuée « automatiquement » (si tous les appareils sont corrigés) ou « manuellement » par une personne qui sélectionne « Marquer comme terminé ». Automatic
createdOn DateTime Heure de création de cette activité de correction 2021-01-12T18:54:11.5499478Z
Description Chaîne Description de cette activité de correction Mettez à jour Microsoft Silverlight vers une version ultérieure pour atténuer les vulnérabilités connues affectant vos appareils.
dueOn DateTime Date d’échéance définie par le créateur pour cette activité de correction 2021-01-13T00:00:00Z
fixedDevices . Nombre d’appareils qui ont été corrigés 2
ID Chaîne ID de cette activité de correction 097d9735-5479-4899-b1b7-77398899df92
nameId Chaîne Nom du produit associé Microsoft Silverlight
Priorité Chaîne Priorité définie par le créateur pour cette activité de correction (Haut/Moyen\Faible) Élevé
Productid Chaîne ID de produit associé microsoft-_-silverlight
productivityImpactRemediationType Chaîne Quelques modifications de configuration peuvent être demandées uniquement pour les appareils qui n’affectent pas les utilisateurs. Cette valeur indique la sélection entre « tous les appareils exposés » ou « uniquement les appareils sans impact sur l’utilisateur ». AllExposedAssets
rbacGroupNames Chaîne Noms de groupes d’appareils associés [ « Windows Servers », « Windows 11 », « Windows 10 » ]
recommendedProgram Chaîne Programme recommandé pour la mise à niveau vers Null
recommendedVendor Chaîne Fournisseur recommandé pour la mise à niveau vers Null
recommendedVersion Chaîne Version recommandée vers laquelle mettre à jour/mettre à niveau Null
relatedComponent Chaîne Composant associé de cette activité de correction (similaire au composant associé pour une recommandation de sécurité) Microsoft Silverlight
requesterEmail Chaîne Adresse e-mail du créateur globaladmin@UserName.contoso.com
requesterId Chaîne ID de l’objet Créateur r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes Chaîne Notes (texte libre) ajoutées par le créateur pour cette activité de correction Null
Scid Chaîne SCID de la recommandation de sécurité associée Null
État Chaîne État de l’activité de correction (Actif/Terminé) Actif
statusLastModifiedOn DateTime Date à laquelle le champ d’état a été mis à jour 2021-01-12T18:54:11.5499487Z
targetDevices Entier long Nombre d’appareils exposés auxquels cette correction s’applique 43
Titre Chaîne Titre de cette activité de correction Mettre à jour Microsoft Silverlight
Type String Type de correction Mettre à jour
vendorId Chaîne Nom du fournisseur associé Microsoft

Exemple

Exemple de requête

GET https://api.securitycenter.windows.com/api/remediationtasks/

Exemple de réponse

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

Voir aussi

Conseil

Voulez-vous en savoir plus ? Collaborez avec la communauté Microsoft Security dans notre communauté technique : Microsoft Defender pour point de terminaison Tech Community.