Pricings - Get

Référence

Service:: Defender for Cloud

API Version:: 2024-01-01

Obtenez les configurations tarifaires des plans Defender de l’étendue sélectionnée (les étendues valides sont l’ID de ressource ou un ID d’abonnement). Au niveau de la ressource, les types de ressources pris en charge sont « Machines virtuelles, VMSS et machines ARC ».

GET https://management.azure.com/{scopeId}/providers/Microsoft.Security/pricings/{pricingName}?api-version=2024-01-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
pricingName	path	True	string	nom de la configuration de tarification
scopeId	path	True	string	ID d’étendue de la tarification. Les étendues valides sont : abonnement (format : « subscriptions/{subscriptionId} ») ou une ressource spécifique (format : « subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) - Les ressources prises en charge sont (VirtualMachines)
api-version	query	True	string	Version de l’API pour l’opération

Réponses

Nom	Type	Description
200 OK	Pricing	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 pricings on resource - VirtualMachines plan

Get pricings on subscription - CloudPosture plan

Get pricings on subscription - Containers plan

Get pricings on subscription - Dns plan

Get pricings on subscription - StorageAccounts plan

Get pricings on subscription - VirtualMachines plan

Get pricings on resource - VirtualMachines plan

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/VirtualMachines?api-version=2024-01-01

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/VirtualMachines",
  "name": "VirtualMachines",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "subPlan": "P2",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "inherited": "True",
    "inheritedFrom": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23",
    "extensions": [
      {
        "name": "AgentlessVmScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
        }
      },
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - CloudPosture plan

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture",
  "name": "CloudPosture",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered",
    "extensions": [
      {
        "name": "AgentlessVmScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "ExclusionTags": "[]"
        }
      },
      {
        "name": "AgentlessDiscoveryForKubernetes",
        "isEnabled": "True"
      },
      {
        "name": "SensitiveDataDiscovery",
        "isEnabled": "True"
      },
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "EntraPermissionsManagement",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - Containers plan

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Containers",
  "name": "Containers",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - Dns plan

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Dns",
  "name": "Dns",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "deprecated": true,
    "replacedBy": [
      "VirtualMachines"
    ],
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered"
  }
}

Get pricings on subscription - StorageAccounts plan

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/StorageAccounts",
  "name": "StorageAccounts",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "subPlan": "PerStorageAccount",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered",
    "extensions": [
      {
        "name": "OnUploadMalwareScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "capGBPerMonthPerStorageAccount": 10
        }
      },
      {
        "name": "SensitiveDataDiscovery",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - VirtualMachines plan

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines",
  "name": "VirtualMachines",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "subPlan": "P2",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "PartiallyCovered",
    "extensions": [
      {
        "name": "AgentlessVmScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
        }
      },
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "True"
      }
    ]
  }
}

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.
code	Opération status code.
enforce	S’il est défini sur « False », il permet aux descendants de cette étendue de remplacer la configuration tarifaire définie sur cette étendue (autorise la définition de inherited="False »). S’il est défini sur « True », il empêche les remplacements et force cette configuration tarifaire sur tous les descendants de cette étendue. Ce champ n’est disponible que pour la tarification au niveau de l’abonnement.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
Extension	Propriétés d’extension d’un plan
inherited	« hérité » = « True » indique que l’étendue actuelle hérite de sa configuration tarifaire de son parent. L’ID de l’étendue parente qui fournit la configuration héritée s’affiche dans le champ « inheritedFrom ». D’autre part, « hérité » = « False » indique que l’étendue actuelle a sa propre configuration tarifaire définie explicitement et n’hérite pas de son parent. Ce champ est en lecture seule et disponible uniquement pour la tarification au niveau des ressources.
isEnabled	Indique si l’extension est activée.
OperationStatus	Un status décrivant la réussite/l’échec de l’opération d’activation/désactivation de l’extension.
Pricing	Microsoft Defender pour le cloud est fourni en deux niveaux tarifaires : gratuit et standard. Le niveau standard offre des fonctionnalités de sécurité avancées, tandis que le niveau gratuit offre des fonctionnalités de sécurité de base.
pricingTier	Indique si le plan Defender est activé sur l’étendue sélectionnée. Microsoft Defender pour le cloud est fourni en deux niveaux tarifaires : gratuit et standard. Le niveau standard offre des fonctionnalités de sécurité avancées, tandis que le niveau gratuit offre des fonctionnalités de sécurité de base.
resourcesCoverageStatus	Ce champ est disponible uniquement au niveau de l’abonnement et reflète la couverture status des ressources sous l’abonnement. Remarque : le champ « pricingTier » reflète le plan status de l’abonnement. Toutefois, étant donné que le status de plan peut également être défini au niveau de la ressource, il peut y avoir un décalage entre le status du plan de l’abonnement et le status de ressource. Ce champ permet d’indiquer la couverture status des ressources.

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.

code

Opération status code.

Nom	Type	Description
Failed	string	L’extension n’a pas été créée/mise à jour avec succès. Pour plus d’informations, consultez le message d’status d’opération.
Succeeded	string	L’extension a été créée/mise à jour avec succès.

enforce

S’il est défini sur « False », il permet aux descendants de cette étendue de remplacer la configuration tarifaire définie sur cette étendue (autorise la définition de inherited="False »). S’il est défini sur « True », il empêche les remplacements et force cette configuration tarifaire sur tous les descendants de cette étendue. Ce champ n’est disponible que pour la tarification au niveau de l’abonnement.

Nom	Type	Description
False	string	Permet aux descendants de cette étendue de remplacer la configuration tarifaire définie sur cette étendue (permet de définir inherited="False »)
True	string	Empêche les remplacements et force la configuration tarifaire de l’étendue actuelle à tous les descendants

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.

Extension

Propriétés d’extension d’un plan

Nom	Type	Description
additionalExtensionProperties		Valeurs de propriété associées à l’extension.
isEnabled	isEnabled	Indique si l’extension est activée.
name	string	Nom de l'extension. Les valeurs prises en charge sont les suivantes : AgentlessDiscoveryForKubernetes : découverte basée sur l’API d’informations sur l’architecture du cluster Kubernetes, les objets de charge de travail et la configuration. Requis pour l’inventaire Kubernetes, la détection de l’exposition des identités et du réseau, l’analyse des chemins d’attaque et la chasse aux risques dans le cadre de l’Explorateur de sécurité cloud. Disponible pour le plan CloudPosture. OnUploadMalwareScanning : limite le Go à analyser par mois pour chaque compte de stockage au sein de l’abonnement. Une fois cette limite atteinte sur un compte de stockage donné, les objets blob ne sont pas analysés pendant le mois calendaire en cours. Disponible pour le plan StorageAccounts. SensitiveDataDiscovery : la découverte de données sensibles identifie le conteneur de stockage d’objets blob avec des données sensibles telles que des informations d’identification, des cartes de crédit, etc., pour vous aider à hiérarchiser et à examiner les événements de sécurité. Disponible pour les plans StorageAccounts et CloudPosture. ContainerRegistriesVulnerabilityAssessments - Fournit la gestion des vulnérabilités pour les images stockées dans vos registres de conteneurs. Disponible pour les plans CloudPosture et Conteneurs.
operationStatus	OperationStatus	facultatif. Un status décrivant la réussite/l’échec de l’opération d’activation/désactivation de l’extension.

inherited

« hérité » = « True » indique que l’étendue actuelle hérite de sa configuration tarifaire de son parent. L’ID de l’étendue parente qui fournit la configuration héritée s’affiche dans le champ « inheritedFrom ». D’autre part, « hérité » = « False » indique que l’étendue actuelle a sa propre configuration tarifaire définie explicitement et n’hérite pas de son parent. Ce champ est en lecture seule et disponible uniquement pour la tarification au niveau des ressources.

Nom	Type	Description
False	string	Indique que l’étendue actuelle définit sa propre configuration tarifaire et ne l’hérite pas de son parent
True	string	Indique que l’étendue actuelle hérite de sa configuration tarifaire de son parent

isEnabled

Indique si l’extension est activée.

Nom	Type	Description
False	string	Indique que l’extension est désactivée
True	string	Indique que l’extension est activée

OperationStatus

Un status décrivant la réussite/l’échec de l’opération d’activation/désactivation de l’extension.

Nom	Type	Description
code	code	Opération status code.
message	string	Informations supplémentaires concernant la réussite/l’échec de l’opération.

Pricing

Microsoft Defender pour le cloud est fourni en deux niveaux tarifaires : gratuit et standard. Le niveau standard offre des fonctionnalités de sécurité avancées, tandis que le niveau gratuit offre des fonctionnalités de sécurité de base.

Nom	Type	Description
id	string	ID de ressource
name	string	Nom de la ressource
properties.deprecated	boolean	facultatif. True si le plan est déprécié. S’il y a des plans de remplacement, ils apparaissent dans la `replacedBy` propriété
properties.enablementTime	string	facultatif. Si `pricingTier` est, cette propriété contient la date de la dernière fois que le `pricingTier` a été défini sur `Standard`, lorsqu’il est `Standard` disponible (par exemple 2023-03-01T12 :42 :42.1921106Z).
properties.enforce	enforce	S’il est défini sur « False », il permet aux descendants de cette étendue de remplacer la configuration tarifaire définie sur cette étendue (autorise la définition de inherited="False »). S’il est défini sur « True », il empêche les remplacements et force cette configuration tarifaire sur tous les descendants de cette étendue. Ce champ n’est disponible que pour la tarification au niveau de l’abonnement.
properties.extensions	Extension[]	facultatif. Liste des extensions proposées dans le cadre d’un plan.
properties.freeTrialRemainingTime	string	Durée restante pour la période d’essai gratuite des abonnements - au format ISO 8601 (par exemple, P3Y6M4DT12H30M5S).
properties.inherited	inherited	« hérité » = « True » indique que l’étendue actuelle hérite de sa configuration tarifaire de son parent. L’ID de l’étendue parente qui fournit la configuration héritée s’affiche dans le champ « inheritedFrom ». D’autre part, « hérité » = « False » indique que l’étendue actuelle a sa propre configuration tarifaire définie explicitement et n’hérite pas de son parent. Ce champ est en lecture seule et disponible uniquement pour la tarification au niveau des ressources.
properties.inheritedFrom	string	ID de l’étendue héritée de. « Null » s’il n’est pas hérité. Ce champ n’est disponible que pour la tarification au niveau des ressources.
properties.pricingTier	pricingTier	Indique si le plan Defender est activé sur l’étendue sélectionnée. Microsoft Defender pour le cloud est fourni en deux niveaux tarifaires : gratuit et standard. Le niveau standard offre des fonctionnalités de sécurité avancées, tandis que le niveau gratuit offre des fonctionnalités de sécurité de base.
properties.replacedBy	string[]	facultatif. Liste des plans qui remplacent ce plan. Cette propriété existe uniquement si ce plan est déconseillé.
properties.resourcesCoverageStatus	resourcesCoverageStatus	Ce champ est disponible uniquement au niveau de l’abonnement et reflète la couverture status des ressources sous l’abonnement. Remarque : le champ « pricingTier » reflète le plan status de l’abonnement. Toutefois, étant donné que le status de plan peut également être défini au niveau de la ressource, il peut y avoir un décalage entre le status du plan de l’abonnement et le status de ressource. Ce champ permet d’indiquer la couverture status des ressources.
properties.subPlan	string	Sous-plan sélectionné pour une configuration tarifaire Standard, lorsque plusieurs sous-plans sont disponibles. Chaque sous-plan active un ensemble de fonctionnalités de sécurité. Lorsqu’il n’est pas spécifié, le plan complet est appliqué. Pour le plan VirtualMachines, les sous-plans disponibles sont « P1 » & « P2 », où pour le niveau de ressource, seul le sous-plan « P1 » est pris en charge.
type	string	Type de ressource

pricingTier

Indique si le plan Defender est activé sur l’étendue sélectionnée. Microsoft Defender pour le cloud est fourni en deux niveaux tarifaires : gratuit et standard. Le niveau standard offre des fonctionnalités de sécurité avancées, tandis que le niveau gratuit offre des fonctionnalités de sécurité de base.

Nom	Type	Description
Free	string	Obtenir des Microsoft Defender gratuits pour l’expérience cloud avec des fonctionnalités de sécurité de base
Standard	string	Obtenir les Microsoft Defender standard pour l’expérience cloud avec des fonctionnalités de sécurité avancées

resourcesCoverageStatus

Ce champ est disponible uniquement au niveau de l’abonnement et reflète la couverture status des ressources sous l’abonnement. Remarque : le champ « pricingTier » reflète le plan status de l’abonnement. Toutefois, étant donné que le status de plan peut également être défini au niveau de la ressource, il peut y avoir un décalage entre le status du plan de l’abonnement et le status de ressource. Ce champ permet d’indiquer la couverture status des ressources.

Nom	Type	Description
FullyCovered	string	Cette valeur indique que le plan Defender est activé pour toutes les ressources associées à l’abonnement.
NotCovered	string	Cette valeur indique que le plan Defender est désactivé pour toutes les ressources de l’abonnement. Aucune des ressources n’est protégée par le plan Defender.
PartiallyCovered	string	Cette valeur indique que le plan Defender est activé pour certaines ressources de l’abonnement, tandis que d’autres l’ont désactivé. Il existe une couverture mixte status entre les ressources.

Pricings - Get

Paramètres URI

Réponses

Sécurité

azure_auth

Scopes

Exemples

Get pricings on resource - VirtualMachines plan

Sample Request

Sample Response

Get pricings on subscription - CloudPosture plan

Sample Request

Sample Response

Get pricings on subscription - Containers plan

Sample Request

Sample Response

Get pricings on subscription - Dns plan

Sample Request

Sample Response

Get pricings on subscription - StorageAccounts plan

Sample Request

Sample Response

Get pricings on subscription - VirtualMachines plan

Sample Request

Sample Response

Définitions

CloudError

CloudErrorBody

code

enforce

ErrorAdditionalInfo

Extension

inherited

isEnabled

OperationStatus

Pricing

pricingTier

resourcesCoverageStatus

Ressources supplémentaires