Obtenir une recommandation par IDGet recommendation by ID

S’applique à : Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

Notes

Si vous êtes un client du gouvernement des États-Unis, utilisez les UR répertoriés dans Microsoft Defender pour endpoint pour les clients du gouvernement des États-Unis.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Conseil

Pour de meilleures performances, vous pouvez utiliser un serveur plus proche de votre emplacement géographique :For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

Important

Certaines informations ont trait à un produit préalablement publié, qui peut être modifié de manière significative avant sa publication commerciale.Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft n’offre aucune garantie, explicite ou implicite, concernant les informations fournies ici.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Récupère une recommandation de sécurité par son ID.Retrieves a security recommendation by its ID.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API.One of the following permissions is required to call this API. Pour plus d’informations, notamment sur le choix des autorisations, voir Utiliser Microsoft Defender pour les API de point de terminaison pour plus d’informations.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Type d’autorisationPermission type AutorisationPermission Nom d’affichage de l’autorisationPermission display name
ApplicationApplication SecurityRecommendation.Read.AllSecurityRecommendation.Read.All « Lire les informations de recommandation sur la sécurité de la gestion des menaces et des vulnérabilités »'Read Threat and Vulnerability Management security recommendation information'
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) SecurityRecommendation.ReadSecurityRecommendation.Read « Lire les informations de recommandation sur la sécurité de la gestion des menaces et des vulnérabilités »'Read Threat and Vulnerability Management security recommendation information'

Requête HTTPHTTP request

GET /api/recommendations/{id}

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization ChaîneString Porteur {token}.Bearer {token}. Obligatoire.Required.

Corps de la demandeRequest body

VideEmpty

RéponseResponse

Si elle réussit, cette méthode renvoie 200 OK avec les recommandations de sécurité dans le corps.If successful, this method returns 200 OK with the security recommendations in the body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome

RéponseResponse

Voici un exemple de réponse.Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations/$entity",
    "id": "va-_-google-_-chrome",
    "productName": "chrome",
    "recommendationName": "Update Chrome",
    "weaknesses": 38,
    "vendor": "google",
    "recommendedVersion": "",
    "recommendationCategory": "Application",
    "subCategory": "",
    "severityScore": 0,
    "publicExploit": false,
    "activeAlert": false,
    "associatedThreats": [],
    "remediationType": "Update",
    "status": "Active",
    "configScoreImpact": 0,
    "exposureImpact": 3.9441860465116285,
    "totalMachineCount": 6,
    "exposedMachinesCount": 5,
    "nonProductivityImpactedAssets": 0,
    "relatedComponent": "Chrome"
}