Partilhar via

Pricings - Get

  • Referência
Serviço:
Defender for Cloud
Versão da API:
2024-01-01

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

GET 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
pricingName
 path True

string

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

string

O ID do 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 suportados são (VirtualMachines)
api-version
 query True

string

Versão da API para a operação

Respostas

Name Tipo Description
200 OK

Pricing

OK
Other Status Codes

CloudError

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

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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

Pedido de amostra

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

Resposta da amostra

Código de estado:
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

Name Description
CloudError

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

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 a configuração de preços definida neste escopo (permite a configuração inherited="False"). Se definido como "True", ele evita substituições e força essa configuração de preço em todos os descendentes desse escopo. Este campo só está disponível para preços ao nível da subscrição.
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.
Extension

Propriedades de extensão de um plano
inherited

"inherited" = "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" = "Falso" indica que o escopo atual tem sua própria configuração de preços explicitamente definida e não herda de seu pai. Este 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 sucesso/falha da operação de ativação/desativação da extensão.
Pricing

O Microsoft Defender for Cloud é fornecido em dois níveis 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. O Microsoft Defender for Cloud é fornecido em dois níveis 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

Este campo está disponível apenas para o nível de assinatura e reflete o status de cobertura dos recursos sob a assinatura. Observação: o campo "preçoNível" 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. Este campo ajuda a indicar o status de cobertura dos recursos.

CloudError

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

Name Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
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.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
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

O código de status da operação.

Name Tipo Description
Failed

string

A extensão não foi criada/atualizada com êxito. Consulte 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 a configuração de preços definida neste escopo (permite a configuração inherited="False"). Se definido como "True", ele evita substituições e força essa configuração de preço em todos os descendentes desse escopo. 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 escopo substituam a configuração de preços definida neste escopo (permite a configuração inherited="False")
True

string

Impede substituições e força a configuração de preços do escopo atual para todos os descendentes

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

Extension

Propriedades de extensão de um plano

Name 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 suportados são:

AgentlessDiscoveryForKubernetes - Fornece descoberta baseada em API de superfície zero de clusters Kubernetes, suas configurações e implantações. Os dados coletados são usados para criar um gráfico de segurança contextualizado para clusters Kubernetes, fornecer recursos de caça ao risco e visualizar riscos e ameaças a ambientes e cargas de trabalho do Kubernetes.
Disponível para o plano CloudPosture e o plano Containers.

OnUploadMalwareScanning - Limita o GB a ser verificado por mês para cada conta de armazenamento dentro da assinatura. Quando 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 (subplanos DefenderForStorageV2).

SensitiveDataDiscovery - A descoberta de dados confidenciais identifica o contêiner de armazenamento de Blob 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 o plano StorageAccounts (subplano DefenderForStorageV2) e plano CloudPosture.

ContainerRegistriesVulnerabilityAssessments - Fornece gerenciamento de vulnerabilidades para imagens armazenadas em seus registros de contêiner.
Disponível para o plano CloudPosture e o plano Containers.

MdeDesignatedSubscription - A integração direta é uma integração perfeita entre o Defender for Endpoint e o Defender for Cloud que não requer implantação de software extra em seus servidores. Os recursos integrados serão apresentados sob uma Assinatura do Azure designada que você configurar
Disponível para o plano VirtualMachines (subplanos P1 e P2).

AgentlessVmScanning - Analisa as suas máquinas em busca de software instalado, vulnerabilidades, malware e análise secreta sem depender de agentes ou afetar o desempenho da máquina. Saiba mais aqui https://learn.microsoft.com/en-us/azure/defender-for-cloud/concept-agentless-data-collection.
Disponível para plano CloudPosture, plano VirtualMachines (subplano P2) e plano Containers.

EntraPermissionsManagement - Permissions Management fornece recursos de Gerenciamento de Direitos de Infraestrutura de Nuvem (CIEM) que ajudam as organizações a gerenciar e controlar o acesso e os direitos dos usuários em sua infraestrutura de nuvem - vetor de ataque importante para ambientes de nuvem.
O Gerenciamento de Permissões analisa todas as permissões e o uso ativo e sugere recomendações para reduzir as permissões para impor o princípio do menor privilégio. Saiba mais aqui https://learn.microsoft.com/en-us/azure/defender-for-cloud/permissions-management.
Disponível para o plano CloudPosture.

FileIntegrityMonitoring - File integrity monitoring (FIM), examina os arquivos do sistema operacional.
Registros do Windows, arquivos do sistema Linux, em tempo real, para alterações que possam indicar um ataque.
Disponível para o plano VirtualMachines (subplano P2).

ContainerSensor - O sensor é baseado em IG e fornece um rico pacote de deteção de ameaças para clusters, nós e cargas de trabalho do Kubernetes, alimentado pela inteligência de ameaças líder da Microsoft, fornece mapeamento para a estrutura MITRE ATT&CK.
Disponível para o plano de Contentores.

AIPromptEvidence - Expõe os prompts passados entre o usuário e o modelo de IA como evidência de alerta. Isso ajuda a classificar e triar os alertas com o contexto relevante do usuário. Os trechos de prompt incluirão apenas segmentos do prompt do usuário ou da resposta do modelo que foram considerados suspeitos e relevantes para as classificações de segurança. As provas imediatas estarão disponíveis através do portal Defender como parte de cada alerta.
Disponível para plano de IA.

operationStatus

OperationStatus

Opcional. Um status que descreve o sucesso/falha da operação de ativação/desativação da extensão.

inherited

"inherited" = "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" = "Falso" indica que o escopo atual tem sua própria configuração de preços explicitamente definida e não herda de seu pai. Este campo é somente leitura e está disponível apenas para preços no nível do recurso.

Name 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ços de seu pai

isEnabled

Indica se a extensão está habilitada.

Name Tipo Description
False

string

Indica que a extensão está desativada
True

string

Indica que a extensão está ativada

OperationStatus

Um status que descreve o sucesso/falha da operação de ativação/desativação da extensão.

Name Tipo Description
code

code

O código de status da operação.
message

string

Informações adicionais sobre o sucesso/fracasso da operação.

Pricing

O Microsoft Defender for Cloud é fornecido em dois níveis 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.

Name 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 em replacedBy propriedade
properties.enablementTime

string

Opcional. Se pricingTier for Standard então esta propriedade mantém a data da última vez que o pricingTier foi definido como Standard, quando disponível (por exemplo, 2023-03-01T12:42:42.1921106Z).
properties.enforce

enforce

Se definido como "False", ele permite que os descendentes desse escopo substituam a configuração de preços definida neste escopo (permite a configuração inherited="False"). Se definido como "True", ele evita substituições e força essa configuração de preço em todos os descendentes desse escopo. Este campo só está disponível para preços ao nível da subscrição.
properties.extensions

Extension[]

Opcional. Lista de extensões oferecidas sob um plano.
properties.freeTrialRemainingTime

string

A duração deixada para o período de teste gratuito das assinaturas - no formato ISO 8601 (por exemplo, P3Y6M4DT12H30M5S).
properties.inherited

inherited

"inherited" = "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" = "Falso" indica que o escopo atual tem sua própria configuração de preços explicitamente definida e não herda de seu pai. Este campo é somente leitura e está disponível apenas para preços no nível do recurso.
properties.inheritedFrom

string

A id do escopo herdada de. "Nulo" se não herdado. Este 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. O Microsoft Defender for Cloud é fornecido em dois níveis 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 este plano. Esta propriedade só existe se este plano for preterido.
properties.resourcesCoverageStatus

resourcesCoverageStatus

Este campo está disponível apenas para o nível de assinatura e reflete o status de cobertura dos recursos sob a assinatura. Observação: o campo "preçoNível" 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. Este campo ajuda a indicar o status de cobertura dos recursos.
properties.subPlan

string

O subplano selecionado para uma configuração de preço padrão, quando mais de um subplano estiver disponível. Cada subplano permite um conjunto de recursos de segurança. Quando não especificado, o plano completo é aplicado. Para o plano VirtualMachines, os subplanos disponíveis são 'P1' & 'P2', onde para o nível de recursos apenas o subplano 'P1' é suportado.
type

string

Tipo de recurso

pricingTier

Indica se o plano do Defender está habilitado no escopo selecionado. O Microsoft Defender for Cloud é fornecido em dois níveis 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.

Name Tipo Description
Free

string

Obtenha uma experiência gratuita do Microsoft Defender for Cloud com funcionalidades básicas de segurança
Standard

string

Obtenha a experiência padrão do Microsoft Defender for Cloud com recursos avançados de segurança

resourcesCoverageStatus

Este campo está disponível apenas para o nível de assinatura e reflete o status de cobertura dos recursos sob a assinatura. Observação: o campo "preçoNível" 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. Este campo ajuda a indicar o status de cobertura dos recursos.

Name 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 Defender está desativado para todos os recursos da assinatura. Nenhum dos recursos está protegido pelo plano Defender.
PartiallyCovered

string

Esse valor indica que alguns recursos da assinatura têm o plano Defender habilitado, enquanto outros o têm desativado. Existe um estatuto de cobertura misto entre os recursos.