Obtenir un score sécurisé d’appareilGet device secure score

S’applique à :Applies to:

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

Récupère votre score de sécurité Microsoft pour les appareils.Retrieves your Microsoft Secure Score for Devices. Un niveau de sécurité Microsoft plus élevé pour les appareils signifie que vos points de terminaison sont plus résistants aux attaques contre les menaces de cybersécurité.A higher Microsoft Secure Score for Devices means your endpoints are more resilient from cybersecurity threat attacks.

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 Score.Read.AlllScore.Read.Alll « Lire le score de gestion des menaces et des vulnérabilités »'Read Threat and Vulnerability Management score'
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Score.ReadScore.Read « Lire le score de gestion des menaces et des vulnérabilités »'Read Threat and Vulnerability Management score'

Requête HTTPHTTP request

GET /api/configurationScore

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization StringString 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 données de score de sécurité de l’appareil dans le corps de la réponse.If successful, this method returns 200 OK, with the device secure score data in the response body.

ExempleExample

DemandeRequest

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

GET https://api.securitycenter.microsoft.com/api/configurationScore

RéponseResponse

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

Notes

La liste de réponses présentée ici peut être tronquée à des raisons de concision.The response list shown here may be truncated for brevity.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}

Voir aussiSee also