Répertorier toutes les activités de correction
S’applique à :
- Microsoft Defender pour point de terminaison Plan 1
- Microsoft Defender pour point de terminaison Plan 2
- Gestion des vulnérabilités Microsoft Defender
- Microsoft Defender XDR
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
- Méthodes et propriétés de correction
- Obtenir une activité de correction par son ID
- Répertorier les appareils exposés d’une activité de correction
- Gestion des vulnérabilités Microsoft Defender
- Vulnérabilités dans votre organisation
Conseil
Voulez-vous en savoir plus ? Collaborez avec la communauté Microsoft Security dans notre communauté technique : Microsoft Defender pour point de terminaison Tech Community.