Pricings - List
Lista as configurações de preços do Microsoft Defender para Nuvem da scopeId, que correspondem à $filter opcional fornecida. Os escopos válidos são: id de assinatura ou uma ID de recurso específica (os recursos com suporte são: 'VirtualMachines, VMSS e Máquinas ARC'). O $filter válido é: 'name in ({planName1},{planName2},...)'. Se $filter não for fornecido, a lista não filtrada será retornada. Se '$filter=name in (planName1,planName2)' for fornecido, a lista retornada incluirá os preços definidos apenas para 'planName1' e '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}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
scope
|
path | True |
string |
A ID do escopo dos preços. Escopos válidos são: assinatura (formato: 'subscriptions/{subscriptionId}') ou um recurso específico (formato: 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) - Os recursos com suporte são (VirtualMachines) |
api-version
|
query | True |
string |
Versão da API para a operação |
$filter
|
query |
string |
Filtro OData. Opcional. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OKEY |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
Get pricings on resource |
Get pricings on subscription |
Get pricings on subscription with plans filter |
Get pricings on resource
Solicitação de exemplo
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
Resposta de exemplo
{
"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
Solicitação de exemplo
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings?api-version=2024-01-01
Resposta de exemplo
{
"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
Solicitação de exemplo
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings?api-version=2024-01-01
Resposta de exemplo
{
"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"
}
}
]
}
Definições
Nome | Description |
---|---|
Cloud |
Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.). |
Cloud |
O detalhe do erro. |
code |
O código de status da operação. |
enforce |
Se definido como "False", ele permite que os descendentes desse escopo substituam o conjunto de configuração de preços nesse escopo (permite a configuração herdada="False"). Se definido como "True", ele impede substituições e força essa configuração de preços em todos os descendentes desse escopo. Esse campo só está disponível para preços no nível da assinatura. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Extension |
Propriedades de extensão de um plano |
inherited |
"herdado" = "True" indica que o escopo atual herda sua configuração de preços de seu pai. A ID do escopo pai que fornece a configuração herdada é exibida no campo "inheritedFrom". Por outro lado, "herdado" = "False" indica que o escopo atual tem sua própria configuração de preço definida explicitamente e não herda de seu pai. Esse campo é somente leitura e está disponível apenas para preços no nível do recurso. |
is |
Indica se a extensão está habilitada. |
Operation |
Um status que descreve o êxito/falha da operação de habilitação/desabilitação da extensão. |
Pricing |
O Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos de segurança avançados, enquanto a camada gratuita oferece recursos básicos de segurança. |
Pricing |
Lista de resposta de configurações de preços. |
pricing |
Indica se o plano do Defender está habilitado no escopo selecionado. O Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos de segurança avançados, enquanto a camada gratuita oferece recursos básicos de segurança. |
resources |
Esse campo está disponível apenas para nível de assinatura e reflete o status de cobertura dos recursos na assinatura. Observe: o campo "pricingTier" reflete o status do plano da assinatura. No entanto, como o status do plano também pode ser definido no nível do recurso, pode haver desalinhamento entre o status do plano da assinatura e o status do recurso. Esse campo ajuda a indicar o status de cobertura dos recursos. |
CloudError
Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.).
Nome | 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.
Nome | 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 status da operação.
Nome | Tipo | Description |
---|---|---|
Failed |
string |
A extensão não foi criada/atualizada com êxito. Confira a mensagem de status da operação para obter mais detalhes. |
Succeeded |
string |
A extensão foi criada/atualizada com êxito. |
enforce
Se definido como "False", ele permite que os descendentes desse escopo substituam o conjunto de configuração de preços nesse escopo (permite a configuração herdada="False"). Se definido como "True", ele impede substituições e força essa configuração de preços em todos os descendentes desse escopo. Esse campo só está disponível para preços no nível da assinatura.
Nome | Tipo | Description |
---|---|---|
False |
string |
Permite que os descendentes desse escopo substituam o conjunto de configuração de preços nesse escopo (permite que a configuração herdada="False") |
True |
string |
Impede substituições e força a configuração de preços do escopo atual para todos os descendentes |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
Extension
Propriedades de extensão de um plano
Nome | Tipo | Description |
---|---|---|
additionalExtensionProperties |
Valores de propriedade associados à extensão. |
|
isEnabled |
Indica se a extensão está habilitada. |
|
name |
string |
O nome da extensão. Os valores com suporte são: |
operationStatus |
Opcional. Um status que descreve o êxito/falha da operação de habilitação/desabilitação da extensão. |
inherited
"herdado" = "True" indica que o escopo atual herda sua configuração de preços de seu pai. A ID do escopo pai que fornece a configuração herdada é exibida no campo "inheritedFrom". Por outro lado, "herdado" = "False" indica que o escopo atual tem sua própria configuração de preço definida explicitamente e não herda de seu pai. Esse campo é somente leitura e está disponível apenas para preços no nível do recurso.
Nome | Tipo | Description |
---|---|---|
False |
string |
Indica que o escopo atual define sua própria configuração de preços e não a herda de seu pai |
True |
string |
Indica que o escopo atual está herdando sua configuração de preço de seu pai |
isEnabled
Indica se a extensão está habilitada.
Nome | Tipo | Description |
---|---|---|
False |
string |
Indica que a extensão está desabilitada |
True |
string |
Indica que a extensão está habilitada |
OperationStatus
Um status que descreve o êxito/falha da operação de habilitação/desabilitação da extensão.
Nome | Tipo | Description |
---|---|---|
code |
O código de status da operação. |
|
message |
string |
Informações adicionais sobre o êxito/falha da operação. |
Pricing
O Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos de segurança avançados, enquanto a camada gratuita oferece recursos básicos de segurança.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso |
name |
string |
Nome do recurso |
properties.deprecated |
boolean |
Opcional. True se o plano for preterido. Se houver planos de substituição, eles aparecerão na propriedade |
properties.enablementTime |
string |
Opcional. Se |
properties.enforce |
Se definido como "False", ele permite que os descendentes desse escopo substituam o conjunto de configuração de preços nesse escopo (permite a configuração herdada="False"). Se definido como "True", ele impede substituições e força essa configuração de preços em todos os descendentes desse escopo. Esse campo só está disponível para preços no nível da assinatura. |
|
properties.extensions |
Opcional. Lista de extensões oferecidas em um plano. |
|
properties.freeTrialRemainingTime |
string |
A duração restante para o período de avaliação gratuita das assinaturas – no formato ISO 8601 (por exemplo, P3Y6M4DT12H30M5S). |
properties.inherited |
"herdado" = "True" indica que o escopo atual herda sua configuração de preços de seu pai. A ID do escopo pai que fornece a configuração herdada é exibida no campo "inheritedFrom". Por outro lado, "herdado" = "False" indica que o escopo atual tem sua própria configuração de preço definida explicitamente e não herda de seu pai. Esse campo é somente leitura e está disponível apenas para preços no nível do recurso. |
|
properties.inheritedFrom |
string |
A ID do escopo herdado. "Nulo" se não for herdado. Esse campo só está disponível para preços no nível do recurso. |
properties.pricingTier |
Indica se o plano do Defender está habilitado no escopo selecionado. O Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos de segurança avançados, enquanto a camada gratuita oferece recursos básicos de segurança. |
|
properties.replacedBy |
string[] |
Opcional. Lista de planos que substituem esse plano. Essa propriedade só existirá se esse plano for preterido. |
properties.resourcesCoverageStatus |
Esse campo está disponível apenas para nível de assinatura e reflete o status de cobertura dos recursos na assinatura. Observe: o campo "pricingTier" reflete o status do plano da assinatura. No entanto, como o status do plano também pode ser definido no nível do recurso, pode haver desalinhamento entre o status do plano da assinatura e o status do recurso. Esse campo ajuda a indicar o status de cobertura dos recursos. |
|
properties.subPlan |
string |
O subprojeto selecionado para uma configuração de preço Standard, quando mais de um subprojeto está disponível. Cada subprojeto permite um conjunto de recursos de segurança. Quando não especificado, o plano completo é aplicado. Para o plano VirtualMachines, os subprojetos disponíveis são 'P1' & 'P2', em que somente para o nível de recurso há suporte para o subconsulta 'P1'. |
type |
string |
Tipo de recurso |
PricingList
Lista de resposta de configurações de preços.
Nome | Tipo | Description |
---|---|---|
value |
Pricing[] |
Lista de configurações de preços |
pricingTier
Indica se o plano do Defender está habilitado no escopo selecionado. O Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos de segurança avançados, enquanto a camada gratuita oferece recursos básicos de segurança.
Nome | Tipo | Description |
---|---|---|
Free |
string |
Obter experiência gratuita do Microsoft Defender para Nuvem com recursos básicos de segurança |
Standard |
string |
Obter a experiência padrão do Microsoft Defender para Nuvem com recursos avançados de segurança |
resourcesCoverageStatus
Esse campo está disponível apenas para nível de assinatura e reflete o status de cobertura dos recursos na assinatura. Observe: o campo "pricingTier" reflete o status do plano da assinatura. No entanto, como o status do plano também pode ser definido no nível do recurso, pode haver desalinhamento entre o status do plano da assinatura e o status do recurso. Esse campo ajuda a indicar o status de cobertura dos recursos.
Nome | Tipo | Description |
---|---|---|
FullyCovered |
string |
Esse valor indica que todos os recursos associados à assinatura têm o plano defender habilitado. |
NotCovered |
string |
Esse valor indica que o plano do Defender está desabilitado para todos os recursos na assinatura. Nenhum dos recursos é protegido pelo plano do Defender. |
PartiallyCovered |
string |
Esse valor indica que alguns recursos na assinatura têm o plano do Defender habilitado, enquanto outros o desabilitam. Há um status de cobertura mista entre os recursos. |