Pricings - List
Listor Microsoft Defender för molnpriskonfigurationer för scopeId, som matchar den valfria angivna $filter. Giltiga omfång är: prenumerations-ID eller ett specifikt resurs-ID (resurser som stöds är: "VirtualMachines, VMSS och ARC-datorer"). Giltig $filter är: "name in ({planName1},{planName2},...)". Om $filter inte anges returneras den ofiltrerade listan. Om "$filter=name in (planName1,planName2)" anges innehåller den returnerade listan de priser som angetts endast för "planName1" och "planName2".
GET https://management.azure.com/{scopeId}/providers/Microsoft.Security/pricings?api-version=2024-01-01
GET https://management.azure.com/{scopeId}/providers/Microsoft.Security/pricings?api-version=2024-01-01&$filter={$filter}
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
scope
|
path | True |
string |
Omfångs-ID för prissättningen. Giltiga omfång är: prenumeration (format: "subscriptions/{subscriptionId}") eller en specifik resurs (format: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) – Resurser som stöds är (VirtualMachines) |
api-version
|
query | True |
string |
API-version för åtgärden |
$filter
|
query |
string |
OData-filter. Valfritt. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
Get pricings on resource |
Get pricings on subscription |
Get pricings on subscription with plans filter |
Get pricings on resource
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings?api-version=2024-01-01
Sample Response
{
"value": [
{
"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"
}
]
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/CloudPosture",
"name": "CloudPosture",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Free",
"inherited": "False",
"inheritedFrom": null
}
}
]
}
Get pricings on subscription
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings?api-version=2024-01-01
Sample Response
{
"value": [
{
"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"
}
]
}
},
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/SqlServers",
"name": "SqlServers",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"enforce": "False",
"resourcesCoverageStatus": "FullyCovered"
}
},
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/AppServices",
"name": "AppServices",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Free",
"freeTrialRemainingTime": "PT0S",
"enforce": "False",
"resourcesCoverageStatus": "NotCovered"
}
},
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/StorageAccounts",
"name": "StorageAccounts",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"subPlan": "DefenderForStorageV2",
"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"
}
]
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/SqlServerVirtualMachines",
"name": "SqlServerVirtualMachines",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"enforce": "False",
"resourcesCoverageStatus": "FullyCovered"
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/KubernetesService",
"name": "KubernetesService",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Free",
"freeTrialRemainingTime": "PT0S",
"enforce": "False",
"resourcesCoverageStatus": "NotCovered",
"deprecated": true,
"replacedBy": [
"Containers"
]
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/ContainerRegistry",
"name": "ContainerRegistry",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Free",
"freeTrialRemainingTime": "PT0S",
"enforce": "False",
"resourcesCoverageStatus": "NotCovered",
"deprecated": true,
"replacedBy": [
"Containers"
]
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/KeyVaults",
"name": "KeyVaults",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"subPlan": "PerKeyVault",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"enforce": "False",
"resourcesCoverageStatus": "FullyCovered"
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/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"
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/Arm",
"name": "Arm",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"subPlan": "PerSubscription",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"enforce": "False",
"resourcesCoverageStatus": "FullyCovered"
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/OpenSourceRelationalDatabases",
"name": "OpenSourceRelationalDatabases",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"freeTrialRemainingTime": "PT0S",
"enforce": "False",
"resourcesCoverageStatus": "FullyCovered"
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/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"
}
]
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/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"
}
]
}
},
{
"id": "subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/Api",
"name": "Api",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"subPlan": "P1",
"freeTrialRemainingTime": "PT0S"
}
}
]
}
Get pricings on subscription with plans filter
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings?api-version=2024-01-01
Sample Response
{
"value": [
{
"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"
}
]
}
},
{
"id": "/subscriptions/d34fd44c-ebfa-4a9c-bceb-9eeafe72ac15/providers/Microsoft.Security/pricings/KeyVaults",
"name": "KeyVaults",
"type": "Microsoft.Security/pricings",
"properties": {
"pricingTier": "Standard",
"subPlan": "PerKeyVault",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"enforce": "False",
"resourcesCoverageStatus": "FullyCovered"
}
}
]
}
Definitioner
Name | Description |
---|---|
Cloud |
Vanliga felsvar för alla Azure Resource Manager API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även OData-felsvarsformatet.). |
Cloud |
Felinformationen. |
code |
Åtgärdsstatuskoden. |
enforce |
Om värdet är "Falskt" tillåter det att underordnade i det här omfånget åsidosätter den priskonfiguration som angetts för det här omfånget (tillåter att inställningen ärvs="False"). Om värdet är "Sant" förhindrar det åsidosättningar och tvingar den här priskonfigurationen för alla underordnade i det här omfånget. Det här fältet är endast tillgängligt för priser på prenumerationsnivå. |
Error |
Ytterligare information om resurshanteringsfelet. |
Extension |
Tilläggsegenskaper för en plan |
inherited |
"inherited" = "True" anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade. ID:t för det överordnade omfånget som tillhandahåller den ärvda konfigurationen visas i fältet "inheritedFrom". Å andra sidan anger "ärvd" = "False" att det aktuella omfånget uttryckligen har en egen priskonfiguration och inte ärver från den överordnade. Det här fältet är skrivskyddat och endast tillgängligt för priser på resursnivå. |
is |
Anger om tillägget är aktiverat. |
Operation |
En status som beskriver framgången/misslyckandet med tilläggets aktiverings-/inaktiverandeåtgärd. |
Pricing |
Microsoft Defender för molnet finns i två prisnivåer: kostnadsfri och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner. |
Pricing |
Lista över svar på priskonfigurationer. |
pricing |
Anger om Defender-planen är aktiverad i det valda omfånget. Microsoft Defender för molnet finns i två prisnivåer: kostnadsfri och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner. |
resources |
Det här fältet är endast tillgängligt för prenumerationsnivå och visar täckningsstatusen för resurserna under prenumerationen. Obs! Fältet "pricingTier" återspeglar prenumerationens planstatus. Men eftersom planstatusen också kan definieras på resursnivå kan det finnas en feljustering mellan prenumerationens planstatus och resursstatusen. Det här fältet hjälper till att ange resursernas täckningsstatus. |
CloudError
Vanliga felsvar för alla Azure Resource Manager API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även OData-felsvarsformatet.).
Name | Typ | Description |
---|---|---|
error.additionalInfo |
Ytterligare information om felet. |
|
error.code |
string |
Felkoden. |
error.details |
Felinformationen. |
|
error.message |
string |
Felmeddelandet. |
error.target |
string |
Felmålet. |
CloudErrorBody
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
code
Åtgärdsstatuskoden.
Name | Typ | Description |
---|---|---|
Failed |
string |
Tillägget har inte skapats/uppdaterats. Mer information finns i åtgärdsstatusmeddelandet. |
Succeeded |
string |
Tillägget har skapats/uppdaterats. |
enforce
Om värdet är "Falskt" tillåter det att underordnade i det här omfånget åsidosätter den priskonfiguration som angetts för det här omfånget (tillåter att inställningen ärvs="False"). Om värdet är "Sant" förhindrar det åsidosättningar och tvingar den här priskonfigurationen för alla underordnade i det här omfånget. Det här fältet är endast tillgängligt för priser på prenumerationsnivå.
Name | Typ | Description |
---|---|---|
False |
string |
Tillåter att underordnade i det här omfånget åsidosätter den priskonfiguration som angetts för det här omfånget (tillåter att inställningen ärvs="False") |
True |
string |
Förhindrar åsidosättningar och tvingar det aktuella omfångets priskonfiguration till alla underordnade |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Ytterligare information. |
type |
string |
Den ytterligare informationstypen. |
Extension
Tilläggsegenskaper för en plan
Name | Typ | Description |
---|---|---|
additionalExtensionProperties |
Egenskapsvärden som är associerade med tillägget. |
|
isEnabled |
Anger om tillägget är aktiverat. |
|
name |
string |
Tilläggsnamnet. Värden som stöds är: |
operationStatus |
Valfritt. En status som beskriver framgången/misslyckandet med tilläggets aktiverings-/inaktiverandeåtgärd. |
inherited
"inherited" = "True" anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade. ID:t för det överordnade omfånget som tillhandahåller den ärvda konfigurationen visas i fältet "inheritedFrom". Å andra sidan anger "ärvd" = "False" att det aktuella omfånget uttryckligen har en egen priskonfiguration och inte ärver från den överordnade. Det här fältet är skrivskyddat och endast tillgängligt för priser på resursnivå.
Name | Typ | Description |
---|---|---|
False |
string |
Anger att det aktuella omfånget anger sin egen priskonfiguration och inte ärver den från den överordnade |
True |
string |
Anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade |
isEnabled
Anger om tillägget är aktiverat.
Name | Typ | Description |
---|---|---|
False |
string |
Anger att tillägget är inaktiverat |
True |
string |
Anger att tillägget är aktiverat |
OperationStatus
En status som beskriver framgången/misslyckandet med tilläggets aktiverings-/inaktiverandeåtgärd.
Name | Typ | Description |
---|---|---|
code |
Åtgärdsstatuskoden. |
|
message |
string |
Ytterligare information om åtgärdens framgång/misslyckande. |
Pricing
Microsoft Defender för molnet finns i två prisnivåer: kostnadsfri och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner.
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID |
name |
string |
Resursnamn |
properties.deprecated |
boolean |
Valfritt. Sant om planen är inaktuell. Om det finns ersättningsplaner visas de i |
properties.enablementTime |
string |
Valfritt. Om |
properties.enforce |
Om värdet är "Falskt" tillåter det att underordnade i det här omfånget åsidosätter den priskonfiguration som angetts för det här omfånget (tillåter att inställningen ärvs="False"). Om värdet är "Sant" förhindrar det åsidosättningar och tvingar den här priskonfigurationen för alla underordnade i det här omfånget. Det här fältet är endast tillgängligt för priser på prenumerationsnivå. |
|
properties.extensions |
Valfritt. Lista över tillägg som erbjuds enligt en plan. |
|
properties.freeTrialRemainingTime |
string |
Varaktigheten kvar för den kostnadsfria utvärderingsperioden för prenumerationer – i ISO 8601-format (t.ex. P3Y6M4DT12H30M5S). |
properties.inherited |
"inherited" = "True" anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade. ID:t för det överordnade omfånget som tillhandahåller den ärvda konfigurationen visas i fältet "inheritedFrom". Å andra sidan anger "ärvd" = "False" att det aktuella omfånget uttryckligen har en egen priskonfiguration och inte ärver från den överordnade. Det här fältet är skrivskyddat och endast tillgängligt för priser på resursnivå. |
|
properties.inheritedFrom |
string |
ID:t för det omfång som ärvts från. "Null" om den inte ärvs. Det här fältet är endast tillgängligt för priser på resursnivå. |
properties.pricingTier |
Anger om Defender-planen är aktiverad i det valda omfånget. Microsoft Defender för molnet finns i två prisnivåer: kostnadsfri och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner. |
|
properties.replacedBy |
string[] |
Valfritt. Lista över planer som ersätter den här planen. Den här egenskapen finns bara om den här planen är inaktuell. |
properties.resourcesCoverageStatus |
Det här fältet är endast tillgängligt för prenumerationsnivå och visar täckningsstatusen för resurserna under prenumerationen. Obs! Fältet "pricingTier" återspeglar prenumerationens planstatus. Men eftersom planstatusen också kan definieras på resursnivå kan det finnas en feljustering mellan prenumerationens planstatus och resursstatusen. Det här fältet hjälper till att ange resursernas täckningsstatus. |
|
properties.subPlan |
string |
Den delplan som valts för en standardpriskonfiguration när mer än en underplan är tillgänglig. Varje underplan möjliggör en uppsättning säkerhetsfunktioner. När det inte anges tillämpas en fullständig plan. För VirtualMachines-planen är tillgängliga underplaner "P1" & "P2", där endast P1-underplanen stöds för resursnivå. |
type |
string |
Resurstyp |
PricingList
Lista över svar på priskonfigurationer.
Name | Typ | Description |
---|---|---|
value |
Pricing[] |
Lista över priskonfigurationer |
pricingTier
Anger om Defender-planen är aktiverad i det valda omfånget. Microsoft Defender för molnet finns i två prisnivåer: kostnadsfri och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner.
Name | Typ | Description |
---|---|---|
Free |
string |
Få kostnadsfri Microsoft Defender för molnupplevelse med grundläggande säkerhetsfunktioner |
Standard |
string |
Hämta standardupplevelsen för Microsoft Defender för molnet med avancerade säkerhetsfunktioner |
resourcesCoverageStatus
Det här fältet är endast tillgängligt för prenumerationsnivå och visar täckningsstatusen för resurserna under prenumerationen. Obs! Fältet "pricingTier" återspeglar prenumerationens planstatus. Men eftersom planstatusen också kan definieras på resursnivå kan det finnas en feljustering mellan prenumerationens planstatus och resursstatusen. Det här fältet hjälper till att ange resursernas täckningsstatus.
Name | Typ | Description |
---|---|---|
FullyCovered |
string |
Det här värdet anger att alla resurser som är associerade med prenumerationen har Defender-planen aktiverad. |
NotCovered |
string |
Det här värdet anger att Defender-planen är inaktiverad för alla resurser under prenumerationen. Ingen av resurserna skyddas av Defender-planen. |
PartiallyCovered |
string |
Det här värdet anger att vissa resurser under prenumerationen har Defender-planen aktiverad, medan andra har inaktiverat den. Det finns en blandad täckningsstatus mellan resurser. |