Dela via

Pricings - Get

  • Referens
Tjänst:
Defender for Cloud
API-version:
2024-01-01

Hämta priskonfigurationerna för Defender-planer för det valda omfånget (giltiga omfång är resurs-ID eller ett prenumerations-ID). På resursnivå är resurstyper som stöds "VirtualMachines, VMSS och ARC-datorer".

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

URI-parametrar

Name I Obligatorisk Typ Description
pricingName
 path True

string

namn på priskonfigurationen
scopeId
 path True

string

Omfångs-ID för prissättningen. Giltiga omfång är: prenumeration (format: "subscriptions/{subscriptionId}") eller en specifik resurs (format: "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) – Resurser som stöds är (VirtualMachines)
api-version
 query True

string

API-version för åtgärden

Svar

Name Typ Description
200 OK

Pricing

OKEJ
Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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"
      }
    ]
  }
}

Definitioner

Name Description
CloudError

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).
CloudErrorBody

Felinformationen.
code

Åtgärdsstatuskoden.
enforce

Om värdet är "Falskt" kan underordnade i det här omfånget åsidosätta den priskonfiguration som angetts för det här omfånget (tillåter inställningen inherited="False"). Om värdet är "True" förhindrar det åsidosättningar och tvingar fram den här priskonfigurationen för alla underordnade i det här omfånget. Det här fältet är endast tillgängligt för priser på prenumerationsnivå.
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.
Extension

Tilläggsegenskaper för en plan
inherited

"inherited" = "True" anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade. ID:t för det överordnade omfånget som tillhandahåller den ärvda konfigurationen visas i fältet "inheritedFrom". Å andra sidan anger "ärvd" = "False" att det aktuella omfånget uttryckligen har en egen priskonfiguration och inte ärver från dess överordnade. Det här fältet är skrivskyddat och endast tillgängligt för priser på resursnivå.
isEnabled

Anger om tillägget är aktiverat.
OperationStatus

En status som beskriver framgång/misslyckande för tilläggets aktiverings-/inaktiveringsåtgärd.
Pricing

Microsoft Defender för molnet finns på två prisnivåer: kostnadsfritt och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner.
pricingTier

Anger om Defender-planen är aktiverad i det valda omfånget. Microsoft Defender för molnet finns på två prisnivåer: kostnadsfritt och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner.
resourcesCoverageStatus

Det här fältet är endast tillgängligt för prenumerationsnivå och visar täckningsstatusen för resurserna under prenumerationen. Observera: Fältet "pricingTier" återspeglar prenumerationens planstatus. Men eftersom planstatusen också kan definieras på resursnivå kan det uppstå en feljustering mellan prenumerationens planstatus och resursstatus. Det här fältet hjälper dig att ange resursernas täckningsstatus.

CloudError

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name Typ Description
error.additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
error.code

string

Felkoden.
error.details

CloudErrorBody[]

Felinformationen.
error.message

string

Felmeddelandet.
error.target

string

Felmålet.

CloudErrorBody

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

CloudErrorBody[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

code

Åtgärdsstatuskoden.

Name Typ Description
Failed

string

Tillägget har inte skapats/uppdaterats. Mer information finns i meddelandet om åtgärdsstatus.
Succeeded

string

Tillägget har skapats/uppdaterats.

enforce

Om värdet är "Falskt" kan underordnade i det här omfånget åsidosätta den priskonfiguration som angetts för det här omfånget (tillåter inställningen inherited="False"). Om värdet är "True" förhindrar det åsidosättningar och tvingar fram den här priskonfigurationen för alla underordnade i det här omfånget. Det här fältet är endast tillgängligt för priser på prenumerationsnivå.

Name Typ Description
False

string

Tillåter att underordnade i det här omfånget åsidosätter den priskonfiguration som angetts i det här omfånget (tillåter inställningen ärvd="False")
True

string

Förhindrar åsidosättningar och tvingar det aktuella omfångets priskonfiguration till alla underordnade

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.
type

string

Ytterligare informationstyp.

Extension

Tilläggsegenskaper för en plan

Name Typ Description
additionalExtensionProperties

Egenskapsvärden som är associerade med tillägget.
isEnabled

isEnabled

Anger om tillägget är aktiverat.
name

string

Tilläggsnamnet. Värden som stöds är:

AgentlessDiscoveryForKubernetes – Ger noll fotavtryck, API-baserad identifiering av Kubernetes-kluster, deras konfigurationer och distributioner. Insamlade data används för att skapa ett kontextualiserat säkerhetsdiagram för Kubernetes-kluster, tillhandahålla riskjaktsfunktioner och visualisera risker och hot mot Kubernetes-miljöer och arbetsbelastningar.
Tillgänglig för CloudPosture-plan och containerplan.

OnUploadMalwareScanning – Begränsar GB som ska genomsökas per månad för varje lagringskonto i prenumerationen. När den här gränsen har nåtts för ett visst lagringskonto genomsöks inte blobar under den aktuella kalendermånaden.
Tillgänglig för StorageAccounts-plan (DefenderForStorageV2-underplaner).

SensitiveDataDiscovery – Identifiering av känsliga data identifierar bloblagringscontainer med känsliga data, till exempel autentiseringsuppgifter, kreditkort med mera, för att prioritera och undersöka säkerhetshändelser.
Tillgänglig för StorageAccounts-plan (DefenderForStorageV2-underplan) och CloudPosture-plan.

ContainerRegistriesVulnerabilityAssessments – Tillhandahåller sårbarhetshantering för avbildningar som lagras i dina containerregister.
Tillgänglig för CloudPosture-plan och containerplan.

MdeDesignatedSubscription – Direkt onboarding är en sömlös integrering mellan Defender för Endpoint och Defender för molnet som inte kräver extra programvarudistribution på dina servrar. De registrerade resurserna visas under en utsedd Azure-prenumeration som du konfigurerar
Tillgänglig för VirtualMachines-plan (P1- och P2-underplaner).

AgentlessVmScanning – Söker igenom dina datorer efter installerad programvara, sårbarheter, skadlig kod och hemlig genomsökning utan att förlita sig på agenter eller påverka datorns prestanda. Läs mer här https://learn.microsoft.com/en-us/azure/defender-for-cloud/concept-agentless-data-collection.
Tillgänglig för CloudPosture-plan, VirtualMachines-plan (P2-underplan) och containerplan.

EntraPermissionsManagement – Behörighetshantering tillhandahåller CIEM-funktioner (Cloud Infrastructure Entitlement Management) som hjälper organisationer att hantera och kontrollera användaråtkomst och rättigheter i sin molninfrastruktur – viktig attackvektor för molnmiljöer.
Behörighetshantering analyserar alla behörigheter och aktiv användning och föreslår rekommendationer för att minska behörigheter för att framtvinga principen om lägsta behörighet. Läs mer här https://learn.microsoft.com/en-us/azure/defender-for-cloud/permissions-management.
Tillgänglig för CloudPosture-plan.

FileIntegrityMonitoring – Övervakning av filintegritet (FIM) undersöker operativsystemfiler.
Windows-register, Linux-systemfiler i realtid för ändringar som kan tyda på en attack.
Tillgänglig för VirtualMachines-plan (P2-underplan).

ContainerSensor – Sensorn är baserad på IG och tillhandahåller en omfattande svit för hotidentifiering för Kubernetes-kluster, noder och arbetsbelastningar, som drivs av Microsofts ledande hotinformation, tillhandahåller mappning till MITRE ATT&CK-ramverk.
Tillgängligt för containers-plan.

AIPromptEvidence – Exponerar de uppmaningar som skickas mellan användaren och AI-modellen som aviseringsbevis. Detta hjälper till att klassificera och sortera aviseringarna med relevant användarkontext. Promptfragmenten innehåller endast segment av användarprompten eller modellsvaret som bedömdes vara misstänkta och relevanta för säkerhetsklassificeringar. De snabba bevisen kommer att vara tillgängliga via Defender-portalen som en del av varje avisering.
Tillgänglig för AI-plan.

operationStatus

OperationStatus

Valfri. En status som beskriver framgång/misslyckande för tilläggets aktiverings-/inaktiveringsåtgärd.

inherited

"inherited" = "True" anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade. ID:t för det överordnade omfånget som tillhandahåller den ärvda konfigurationen visas i fältet "inheritedFrom". Å andra sidan anger "ärvd" = "False" att det aktuella omfånget uttryckligen har en egen priskonfiguration och inte ärver från dess överordnade. Det här fältet är skrivskyddat och endast tillgängligt för priser på resursnivå.

Name Typ Description
False

string

Anger att det aktuella omfånget anger en egen priskonfiguration och inte ärver den från dess överordnade
True

string

Anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade

isEnabled

Anger om tillägget är aktiverat.

Name Typ Description
False

string

Anger att tillägget är inaktiverat
True

string

Anger att tillägget är aktiverat

OperationStatus

En status som beskriver framgång/misslyckande för tilläggets aktiverings-/inaktiveringsåtgärd.

Name Typ Description
code

code

Åtgärdsstatuskoden.
message

string

Ytterligare information om åtgärdens framgång/misslyckande.

Pricing

Microsoft Defender för molnet finns på två prisnivåer: kostnadsfritt och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner.

Name Typ Description
id

string

Resurs-ID
name

string

Resursnamn
properties.deprecated

boolean

Valfri. Sant om planen är inaktuell. Om det finns ersättningsplaner visas de i egenskapen replacedBy
properties.enablementTime

string

Valfri. Om pricingTier är Standard innehåller den här egenskapen datumet för den senaste gången pricingTier angavs till Standard, när den var tillgänglig (t.ex. 2023-03-01T12:42:42.1921106Z).
properties.enforce

enforce

Om värdet är "Falskt" kan underordnade i det här omfånget åsidosätta den priskonfiguration som angetts för det här omfånget (tillåter inställningen inherited="False"). Om värdet är "True" förhindrar det åsidosättningar och tvingar fram den här priskonfigurationen för alla underordnade i det här omfånget. Det här fältet är endast tillgängligt för priser på prenumerationsnivå.
properties.extensions

Extension[]

Valfri. Lista över tillägg som erbjuds enligt en plan.
properties.freeTrialRemainingTime

string

Varaktigheten som återstår för prenumerationernas kostnadsfria utvärderingsperiod – i ISO 8601-format (t.ex. P3Y6M4DT12H30M5S).
properties.inherited

inherited

"inherited" = "True" anger att det aktuella omfånget ärver dess priskonfiguration från dess överordnade. ID:t för det överordnade omfånget som tillhandahåller den ärvda konfigurationen visas i fältet "inheritedFrom". Å andra sidan anger "ärvd" = "False" att det aktuella omfånget uttryckligen har en egen priskonfiguration och inte ärver från dess överordnade. Det här fältet är skrivskyddat och endast tillgängligt för priser på resursnivå.
properties.inheritedFrom

string

ID:t för omfånget som ärvts från. "Null" om den inte ärvs. Det här fältet är endast tillgängligt för priser på resursnivå.
properties.pricingTier

pricingTier

Anger om Defender-planen är aktiverad i det valda omfånget. Microsoft Defender för molnet finns på två prisnivåer: kostnadsfritt och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner.
properties.replacedBy

string[]

Valfri. Lista över planer som ersätter den här planen. Den här egenskapen finns bara om den här planen är inaktuell.
properties.resourcesCoverageStatus

resourcesCoverageStatus

Det här fältet är endast tillgängligt för prenumerationsnivå och visar täckningsstatusen för resurserna under prenumerationen. Observera: Fältet "pricingTier" återspeglar prenumerationens planstatus. Men eftersom planstatusen också kan definieras på resursnivå kan det uppstå en feljustering mellan prenumerationens planstatus och resursstatus. Det här fältet hjälper dig att ange resursernas täckningsstatus.
properties.subPlan

string

Den underplan som valts för en standardpriskonfiguration när mer än en underplan är tillgänglig. Varje underplan möjliggör en uppsättning säkerhetsfunktioner. När det inte anges tillämpas en fullständig plan. För VirtualMachines-plan är tillgängliga underplaner "P1" & "P2", där endast P1-underplanen stöds för resursnivå.
type

string

Resurstyp

pricingTier

Anger om Defender-planen är aktiverad i det valda omfånget. Microsoft Defender för molnet finns på två prisnivåer: kostnadsfritt och standard. Standardnivån erbjuder avancerade säkerhetsfunktioner, medan den kostnadsfria nivån erbjuder grundläggande säkerhetsfunktioner.

Name Typ Description
Free

string

Få en kostnadsfri Microsoft Defender for Cloud-upplevelse med grundläggande säkerhetsfunktioner
Standard

string

Hämta standardupplevelsen för Microsoft Defender för molnet med avancerade säkerhetsfunktioner

resourcesCoverageStatus

Det här fältet är endast tillgängligt för prenumerationsnivå och visar täckningsstatusen för resurserna under prenumerationen. Observera: Fältet "pricingTier" återspeglar prenumerationens planstatus. Men eftersom planstatusen också kan definieras på resursnivå kan det uppstå en feljustering mellan prenumerationens planstatus och resursstatus. Det här fältet hjälper dig att ange resursernas täckningsstatus.

Name Typ Description
FullyCovered

string

Det här värdet anger att alla resurser som är associerade med prenumerationen har Defender-planen aktiverad.
NotCovered

string

Det här värdet anger att Defender-planen är inaktiverad för alla resurser under prenumerationen. Ingen av resurserna skyddas av Defender-planen.
PartiallyCovered

string

Det här värdet anger att vissa resurser under prenumerationen har Defender-planen aktiverad, medan andra har inaktiverat den. Det finns en blandad täckningsstatus mellan resurser.