Pricings - Get

  • Referência
Service:
Defender for Cloud
API Version:
2024-01-01

Obtenha as configurações de preços dos planos do Defender do escopo selecionado (os escopos válidos são a ID do recurso ou uma ID de assinatura). No nível do recurso, os tipos de recursos com suporte são 'Máquinas VirtualMachines, VMSS e ARC'.

GET https://management.azure.com/{scopeId}/providers/Microsoft.Security/pricings/{pricingName}?api-version=2024-01-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
pricingName
 path True

string

nome da configuração de preços
scopeId
 path True

string

A ID de escopo do preço. 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

Respostas

Nome Tipo Description
200 OK

Pricing

OK
Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Get pricings on resource - VirtualMachines plan
Get pricings on subscription - CloudPosture plan
Get pricings on subscription - Containers plan
Get pricings on subscription - Dns plan
Get pricings on subscription - StorageAccounts plan
Get pricings on subscription - VirtualMachines plan

Get pricings on resource - VirtualMachines plan

Sample Request

GET 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

Sample Response

Status code:
200 
{
  "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"
      }
    ]
  }
}

Get pricings on subscription - CloudPosture plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "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",
        "additionalExtensionProperties": {
          "ExclusionTags": "[]"
        }
      },
      {
        "name": "AgentlessDiscoveryForKubernetes",
        "isEnabled": "True"
      },
      {
        "name": "SensitiveDataDiscovery",
        "isEnabled": "True"
      },
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "EntraPermissionsManagement",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - Containers plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Containers?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/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"
      }
    ]
  }
}

Get pricings on subscription - Dns plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Dns?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/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"
  }
}

Get pricings on subscription - StorageAccounts plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/StorageAccounts?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/StorageAccounts",
  "name": "StorageAccounts",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "subPlan": "PerStorageAccount",
    "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"
      }
    ]
  }
}

Get pricings on subscription - VirtualMachines plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "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"
      }
    ]
  }
}

Definições

Nome Description
CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.).
CloudErrorBody

O detalhe do erro.
code

A operação status código.
enforce

Se definido como "False", ele permitirá 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.
ErrorAdditionalInfo

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.
isEnabled

Indica se a extensão está habilitada.
OperationStatus

Um status que descreve o êxito/falha da operação de habilitação/desabilitação da extensão.
Pricing

Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos avançados de segurança, enquanto a camada gratuita oferece recursos básicos de segurança.
pricingTier

Indica se o plano do Defender está habilitado no escopo selecionado. Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos avançados de segurança, enquanto a camada gratuita oferece recursos básicos de segurança.
resourcesCoverageStatus

Esse campo está disponível apenas para nível de assinatura e reflete a cobertura status dos recursos na assinatura. Observação: o campo "pricingTier" reflete o plano status da assinatura. No entanto, como o plano status também pode ser definido no nível do recurso, pode haver desalinhamento entre o plano da assinatura status e o recurso status. Esse campo ajuda a indicar a cobertura status dos recursos.

CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.).

Nome Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
error.code

string

O código de erro.
error.details

CloudErrorBody[]

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

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

CloudErrorBody[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

code

A operação status código.

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 permitirá 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

isEnabled

Indica se a extensão está habilitada.
name

string

O nome da extensão. Os valores com suporte são:

AgentlessDiscoveryForKubernetes – descoberta baseada em API de informações sobre arquitetura de cluster do Kubernetes, objetos de carga de trabalho e instalação. Necessário para o inventário do Kubernetes, detecção de identidade e exposição de rede, análise de caminho de ataque e busca de riscos como parte do gerenciador de segurança de nuvem. Disponível para o plano CloudPosture.

OnUploadMalwareScanning – limita o GB a ser verificado por mês para cada conta de armazenamento dentro da assinatura. Depois que esse limite for atingido em uma determinada conta de armazenamento, os Blobs não serão verificados durante o mês do calendário atual. Disponível para o plano StorageAccounts.

SensitiveDataDiscovery – A descoberta de dados confidenciais identifica o contêiner de Armazenamento de Blobs com dados confidenciais, como credenciais, cartões de crédito e muito mais, para ajudar a priorizar e investigar eventos de segurança. Disponível para planos StorageAccounts e CloudPosture.

ContainerRegistriesVulnerabilityAssessments – fornece gerenciamento de vulnerabilidades para imagens armazenadas em seus registros de contêiner. Disponível para os planos CloudPosture e Contêineres.
operationStatus

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ço 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

code

A operação status código.
message

string

Informações adicionais sobre o êxito/falha da operação.

Pricing

Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos avançados de segurança, 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 replacedBy propriedade
properties.enablementTime

string

Opcional. Se pricingTier for Standard , essa propriedade manterá a data da última vez em que foi pricingTier definida como Standard, quando disponível (por exemplo, 2023-03-01T12:42:42.1921106Z).
properties.enforce

enforce

Se definido como "False", ele permitirá 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

Extension[]

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

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. "Null" se não for herdado. Esse campo só está disponível para preços no nível do recurso.
properties.pricingTier

pricingTier

Indica se o plano do Defender está habilitado no escopo selecionado. Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos avançados de segurança, 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

resourcesCoverageStatus

Esse campo está disponível apenas para nível de assinatura e reflete a cobertura status dos recursos na assinatura. Observação: o campo "pricingTier" reflete o plano status da assinatura. No entanto, como o plano status também pode ser definido no nível do recurso, pode haver desalinhamento entre o plano da assinatura status e o recurso status. Esse campo ajuda a indicar a cobertura status dos recursos.
properties.subPlan

string

O subconsulta selecionado para uma configuração de preços Padrão, quando mais de um subconsulta está disponível. Cada subconsulta habilita um conjunto de recursos de segurança. Quando não especificado, o plano completo é aplicado. Para o plano VirtualMachines, os sub-planos disponíveis são 'P1' & 'P2', em que apenas para o nível de recurso há suporte para o subconsulta 'P1'.
type

string

Tipo de recurso

pricingTier

Indica se o plano do Defender está habilitado no escopo selecionado. Microsoft Defender para Nuvem é fornecido em dois tipos de preço: gratuito e padrão. A camada padrão oferece recursos avançados de segurança, enquanto a camada gratuita oferece recursos básicos de segurança.

Nome Tipo Description
Free

string

Obter Microsoft Defender gratuitos para experiência na nuvem com recursos básicos de segurança
Standard

string

Obter o Microsoft Defender padrão para a experiência na nuvem com recursos avançados de segurança

resourcesCoverageStatus

Esse campo está disponível apenas para nível de assinatura e reflete a cobertura status dos recursos na assinatura. Observação: o campo "pricingTier" reflete o plano status da assinatura. No entanto, como o plano status também pode ser definido no nível do recurso, pode haver desalinhamento entre o plano da assinatura status e o recurso status. Esse campo ajuda a indicar a cobertura status dos recursos.

Nome Tipo Description
FullyCovered

string

Esse valor indica que todos os recursos associados à assinatura têm o plano do 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á uma cobertura mista status entre os recursos.