Pricings - Update
Обновления предоставленную конфигурацию цен на Microsoft Defender для облака в область. Допустимые области: идентификатор подписки или конкретный идентификатор ресурса (поддерживаемые ресурсы: VirtualMachines, VMSS и ARC Machines) и только для plan='VirtualMachines' и subPlan='P1').
PUT https://management.azure.com/{scopeId}/providers/Microsoft.Security/pricings/{pricingName}?api-version=2024-01-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
pricing
|
path | True |
string |
имя конфигурации ценообразования |
scope
|
path | True |
string |
Идентификатор область цены. Допустимые области: подписка (формат: subscriptions/{subscriptionId}) или конкретный ресурс (формат: subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}). Поддерживаемые ресурсы ( VirtualMachines) |
api-version
|
query | True |
string |
Версия API для операции |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
properties.pricingTier | True |
Указывает, включен ли план Defender на выбранном область. Microsoft Defender для облака предоставляется в двух ценовых категориях: "Бесплатный" и "Стандартный". Уровень "Стандартный" предлагает расширенные возможности безопасности, а уровень "Бесплатный" — базовые функции безопасности. |
|
properties.enforce |
Если задано значение False, это позволяет потомкам этого область переопределить конфигурацию ценообразования, заданную для этого область (разрешает параметр inherited="False"). Если задано значение True, это предотвращает переопределение и принудительное выполнение этой конфигурации ценообразования для всех потомков этого область. Это поле доступно только для цен на уровне подписки. |
||
properties.extensions |
Необязательный элемент. Список расширений, предлагаемых в рамках плана. |
||
properties.subPlan |
string |
Вложенный план, выбранный для конфигурации цен категории "Стандартный", если доступно несколько вложенных планов. Каждый вложенный план включает набор функций безопасности. Если не указано, применяется полный план. Для плана VirtualMachines доступны вложенные планы P1 & P2, где для уровня ресурсов поддерживается только вложенный план P1. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Успешно обновлено |
|
201 Created |
Успешно создано. |
|
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 | олицетворения учетной записи пользователя |
Примеры
Update pricing on resource (example for VirtualMachines plan)
Sample Request
PUT 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
{
"properties": {
"pricingTier": "Standard",
"subPlan": "P1"
}
}
Sample Response
{
"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": "P1",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"inherited": "False",
"inheritedFrom": null,
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
}
}
]
}
}
{
"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": "P1",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"inherited": "False",
"inheritedFrom": null,
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{'Key':'TestKey1','Value':'TestValue1'},{'Key':'TestKey2','Value':'TestValue2'}]"
}
}
]
}
}
Update pricing on subscription (example for CloudPosture plan)
Sample Request
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture?api-version=2024-01-01
{
"properties": {
"pricingTier": "Standard"
}
}
Sample Response
{
"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",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
{
"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",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
Update pricing on subscription (example for CloudPosture plan) - partial success
Sample Request
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture?api-version=2024-01-01
{
"properties": {
"pricingTier": "Standard"
}
}
Sample Response
{
"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",
"operationStatus": {
"code": "Failed",
"message": "Failed find dedicated first party application client ID for extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {d5a2ae44-610b-4500-93be-660a0c5f5ca6} to {identityName} for plan"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {f58310d9-a9f6-439a-9e8d-f62e7b41a168} to {identityName} for plan"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
{
"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",
"operationStatus": {
"code": "Failed",
"message": "Failed find dedicated first party application client ID for extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {d5a2ae44-610b-4500-93be-660a0c5f5ca6} to {identityName} for plan"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {f58310d9-a9f6-439a-9e8d-f62e7b41a168} to {identityName} for plan"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
Update pricing on subscription (example for VirtualMachines plan)
Sample Request
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines?api-version=2024-01-01
{
"properties": {
"pricingTier": "Standard",
"subPlan": "P2",
"enforce": "True"
}
}
Sample Response
{
"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": "True",
"resourcesCoverageStatus": "FullyCovered",
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
},
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
{
"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": "True",
"resourcesCoverageStatus": "FullyCovered",
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
},
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
Определения
Имя | Описание |
---|---|
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 |
Указывает, включен ли план 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 |
Тип ресурса |
pricingTier
Указывает, включен ли план Defender на выбранном область. Microsoft Defender для облака предоставляется в двух ценовых категориях: "Бесплатный" и "Стандартный". Уровень "Стандартный" предлагает расширенные возможности безопасности, а уровень "Бесплатный" — базовые функции безопасности.
Имя | Тип | Описание |
---|---|---|
Free |
string |
Получите бесплатные Microsoft Defender для работы с облаком с базовыми функциями безопасности |
Standard |
string |
Получите стандартные Microsoft Defender для облака с расширенными функциями безопасности |
resourcesCoverageStatus
Это поле доступно только для уровня подписки и отражает состояние покрытия ресурсов в подписке. Примечание. В поле "pricingTier" отображается состояние плана подписки. Однако, так как состояние плана также можно определить на уровне ресурсов, между состоянием плана подписки и состоянием ресурса может быть несоответствие. Это поле помогает указать состояние покрытия ресурсов.
Имя | Тип | Описание |
---|---|---|
FullyCovered |
string |
Это значение указывает, что для всех ресурсов, связанных с подпиской, включен план Defender. |
NotCovered |
string |
Это значение указывает, что план Defender отключен для всех ресурсов в подписке. Ни один из ресурсов не защищен планом Defender. |
PartiallyCovered |
string |
Это значение указывает, что для некоторых ресурсов в подписке включен план Defender, а для других он отключен. Существует смешанное состояние покрытия ресурсов. |