Pricings - List
Списки Microsoft Defender конфигурации цен scopeId для облака, которые соответствуют необязательному $filter. Допустимые области: идентификатор подписки или конкретный идентификатор ресурса (поддерживаемые ресурсы: VirtualMachines, VMSS и ARC Machines). Допустимый $filter: "name in ({planName1},{planName2},...)". Если $filter не указан, возвращается неотфильтрованный список. Если указан параметр "$filter=имя в (имя_плана1,имя_плана2)", возвращенный список включает цены, заданные только для "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
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
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. Необязательный элемент. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ОК |
|
Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
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"
}
}
]
}
Определения
Имя | Описание |
---|---|
Cloud |
Общие ответы об ошибках для всех API-интерфейсов Azure Resource Manager возвращать сведения об ошибках для неудачных операций. (Это также соответствует формату ответа об ошибке OData.) |
Cloud |
Сведения об ошибке. |
code |
Код состояния операции. |
enforce |
Если задано значение False, это позволяет потомкам этого область переопределить конфигурацию ценообразования, заданную для этого область (разрешает параметр inherited="False"). Если задано значение True, это предотвращает переопределение и принудительное выполнение этой конфигурации ценообразования для всех потомков этого область. Это поле доступно только для цен на уровне подписки. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Extension |
Свойства расширения плана |
inherited |
"наследуется" = "True" указывает, что текущая область наследует конфигурацию цен от родительского элемента. Идентификатор родительского область, предоставляющего наследуемую конфигурацию, отображается в поле "inheritedFrom". С другой стороны, "наследуется" = "False" означает, что текущий область имеет собственную конфигурацию ценообразования, которая явно задана и не наследуется от родительского элемента. Это поле доступно только для чтения и доступно только для цен на уровне ресурсов. |
is |
Указывает, включено ли расширение. |
Operation |
Состояние, описывающее успешное или неудачное выполнение операции включения или отключения расширения. |
Pricing |
Microsoft Defender для облака предоставляется в двух ценовых категориях: "Бесплатный" и "Стандартный". Уровень "Стандартный" предлагает расширенные возможности безопасности, а уровень "Бесплатный" — базовые функции безопасности. |
Pricing |
Список ответов на конфигурации ценообразования. |
pricing |
Указывает, включен ли план Defender на выбранном область. Microsoft Defender для облака предоставляется в двух ценовых категориях: "Бесплатный" и "Стандартный". Уровень "Стандартный" предлагает расширенные возможности безопасности, а уровень "Бесплатный" — базовые функции безопасности. |
resources |
Это поле доступно только для уровня подписки и отражает состояние покрытия ресурсов в подписке. Примечание. В поле "pricingTier" отображается состояние плана подписки. Однако, так как состояние плана также можно определить на уровне ресурсов, между состоянием плана подписки и состоянием ресурса может быть несоответствие. Это поле помогает указать состояние покрытия ресурсов. |
CloudError
Общие ответы об ошибках для всех API-интерфейсов Azure Resource Manager возвращать сведения об ошибках для неудачных операций. (Это также соответствует формату ответа об ошибке OData.)
Имя | Тип | Описание |
---|---|---|
error.additionalInfo |
Дополнительные сведения об ошибке. |
|
error.code |
string |
Код ошибки. |
error.details |
Сведения об ошибке. |
|
error.message |
string |
Сообщение об ошибке. |
error.target |
string |
Целевой объект ошибки. |
CloudErrorBody
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
code
Код состояния операции.
Имя | Тип | Описание |
---|---|---|
Failed |
string |
Расширение не было успешно создано или обновлено. Дополнительные сведения см. в сообщении о состоянии операции. |
Succeeded |
string |
Расширение успешно создано или обновлено. |
enforce
Если задано значение False, это позволяет потомкам этого область переопределить конфигурацию ценообразования, заданную для этого область (разрешает параметр inherited="False"). Если задано значение True, это предотвращает переопределение и принудительное выполнение этой конфигурации ценообразования для всех потомков этого область. Это поле доступно только для цен на уровне подписки.
Имя | Тип | Описание |
---|---|---|
False |
string |
Позволяет потомкам этого область переопределять конфигурацию ценообразования, заданную в этом область (разрешает параметр inherited="False"). |
True |
string |
Предотвращает переопределение и принудительное переопределение конфигурации ценообразования текущего область для всех потомков |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
Extension
Свойства расширения плана
Имя | Тип | Описание |
---|---|---|
additionalExtensionProperties |
Значения свойств, связанные с расширением. |
|
isEnabled |
Указывает, включено ли расширение. |
|
name |
string |
Имя модуля. Поддерживаются значения: |
operationStatus |
Необязательный элемент. Состояние, описывающее успешное или неудачное выполнение операции включения или отключения расширения. |
inherited
"наследуется" = "True" указывает, что текущая область наследует конфигурацию цен от родительского элемента. Идентификатор родительского область, предоставляющего наследуемую конфигурацию, отображается в поле "inheritedFrom". С другой стороны, "наследуется" = "False" означает, что текущий область имеет собственную конфигурацию ценообразования, которая явно задана и не наследуется от родительского элемента. Это поле доступно только для чтения и доступно только для цен на уровне ресурсов.
Имя | Тип | Описание |
---|---|---|
False |
string |
Указывает, что текущий область задает собственную конфигурацию ценообразования и не наследует ее от родительского элемента. |
True |
string |
Указывает, что текущая область наследует конфигурацию цен от родительского элемента. |
isEnabled
Указывает, включено ли расширение.
Имя | Тип | Описание |
---|---|---|
False |
string |
Указывает, что расширение отключено. |
True |
string |
Указывает, что расширение включено |
OperationStatus
Состояние, описывающее успешное или неудачное выполнение операции включения или отключения расширения.
Имя | Тип | Описание |
---|---|---|
code |
Код состояния операции. |
|
message |
string |
Дополнительные сведения об успешном или неудачном выполнении операции. |
Pricing
Microsoft Defender для облака предоставляется в двух ценовых категориях: "Бесплатный" и "Стандартный". Уровень "Стандартный" предлагает расширенные возможности безопасности, а уровень "Бесплатный" — базовые функции безопасности.
Имя | Тип | Описание |
---|---|---|
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 |
"наследуется" = "True" указывает, что текущая область наследует конфигурацию цен от родительского элемента. Идентификатор родительского область, предоставляющего наследуемую конфигурацию, отображается в поле "inheritedFrom". С другой стороны, "наследуется" = "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
Список ответов на конфигурации ценообразования.
Имя | Тип | Описание |
---|---|---|
value |
Pricing[] |
Список конфигураций цен |
pricingTier
Указывает, включен ли план Defender на выбранном область. Microsoft Defender для облака предоставляется в двух ценовых категориях: "Бесплатный" и "Стандартный". Уровень "Стандартный" предлагает расширенные возможности безопасности, а уровень "Бесплатный" — базовые функции безопасности.
Имя | Тип | Описание |
---|---|---|
Free |
string |
Получите бесплатные Microsoft Defender для работы с облаком с базовыми функциями безопасности |
Standard |
string |
Получите стандартные Microsoft Defender для облака с расширенными функциями безопасности |
resourcesCoverageStatus
Это поле доступно только для уровня подписки и отражает состояние покрытия ресурсов в подписке. Примечание. В поле "pricingTier" отображается состояние плана подписки. Однако, так как состояние плана также можно определить на уровне ресурсов, между состоянием плана подписки и состоянием ресурса может быть несоответствие. Это поле помогает указать состояние покрытия ресурсов.
Имя | Тип | Описание |
---|---|---|
FullyCovered |
string |
Это значение указывает, что для всех ресурсов, связанных с подпиской, включен план Defender. |
NotCovered |
string |
Это значение указывает, что план Defender отключен для всех ресурсов в подписке. Ни один из ресурсов не защищен планом Defender. |
PartiallyCovered |
string |
Это значение указывает, что для некоторых ресурсов в подписке включен план Defender, а для других он отключен. Существует смешанное состояние покрытия ресурсов. |