Pricings - Update
Atualizações uma Microsoft Defender fornecida para a configuração de preços da Cloud no âmbito. Os âmbitos válidos são: o ID da subscrição ou um ID de recurso específico (os recursos suportados são: "VirtualMachines, VMSS e Máquinas ARC" e apenas para plan="VirtualMachines" e subPlan="P1").
PUT https://management.azure.com/{scopeId}/providers/Microsoft.Security/pricings/{pricingName}?api-version=2024-01-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
pricing
|
path | True |
string |
nome da configuração de preços |
scope
|
path | True |
string |
O ID de âmbito dos preços. Os âmbitos válidos são: subscrição (formato: 'subscriptions/{subscriptionId}') ou um recurso específico (formato: 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) - Os recursos suportados são (VirtualMachines) |
api-version
|
query | True |
string |
Versão da API para a operação |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
properties.pricingTier | True |
Indica se o plano do Defender está ativado no âmbito selecionado. Microsoft Defender para a Cloud são fornecidos em dois escalões de preço: gratuito e standard. O escalão standard oferece capacidades de segurança avançadas, enquanto o escalão gratuito oferece funcionalidades de segurança básicas. |
|
properties.enforce |
Se estiver definido como "Falso", permite que os descendentes deste âmbito substituam a configuração de preços definida neste âmbito (permite a definição herdada="Falso"). Se estiver definido como "Verdadeiro", impede substituições e força esta configuração de preços em todos os descendentes deste âmbito. Este campo só está disponível para preços ao nível da subscrição. |
||
properties.extensions |
Opcional. Lista de extensões oferecidas ao abrigo de um plano. |
||
properties.subPlan |
string |
O sub-plano selecionado para uma configuração de preços Standard, quando está disponível mais do que um sub-plano. Cada sub-plano ativa um conjunto de funcionalidades de segurança. Quando não for especificado, é aplicado um plano completo. Para o plano VirtualMachines, os sub-planos disponíveis são "P1" & "P2", em que para o nível de recurso apenas é suportado o sub-plano "P1". |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Atualização com êxito |
|
201 Created |
Criado com êxito. |
|
Other Status Codes |
Resposta de erro que descreve o motivo pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
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
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
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
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"
}
}
]
}
}
Definições
Name | Description |
---|---|
Cloud |
Resposta de erro comum para todas as APIs do Azure Resource Manager para devolver detalhes do erro para operações com falhas. (Isto também segue o formato de resposta de erro OData.). |
Cloud |
O detalhe do erro. |
code |
O código de estado da operação. |
enforce |
Se estiver definido como "Falso", permite que os descendentes deste âmbito substituam a configuração de preços definida neste âmbito (permite a definição herdada="Falso"). Se estiver definido como "Verdadeiro", impede substituições e força esta configuração de preços em todos os descendentes deste âmbito. Este campo só está disponível para preços ao nível da subscrição. |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Extension |
Propriedades da extensão de um plano |
inherited |
"herdado" = "Verdadeiro" indica que o âmbito atual herda a configuração de preços do respetivo principal. O ID do âmbito principal que fornece a configuração herdada é apresentado no campo "inheritedFrom". Por outro lado, "herdado" = "Falso" indica que o âmbito atual tem a sua própria configuração de preços definida explicitamente e não herda do respetivo principal. Este campo é só de leitura e está disponível apenas para preços ao nível dos recursos. |
is |
Indica se a extensão está ativada. |
Operation |
Um estado que descreve o êxito/falha da operação de ativação/desativação da extensão. |
Pricing |
Microsoft Defender para a Cloud são fornecidos em dois escalões de preço: gratuito e standard. O escalão standard oferece capacidades de segurança avançadas, enquanto o escalão gratuito oferece funcionalidades de segurança básicas. |
pricing |
Indica se o plano do Defender está ativado no âmbito selecionado. Microsoft Defender para a Cloud são fornecidos em dois escalões de preço: gratuito e standard. O escalão standard oferece capacidades de segurança avançadas, enquanto o escalão gratuito oferece funcionalidades de segurança básicas. |
resources |
Este campo está disponível apenas para o nível de subscrição e reflete o estado de cobertura dos recursos na subscrição. Nota: o campo "pricingTier" reflete o estado do plano da subscrição. No entanto, uma vez que o estado do plano também pode ser definido ao nível do recurso, pode haver um desalinhamento entre o estado do plano da subscrição e o estado do recurso. Este campo ajuda a indicar o estado de cobertura dos recursos. |
CloudError
Resposta de erro comum para todas as APIs do Azure Resource Manager para devolver detalhes do erro para operações com falhas. (Isto também segue o formato de resposta de erro OData.).
Name | Tipo | Description |
---|---|---|
error.additionalInfo |
As informações adicionais do erro. |
|
error.code |
string |
O código de erro. |
error.details |
Os detalhes do erro. |
|
error.message |
string |
A mensagem de erro. |
error.target |
string |
O destino do erro. |
CloudErrorBody
O detalhe do erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
code
O código de estado da operação.
Name | Tipo | Description |
---|---|---|
Failed |
string |
A extensão não foi criada/atualizada com êxito. Veja a mensagem de estado da operação para obter mais detalhes. |
Succeeded |
string |
A extensão foi criada/atualizada com êxito. |
enforce
Se estiver definido como "Falso", permite que os descendentes deste âmbito substituam a configuração de preços definida neste âmbito (permite a definição herdada="Falso"). Se estiver definido como "Verdadeiro", impede substituições e força esta configuração de preços em todos os descendentes deste âmbito. Este campo só está disponível para preços ao nível da subscrição.
Name | Tipo | Description |
---|---|---|
False |
string |
Permite que os descendentes deste âmbito substituam a configuração de preços definida neste âmbito (permite a definição herdada="Falso") |
True |
string |
Impede substituições e força a configuração de preços do âmbito atual para todos os descendentes |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informações adicionais. |
Extension
Propriedades da extensão de um plano
Name | Tipo | Description |
---|---|---|
additionalExtensionProperties |
Valores de propriedade associados à extensão. |
|
isEnabled |
Indica se a extensão está ativada. |
|
name |
string |
O nome da extensão. Os valores suportados são: |
operationStatus |
Opcional. Um estado que descreve o êxito/falha da operação de ativação/desativação da extensão. |
inherited
"herdado" = "Verdadeiro" indica que o âmbito atual herda a configuração de preços do respetivo principal. O ID do âmbito principal que fornece a configuração herdada é apresentado no campo "inheritedFrom". Por outro lado, "herdado" = "Falso" indica que o âmbito atual tem a sua própria configuração de preços definida explicitamente e não herda do respetivo principal. Este campo é só de leitura e está disponível apenas para preços ao nível dos recursos.
Name | Tipo | Description |
---|---|---|
False |
string |
Indica que o âmbito atual define a sua própria configuração de preços e não a herda do respetivo principal |
True |
string |
Indica que o âmbito atual está a herdar a configuração de preços do respetivo principal |
isEnabled
Indica se a extensão está ativada.
Name | Tipo | Description |
---|---|---|
False |
string |
Indica que a extensão está desativada |
True |
string |
Indica que a extensão está ativada |
OperationStatus
Um estado que descreve o êxito/falha da operação de ativação/desativação da extensão.
Name | Tipo | Description |
---|---|---|
code |
O código de estado da operação. |
|
message |
string |
Informações adicionais sobre o êxito/falha da operação. |
Pricing
Microsoft Defender para a Cloud são fornecidos em dois escalões de preço: gratuito e standard. O escalão standard oferece capacidades de segurança avançadas, enquanto o escalão gratuito oferece funcionalidades de segurança básicas.
Name | Tipo | Description |
---|---|---|
id |
string |
ID do Recurso |
name |
string |
Nome do recurso |
properties.deprecated |
boolean |
Opcional. Verdadeiro se o plano for preterido. Se existirem planos de substituição, serão apresentados na |
properties.enablementTime |
string |
Opcional. Se |
properties.enforce |
Se estiver definido como "Falso", permite que os descendentes deste âmbito substituam a configuração de preços definida neste âmbito (permite a definição herdada="Falso"). Se estiver definido como "Verdadeiro", impede substituições e força esta configuração de preços em todos os descendentes deste âmbito. Este campo só está disponível para preços ao nível da subscrição. |
|
properties.extensions |
Opcional. Lista de extensões oferecidas ao abrigo de um plano. |
|
properties.freeTrialRemainingTime |
string |
A duração restante para o período de avaliação gratuita das subscrições – no formato ISO 8601 (por exemplo, P3Y6M4DT12H30M5S). |
properties.inherited |
"herdado" = "Verdadeiro" indica que o âmbito atual herda a configuração de preços do respetivo principal. O ID do âmbito principal que fornece a configuração herdada é apresentado no campo "inheritedFrom". Por outro lado, "herdado" = "Falso" indica que o âmbito atual tem a sua própria configuração de preços definida explicitamente e não herda do respetivo principal. Este campo é só de leitura e está disponível apenas para preços ao nível dos recursos. |
|
properties.inheritedFrom |
string |
O ID do âmbito herdado de. "Nulo" se não for herdado. Este campo só está disponível para preços ao nível dos recursos. |
properties.pricingTier |
Indica se o plano do Defender está ativado no âmbito selecionado. Microsoft Defender para a Cloud são fornecidos em dois escalões de preço: gratuito e standard. O escalão standard oferece capacidades de segurança avançadas, enquanto o escalão gratuito oferece funcionalidades de segurança básicas. |
|
properties.replacedBy |
string[] |
Opcional. Lista de planos que substituem este plano. Esta propriedade só existe se este plano for preterido. |
properties.resourcesCoverageStatus |
Este campo está disponível apenas para o nível de subscrição e reflete o estado de cobertura dos recursos na subscrição. Nota: o campo "pricingTier" reflete o estado do plano da subscrição. No entanto, uma vez que o estado do plano também pode ser definido ao nível do recurso, pode haver um desalinhamento entre o estado do plano da subscrição e o estado do recurso. Este campo ajuda a indicar o estado de cobertura dos recursos. |
|
properties.subPlan |
string |
O sub-plano selecionado para uma configuração de preços Standard, quando está disponível mais do que um sub-plano. Cada sub-plano ativa um conjunto de funcionalidades de segurança. Quando não for especificado, é aplicado um plano completo. Para o plano VirtualMachines, os sub-planos disponíveis são "P1" & "P2", em que para o nível de recurso apenas é suportado o sub-plano "P1". |
type |
string |
Tipo de recurso |
pricingTier
Indica se o plano do Defender está ativado no âmbito selecionado. Microsoft Defender para a Cloud são fornecidos em dois escalões de preço: gratuito e standard. O escalão standard oferece capacidades de segurança avançadas, enquanto o escalão gratuito oferece funcionalidades de segurança básicas.
Name | Tipo | Description |
---|---|---|
Free |
string |
Obter Microsoft Defender gratuitas para a experiência da Cloud com funcionalidades de segurança básicas |
Standard |
string |
Obter o Microsoft Defender padrão para a experiência da Cloud com funcionalidades de segurança avançadas |
resourcesCoverageStatus
Este campo está disponível apenas para o nível de subscrição e reflete o estado de cobertura dos recursos na subscrição. Nota: o campo "pricingTier" reflete o estado do plano da subscrição. No entanto, uma vez que o estado do plano também pode ser definido ao nível do recurso, pode haver um desalinhamento entre o estado do plano da subscrição e o estado do recurso. Este campo ajuda a indicar o estado de cobertura dos recursos.
Name | Tipo | Description |
---|---|---|
FullyCovered |
string |
Este valor indica que todos os recursos associados à subscrição têm o plano do Defender ativado. |
NotCovered |
string |
Este valor indica que o plano do Defender está desativado para todos os recursos na subscrição. Nenhum dos recursos está protegido pelo plano do Defender. |
PartiallyCovered |
string |
Este valor indica que alguns recursos na subscrição têm o plano do Defender ativado, enquanto outros estão desativados. Existe um estado de cobertura mista entre os recursos. |