Pricings - List
列出Microsoft適用於 Cloud 的 Defender 定價設定 scopeId,其符合選擇性指定$filter。 有效範圍包括:訂用帳戶標識碼或特定資源標識碼(支援的資源包括:『VirtualMachines、VMSS 和 ARC 機器』)。 有效的$filter為:'name in ({planName1},{planName2},...)'。 如果未提供$filter,則會傳回未篩選的清單。 如果提供 『$filter=name in (planName1,planName2)』,則傳回的清單只會包含針對 『planName1』 和 『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 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
scope
|
path | True |
string |
定價的範圍標識碼。 有效範圍包括:訂用帳戶(格式:'subscriptions/{subscriptionId}'),或特定資源(格式:'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) - 支持的資源為 (VirtualMachines) |
api-version
|
query | True |
string |
作業的 API 版本 |
$filter
|
query |
string |
OData 篩選條件。 自選。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
還行 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
Get pricings on resource |
Get pricings on subscription |
Get pricings on subscription with plans filter |
Get pricings on resource
範例要求
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
範例回覆
{
"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
範例要求
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings?api-version=2024-01-01
範例回覆
{
"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
範例要求
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings?api-version=2024-01-01
範例回覆
{
"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"
}
}
]
}
定義
名稱 | Description |
---|---|
Cloud |
所有 Azure Resource Manager API 的常見錯誤回應,以傳回失敗作業的錯誤詳細數據。 (這也遵循 OData 錯誤回應格式。)。 |
Cloud |
錯誤詳細數據。 |
code |
作業狀態代碼。 |
enforce |
如果設定為 “False”,則允許此範圍的子系覆寫此範圍上設定的定價組態 (允許設定 inherited=“False” )。 如果設定為 「True」,它會防止覆寫,並強制此範圍的所有子系進行此定價設定。 此欄位僅適用於訂用帳戶層級定價。 |
Error |
資源管理錯誤其他資訊。 |
Extension |
方案的延伸模組屬性 |
inherited |
“inherited” = “True” 表示目前的範圍會從其父代繼承其定價組態。 提供繼承組態之父範圍的標識符會顯示在 「inheritedFrom」 欄位中。 另一方面,“inherited” = “False” 表示目前的範圍已明確設定自己的定價組態,而且不會繼承自其父系。 此欄位是唯讀的,僅適用於資源層級定價。 |
is |
指出是否啟用擴充功能。 |
Operation |
描述擴充功能啟用/停用作業成功/失敗的狀態。 |
Pricing |
Microsoft適用於雲端的 Defender 提供兩個定價層:免費和標準。 標準層提供進階安全性功能,而免費層則提供基本安全性功能。 |
Pricing |
定價組態回應的清單。 |
pricing |
指出是否在選取的範圍上啟用Defender方案。 Microsoft適用於雲端的 Defender 提供兩個定價層:免費和標準。 標準層提供進階安全性功能,而免費層則提供基本安全性功能。 |
resources |
此欄位僅適用於訂用帳戶層級,並反映訂用帳戶下資源的涵蓋範圍狀態。 請注意:[pricingTier] 字段會反映訂用帳戶的計劃狀態。 不過,由於方案狀態也可以在資源層級定義,因此訂用帳戶的計劃狀態與資源狀態之間可能會有不一定的關係。 此欄位有助於指出資源的涵蓋範圍狀態。 |
CloudError
所有 Azure Resource Manager API 的常見錯誤回應,以傳回失敗作業的錯誤詳細數據。 (這也遵循 OData 錯誤回應格式。)。
名稱 | 類型 | Description |
---|---|---|
error.additionalInfo |
錯誤其他資訊。 |
|
error.code |
string |
錯誤碼。 |
error.details |
錯誤詳細數據。 |
|
error.message |
string |
錯誤訊息。 |
error.target |
string |
錯誤目標。 |
CloudErrorBody
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細數據。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
code
作業狀態代碼。
名稱 | 類型 | Description |
---|---|---|
Failed |
string |
未成功建立/更新擴充功能。 如需詳細資訊,請參閱作業狀態消息。 |
Succeeded |
string |
已成功建立/更新擴充功能。 |
enforce
如果設定為 “False”,則允許此範圍的子系覆寫此範圍上設定的定價組態 (允許設定 inherited=“False” )。 如果設定為 「True」,它會防止覆寫,並強制此範圍的所有子系進行此定價設定。 此欄位僅適用於訂用帳戶層級定價。
名稱 | 類型 | Description |
---|---|---|
False |
string |
允許此範圍的子系覆寫此範圍上設定的定價組態 (允許設定 inherited=“False”) |
True |
string |
防止覆寫,並將目前範圍的定價組態強制為所有子系 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
Extension
方案的延伸模組屬性
名稱 | 類型 | Description |
---|---|---|
additionalExtensionProperties |
與延伸模組相關聯的屬性值。 |
|
isEnabled |
指出是否啟用擴充功能。 |
|
name |
string |
延伸模組名稱。 支援的值為: |
operationStatus |
自選。 描述擴充功能啟用/停用作業成功/失敗的狀態。 |
inherited
“inherited” = “True” 表示目前的範圍會從其父代繼承其定價組態。 提供繼承組態之父範圍的標識符會顯示在 「inheritedFrom」 欄位中。 另一方面,“inherited” = “False” 表示目前的範圍已明確設定自己的定價組態,而且不會繼承自其父系。 此欄位是唯讀的,僅適用於資源層級定價。
名稱 | 類型 | Description |
---|---|---|
False |
string |
表示目前的範圍設定自己的定價組態,且不會從其父系繼承它 |
True |
string |
指出目前範圍正從其父系繼承其定價組態 |
isEnabled
指出是否啟用擴充功能。
名稱 | 類型 | Description |
---|---|---|
False |
string |
表示擴充功能已停用 |
True |
string |
表示已啟用擴充功能 |
OperationStatus
描述擴充功能啟用/停用作業成功/失敗的狀態。
名稱 | 類型 | Description |
---|---|---|
code |
作業狀態代碼。 |
|
message |
string |
有關作業成功/失敗的其他資訊。 |
Pricing
Microsoft適用於雲端的 Defender 提供兩個定價層:免費和標準。 標準層提供進階安全性功能,而免費層則提供基本安全性功能。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
name |
string |
資源名稱 |
properties.deprecated |
boolean |
自選。 True 是表示 如果計劃已被取代。 如果有取代計劃,它們會出現在 |
properties.enablementTime |
string |
自選。 如果 |
properties.enforce |
如果設定為 “False”,則允許此範圍的子系覆寫此範圍上設定的定價組態 (允許設定 inherited=“False” )。 如果設定為 「True」,它會防止覆寫,並強制此範圍的所有子系進行此定價設定。 此欄位僅適用於訂用帳戶層級定價。 |
|
properties.extensions |
自選。 方案下提供的延伸模組清單。 |
|
properties.freeTrialRemainingTime |
string |
訂閱免費試用期間的持續時間 - ISO 8601 格式(例如P3Y6M4DT12H30M5S)。 |
properties.inherited |
“inherited” = “True” 表示目前的範圍會從其父代繼承其定價組態。 提供繼承組態之父範圍的標識符會顯示在 「inheritedFrom」 欄位中。 另一方面,“inherited” = “False” 表示目前的範圍已明確設定自己的定價組態,而且不會繼承自其父系。 此欄位是唯讀的,僅適用於資源層級定價。 |
|
properties.inheritedFrom |
string |
繼承自的範圍標識碼。 如果未繼承,則為 「Null」。 此欄位僅適用於資源層級定價。 |
properties.pricingTier |
指出是否在選取的範圍上啟用Defender方案。 Microsoft適用於雲端的 Defender 提供兩個定價層:免費和標準。 標準層提供進階安全性功能,而免費層則提供基本安全性功能。 |
|
properties.replacedBy |
string[] |
自選。 取代此方案的方案清單。 只有當此計劃已被取代時,這個屬性才會存在。 |
properties.resourcesCoverageStatus |
此欄位僅適用於訂用帳戶層級,並反映訂用帳戶下資源的涵蓋範圍狀態。 請注意:[pricingTier] 字段會反映訂用帳戶的計劃狀態。 不過,由於方案狀態也可以在資源層級定義,因此訂用帳戶的計劃狀態與資源狀態之間可能會有不一定的關係。 此欄位有助於指出資源的涵蓋範圍狀態。 |
|
properties.subPlan |
string |
當有多個子方案可供使用時,針對標準定價組態選取的子方案。 每個子計劃都會啟用一組安全性功能。 未指定時,會套用完整計劃。 針對 VirtualMachines 方案,可用的子方案為 『P1』 & 'P2',其中僅支持資源層級 'P1' 子計劃。 |
type |
string |
資源類型 |
PricingList
定價組態回應的清單。
名稱 | 類型 | Description |
---|---|---|
value |
Pricing[] |
定價組態清單 |
pricingTier
指出是否在選取的範圍上啟用Defender方案。 Microsoft適用於雲端的 Defender 提供兩個定價層:免費和標準。 標準層提供進階安全性功能,而免費層則提供基本安全性功能。
名稱 | 類型 | Description |
---|---|---|
Free |
string |
使用基本安全性功能取得適用於雲端的免費 Microsoft Defender 體驗 |
Standard |
string |
使用進階安全性功能取得適用於雲端的標準 Microsoft Defender 體驗 |
resourcesCoverageStatus
此欄位僅適用於訂用帳戶層級,並反映訂用帳戶下資源的涵蓋範圍狀態。 請注意:[pricingTier] 字段會反映訂用帳戶的計劃狀態。 不過,由於方案狀態也可以在資源層級定義,因此訂用帳戶的計劃狀態與資源狀態之間可能會有不一定的關係。 此欄位有助於指出資源的涵蓋範圍狀態。
名稱 | 類型 | Description |
---|---|---|
FullyCovered |
string |
這個值表示與訂用帳戶相關聯的所有資源都已啟用Defender方案。 |
NotCovered |
string |
這個值表示訂用帳戶下的所有資源都會停用Defender方案。 Defender 方案不會保護任何資源。 |
PartiallyCovered |
string |
這個值表示訂用帳戶底下的某些資源已啟用 Defender 方案,而另一些資源則停用。 資源之間有混合的涵蓋範圍狀態。 |