Répertorier toutes les activités de correction

Article
04/26/2024

S’applique à :

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

Vous souhaitez découvrir Gestion des vulnérabilités Microsoft Defender ? En savoir plus sur la façon dont vous pouvez vous inscrire à la version d’évaluation publique Gestion des vulnérabilités Microsoft Defender.

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

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 des exemples dans 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é ».	Automatique
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	Activité de correction status (Actif/Terminé)	Actif
statusLastModifiedOn	DateTime	Date de mise à jour du champ status	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