Pricings - List
Перечисляет конфигурации цен Microsoft Defender для облака идентификатора scopeId, соответствующие необязательному $filter. Допустимые области: идентификатор подписки или определенный идентификатор ресурса (поддерживаемые ресурсы: VirtualMachines, VMSS и ARC Machines). Допустимая $filter: "имя в ({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
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
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
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
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"
}
}
]
}
Определения
Имя | Описание |
---|---|
Cloud |
Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.). |
Cloud |
Сведения об ошибке. |
code |
Код состояния операции. |
enforce |
Если задано значение False, он позволяет потомкам этой области переопределить набор конфигураций ценообразования в этой области (позволяет задать наследуемый="False"). Если задано значение True, он предотвращает переопределение и принудительно задает эту конфигурацию ценообразования для всех потомков этой области. Это поле доступно только для цен на уровне подписки. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Extension |
Свойства расширения плана |
inherited |
"унаследованный" = "True" указывает, что текущая область наследует ее конфигурацию ценообразования от родительского элемента. Идентификатор родительской области, предоставляющей унаследованную конфигурацию, отображается в поле "унаследованныйFrom". С другой стороны, "наследуемый" = "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, он позволяет потомкам этой области переопределить набор конфигураций ценообразования в этой области (позволяет задать наследуемый="False"). Если задано значение True, он предотвращает переопределение и принудительно задает эту конфигурацию ценообразования для всех потомков этой области. Это поле доступно только для цен на уровне подписки.
Имя | Тип | Описание |
---|---|---|
False |
string |
Позволяет потомкам этой области переопределить набор конфигураций ценообразования в этой области (позволяет задать наследуемый="False") |
True |
string |
Предотвращение переопределения и принудительное переопределение конфигурации ценообразования текущей области всем потомкам |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Дополнительный тип сведений. |
Extension
Свойства расширения плана
Имя | Тип | Описание |
---|---|---|
additionalExtensionProperties |
Значения свойств, связанные с расширением. |
|
isEnabled |
Указывает, включено ли расширение. |
|
name |
string |
Имя расширения. Поддерживаемые значения: |
operationStatus |
Необязательный. Состояние, описывающее успешность или сбой операции включения или отключения расширения. |
inherited
"унаследованный" = "True" указывает, что текущая область наследует ее конфигурацию ценообразования от родительского элемента. Идентификатор родительской области, предоставляющей унаследованную конфигурацию, отображается в поле "унаследованныйFrom". С другой стороны, "наследуемый" = "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, он позволяет потомкам этой области переопределить набор конфигураций ценообразования в этой области (позволяет задать наследуемый="False"). Если задано значение True, он предотвращает переопределение и принудительно задает эту конфигурацию ценообразования для всех потомков этой области. Это поле доступно только для цен на уровне подписки. |
|
properties.extensions |
Необязательный. Список расширений, предлагаемых в плане. |
|
properties.freeTrialRemainingTime |
string |
Длительность, оставшаяся для бесплатной пробной версии подписок , в формате ISO 8601 (например, P3Y6M4DT12H30M5S). |
properties.inherited |
"унаследованный" = "True" указывает, что текущая область наследует ее конфигурацию ценообразования от родительского элемента. Идентификатор родительской области, предоставляющей унаследованную конфигурацию, отображается в поле "унаследованныйFrom". С другой стороны, "наследуемый" = "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, а другие — отключены. Существует состояние смешанного покрытия среди ресурсов. |