Partager via


Secure Scores - Get

Obtenez un score de sécurité pour une initiative Microsoft Defender spécifique pour le cloud dans votre étendue actuelle. Pour l’initiative ASC Default, utilisez « ascScore ».

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/secureScores/{secureScoreName}?api-version=2020-01-01

Paramètres URI

Nom Dans Obligatoire Type Description
secureScoreName
path True

string

Nom de l’initiative. Pour l’initiative ASC Default, utilisez « ascScore » comme dans l’exemple de requête ci-dessous.

subscriptionId
path True

string

ID d’abonnement Azure

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

Version de l’API pour l’opération

Réponses

Nom Type Description
200 OK

SecureScoreItem

Ok

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Get single secure score

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore?api-version=2020-01-01

Sample Response

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore",
  "name": "ascScore",
  "type": "Microsoft.Security/secureScores",
  "properties": {
    "displayName": "ASC score",
    "score": {
      "max": 39,
      "current": 23.53,
      "percentage": 0.6033
    },
    "weight": 67
  }
}

Définitions

Nom Description
CloudError

Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

CloudErrorBody

Détail de l’erreur.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

SecureScoreItem

Modèle de données d’élément de score sécurisé

CloudError

Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

Nom Type Description
error.additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

error.code

string

Code d'erreur.

error.details

CloudErrorBody[]

Détails de l’erreur.

error.message

string

Message d’erreur.

error.target

string

Cible d’erreur.

CloudErrorBody

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

CloudErrorBody[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

SecureScoreItem

Modèle de données d’élément de score sécurisé

Nom Type Description
id

string

ID de ressource

name

string

Nom de la ressource

properties.displayName

string

Nom de l’initiative

properties.score.current

number

Score actuel

properties.score.max

integer

Score maximal disponible

properties.score.percentage

number

Ratio du score actuel divisé par le maximum. Arrondi à 4 chiffres après la virgule décimale

properties.weight

integer

Poids relatif de chaque abonnement. Utilisé lors du calcul d’un score de sécurité agrégé pour plusieurs abonnements.

type

string

Type de ressource