Pricings - Update
Обновляет указанную конфигурацию цен в Microsoft Defender для облака в области. Допустимые области: идентификатор подписки или определенный идентификатор ресурса (поддерживаемые ресурсы: VirtualMachines, VMSS и КОМПЬЮТЕРЫ ARC и только для 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, он позволяет потомкам этой области переопределить набор конфигураций ценообразования в этой области (позволяет задать наследуемый="False"). Если задано значение True, он предотвращает переопределение и принудительно задает эту конфигурацию ценообразования для всех потомков этой области. Это поле доступно только для цен на уровне подписки. |
||
properties.extensions |
Необязательный. Список расширений, предлагаемых в плане. |
||
properties.subPlan |
string |
Подплан, выбранный для стандартной конфигурации цен, если доступно несколько подпланов. Каждый подплан включает набор функций безопасности. Если это не указано, применяется полный план. Для плана VirtualMachines доступны подпланы P1 & "P2", где поддерживается только подплан "P1". |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Успешно обновлено |
|
201 Created |
Успешно создано. |
|
Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
Update pricing on resource (example for VirtualMachines plan)
Образец запроса
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"
}
}
Пример ответа
{
"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)
Образец запроса
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture?api-version=2024-01-01
{
"properties": {
"pricingTier": "Standard"
}
}
Пример ответа
{
"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
Образец запроса
PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture?api-version=2024-01-01
{
"properties": {
"pricingTier": "Standard"
}
}
Пример ответа
{
"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)
Образец запроса
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"
}
}
Пример ответа
{
"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, он позволяет потомкам этой области переопределить набор конфигураций ценообразования в этой области (позволяет задать наследуемый="False"). Если задано значение True, он предотвращает переопределение и принудительно задает эту конфигурацию ценообразования для всех потомков этой области. Это поле доступно только для цен на уровне подписки. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Extension |
Свойства расширения плана |
inherited |
"унаследованный" = "True" указывает, что текущая область наследует ее конфигурацию ценообразования от родительского элемента. Идентификатор родительской области, предоставляющей унаследованную конфигурацию, отображается в поле "унаследованныйFrom". С другой стороны, "наследуемый" = "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, он позволяет потомкам этой области переопределить набор конфигураций ценообразования в этой области (позволяет задать наследуемый="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 |
Тип ресурса |
pricingTier
Указывает, включен ли план Defender в выбранной области. Microsoft Defender для облака предоставляется в двух ценовых категориях: бесплатных и стандартных. Уровень "Стандартный" предлагает расширенные возможности безопасности, а бесплатный уровень предоставляет основные функции безопасности.
Имя | Тип | Описание |
---|---|---|
Free |
string |
Бесплатный интерфейс Microsoft Defender для облака с основными функциями безопасности |
Standard |
string |
Получите стандартный интерфейс Microsoft Defender для облака с расширенными функциями безопасности |
resourcesCoverageStatus
Это поле доступно только для уровня подписки и отражает состояние покрытия ресурсов в подписке. Обратите внимание: поле "pricingTier" отражает состояние плана подписки. Однако, так как состояние плана также можно определить на уровне ресурса, может возникнуть несоответствие между состоянием плана подписки и состоянием ресурса. Это поле помогает указать состояние покрытия ресурсов.
Имя | Тип | Описание |
---|---|---|
FullyCovered |
string |
Это значение указывает, что все ресурсы, связанные с подпиской, включены в план Defender. |
NotCovered |
string |
Это значение означает, что план Defender отключен для всех ресурсов в подписке. Ни один из ресурсов не защищается планом Defender. |
PartiallyCovered |
string |
Это значение указывает, что некоторые ресурсы в подписке включены в план Defender, а другие — отключены. Существует состояние смешанного покрытия среди ресурсов. |