Sdílet prostřednictvím


Pricings - Get

Získejte cenové konfigurace plánů Defenderu vybraného oboru (platné obory jsou ID prostředku nebo ID předplatného). Na úrovni prostředků jsou podporované typy prostředků VirtualMachines, VMSS a ARC Machines.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
pricingName
path True

string

název konfigurace cen

scopeId
path True

string

ID rozsahu cen. Platné obory jsou: předplatné (formát: subscriptions/{subscriptionId}) nebo konkrétní prostředek (formát: subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) – Podporované prostředky jsou (VirtualMachines).

api-version
query True

string

Verze rozhraní API pro operaci

Odpovědi

Name Typ Description
200 OK

Pricing

OK

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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

Ukázkový požadavek

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

Ukázková odpověď

{
  "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"
      }
    ]
  }
}

Definice

Name Description
CloudError

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

CloudErrorBody

Podrobnosti o chybě.

code

Stavový kód operace.

enforce

Pokud je nastavená hodnota Nepravda, umožní následníkům tohoto oboru přepsat cenovou konfiguraci nastavenou v tomto oboru (umožňuje nastavení zděděno="False"). Pokud je nastavená hodnota Pravda, zabrání přepsání a vynutí tuto konfiguraci cen pro všechny potomky tohoto oboru. Toto pole je dostupné jenom pro ceny na úrovni předplatného.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Extension

Vlastnosti rozšíření plánu

inherited

"zděděný" = "True" označuje, že aktuální obor dědí svou cenovou konfiguraci z nadřazeného objektu. ID nadřazeného oboru, který poskytuje zděděnou konfiguraci, se zobrazí v poli zděděnýFrom. Na druhé straně "zděděno" = "False" označuje, že aktuální obor má vlastní cenovou konfiguraci explicitně nastavenou a nedědí z nadřazeného objektu. Toto pole je jen pro čtení a k dispozici pouze pro ceny na úrovni prostředků.

isEnabled

Určuje, jestli je rozšíření povolené.

OperationStatus

Stav popisující úspěch nebo selhání operace povolení nebo zakázání rozšíření.

Pricing

Microsoft Defender for Cloud je k dispozici ve dvou cenových úrovních: free a standard. Úroveň Standard nabízí pokročilé možnosti zabezpečení, zatímco úroveň Free nabízí základní funkce zabezpečení.

pricingTier

Určuje, jestli je u vybraného oboru povolený plán Defenderu. Microsoft Defender for Cloud je k dispozici ve dvou cenových úrovních: free a standard. Úroveň Standard nabízí pokročilé možnosti zabezpečení, zatímco úroveň Free nabízí základní funkce zabezpečení.

resourcesCoverageStatus

Toto pole je k dispozici pouze pro úroveň předplatného a odráží stav pokrytí prostředků v rámci předplatného. Poznámka: Pole pricingTier odpovídá stavu plánu předplatného. Vzhledem k tomu, že stav plánu je možné definovat také na úrovni prostředku, může dojít k nesprávnému zarovnání mezi stavem plánu předplatného a stavem prostředku. Toto pole pomáhá indikovat stav pokrytí prostředků.

CloudError

Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)

Name Typ Description
error.additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

error.code

string

Kód chyby.

error.details

CloudErrorBody[]

Podrobnosti o chybě.

error.message

string

Chybová zpráva.

error.target

string

Cíl chyby.

CloudErrorBody

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

CloudErrorBody[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

code

Stavový kód operace.

Name Typ Description
Failed

string

Rozšíření se nevytvořilo nebo se úspěšně aktualizovalo. Další podrobnosti najdete ve zprávě o stavu operace.

Succeeded

string

Rozšíření bylo vytvořeno nebo aktualizováno úspěšně.

enforce

Pokud je nastavená hodnota Nepravda, umožní následníkům tohoto oboru přepsat cenovou konfiguraci nastavenou v tomto oboru (umožňuje nastavení zděděno="False"). Pokud je nastavená hodnota Pravda, zabrání přepsání a vynutí tuto konfiguraci cen pro všechny potomky tohoto oboru. Toto pole je dostupné jenom pro ceny na úrovni předplatného.

Name Typ Description
False

string

Umožňuje potomkům tohoto oboru přepsat cenovou konfiguraci nastavenou v tomto oboru (umožňuje nastavení zděděné="False")

True

string

Zabrání přepsání a vynutí konfiguraci cen aktuálního rozsahu pro všechny potomky.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

Extension

Vlastnosti rozšíření plánu

Name Typ Description
additionalExtensionProperties

Hodnoty vlastností přidružené k rozšíření.

isEnabled

isEnabled

Určuje, jestli je rozšíření povolené.

name

string

Název přípony. Podporované hodnoty jsou:

AgentlessDiscoveryForKubernetes – poskytuje nulové nároky, zjišťování clusterů Kubernetes založené na rozhraní API, jejich konfigurací a nasazení. Shromážděná data slouží k vytvoření kontextového grafu zabezpečení pro clustery Kubernetes, poskytování možností proaktivního vyhledávání rizik a vizualizaci rizik a hrozeb pro prostředí a úlohy Kubernetes.
K dispozici pro plán CloudPosture a plán Kontejnerů.

OnUploadMalwareScanning – omezuje počet GB na kontrolu za měsíc pro každý účet úložiště v rámci předplatného. Jakmile tento limit dosáhnete pro daný účet úložiště, objekty blob se během aktuálního kalendářního měsíce neskenují.
K dispozici pro plán StorageAccounts (dílčí plány DefenderForStorageV2).

SensitiveDataDiscovery – Zjišťování citlivých dat identifikuje kontejner úložiště objektů blob s citlivými daty, jako jsou přihlašovací údaje, platební karty a další, a pomáhá tak určit prioritu a prozkoumat události zabezpečení.
K dispozici pro plán StorageAccounts (dílčí plán DefenderForStorageV2) a plán CloudPosture.

ContainerRegistriesVulnerabilityAssessments – poskytuje správu ohrožení zabezpečení pro image uložené v registrech kontejnerů.
K dispozici pro plán CloudPosture a plán Kontejnerů.

mdeDesignatedSubscription – přímé onboarding je bezproblémová integrace mezi defenderem for Endpoint a Defenderem pro cloud, která nevyžaduje další nasazení softwaru na vašich serverech. Onboardované prostředky se zobrazí v rámci určeného předplatného Azure, které nakonfigurujete.
K dispozici pro plán VirtualMachines (dílčí plány P1 a P2).

AgentlessVmScanning – Kontroluje nainstalované software, ohrožení zabezpečení, kontrolu malwaru a tajných kódů bez nutnosti spoléhat se na agenty nebo ovlivnit výkon počítače. Další informace najdete tady https://learn.microsoft.com/en-us/azure/defender-for-cloud/concept-agentless-data-collection.
K dispozici pro plán CloudPosture, plán VirtualMachines (dílčí plán P2) a kontejnery.

entraPermissionsManagement – Správa oprávnění poskytuje funkce CIEM (Cloud Infrastructure Entitlement Management), které organizacím pomáhají spravovat a řídit přístup uživatelů a oprávnění v cloudové infrastruktuře – důležitý vektor útoku pro cloudová prostředí.
Správa oprávnění analyzuje všechna oprávnění a aktivní použití a navrhuje doporučení ke snížení oprávnění k vynucení principu nejnižšího oprávnění. Další informace najdete tady https://learn.microsoft.com/en-us/azure/defender-for-cloud/permissions-management.
K dispozici pro plán CloudPosture.

FileIntegrityMonitoring – Monitorování integrity souborů (FIM), zkoumá soubory operačního systému.
Registry Windows, systémové soubory Linuxu v reálném čase, pro změny, které by mohly znamenat útok.
K dispozici pro plán VirtualMachines (dílčí plán P2).

ContainerSensor – senzor je založený na ig a poskytuje bohatou sadu detekce hrozeb pro clustery, uzly a úlohy Kubernetes, které využívají hlavní analýzu hrozeb Od Microsoftu, poskytuje mapování na architekturu MITRE ATT&CK.
K dispozici pro plán Containers.

AIPromptEvidence – zobrazí výzvy předané mezi uživatelem a modelem AI jako důkazy výstrah. To pomáhá klasifikovat a klasifikovat výstrahy s příslušným kontextem uživatele. Fragmenty výzvy budou obsahovat pouze segmenty výzvy uživatele nebo odpovědi modelu, které byly považovány za podezřelé a relevantní pro klasifikace zabezpečení. Důkaz výzvy bude k dispozici prostřednictvím portálu Defender jako součást každého upozornění.
K dispozici pro plán AI.

operationStatus

OperationStatus

Volitelný. Stav popisující úspěch nebo selhání operace povolení nebo zakázání rozšíření.

inherited

"zděděný" = "True" označuje, že aktuální obor dědí svou cenovou konfiguraci z nadřazeného objektu. ID nadřazeného oboru, který poskytuje zděděnou konfiguraci, se zobrazí v poli zděděnýFrom. Na druhé straně "zděděno" = "False" označuje, že aktuální obor má vlastní cenovou konfiguraci explicitně nastavenou a nedědí z nadřazeného objektu. Toto pole je jen pro čtení a k dispozici pouze pro ceny na úrovni prostředků.

Name Typ Description
False

string

Označuje, že aktuální obor nastavuje vlastní konfiguraci cen a nedědí ji z nadřazeného objektu.

True

string

Označuje, že aktuální obor dědí svou cenovou konfiguraci z nadřazeného oboru.

isEnabled

Určuje, jestli je rozšíření povolené.

Name Typ Description
False

string

Označuje, že rozšíření je zakázané.

True

string

Označuje, že je rozšíření povolené.

OperationStatus

Stav popisující úspěch nebo selhání operace povolení nebo zakázání rozšíření.

Name Typ Description
code

code

Stavový kód operace.

message

string

Další informace týkající se úspěchu nebo selhání operace

Pricing

Microsoft Defender for Cloud je k dispozici ve dvou cenových úrovních: free a standard. Úroveň Standard nabízí pokročilé možnosti zabezpečení, zatímco úroveň Free nabízí základní funkce zabezpečení.

Name Typ Description
id

string

ID prostředku

name

string

Název prostředku

properties.deprecated

boolean

Volitelný. Hodnota True, pokud je plán zastaralý. Pokud existují náhradní plány, zobrazí se ve vlastnosti replacedBy

properties.enablementTime

string

Volitelný. Pokud je pricingTierStandard tato vlastnost obsahuje datum posledního nastavení pricingTier na Standard, pokud je k dispozici (např. 2023-03-01T12:42:42.1921106Z).

properties.enforce

enforce

Pokud je nastavená hodnota Nepravda, umožní následníkům tohoto oboru přepsat cenovou konfiguraci nastavenou v tomto oboru (umožňuje nastavení zděděno="False"). Pokud je nastavená hodnota Pravda, zabrání přepsání a vynutí tuto konfiguraci cen pro všechny potomky tohoto oboru. Toto pole je dostupné jenom pro ceny na úrovni předplatného.

properties.extensions

Extension[]

Volitelný. Seznam rozšíření nabízených v rámci plánu

properties.freeTrialRemainingTime

string

Doba trvání pro bezplatnou zkušební dobu předplatných – ve formátu ISO 8601 (např. P3Y6M4DT12H30M5S).

properties.inherited

inherited

"zděděný" = "True" označuje, že aktuální obor dědí svou cenovou konfiguraci z nadřazeného objektu. ID nadřazeného oboru, který poskytuje zděděnou konfiguraci, se zobrazí v poli zděděnýFrom. Na druhé straně "zděděno" = "False" označuje, že aktuální obor má vlastní cenovou konfiguraci explicitně nastavenou a nedědí z nadřazeného objektu. Toto pole je jen pro čtení a k dispozici pouze pro ceny na úrovni prostředků.

properties.inheritedFrom

string

ID oboru zděděného z. "Null", pokud není zděděno. Toto pole je k dispozici pouze pro ceny na úrovni prostředků.

properties.pricingTier

pricingTier

Určuje, jestli je u vybraného oboru povolený plán Defenderu. Microsoft Defender for Cloud je k dispozici ve dvou cenových úrovních: free a standard. Úroveň Standard nabízí pokročilé možnosti zabezpečení, zatímco úroveň Free nabízí základní funkce zabezpečení.

properties.replacedBy

string[]

Volitelný. Seznam plánů, které tento plán nahrazují Tato vlastnost existuje pouze v případě, že je tento plán zastaralý.

properties.resourcesCoverageStatus

resourcesCoverageStatus

Toto pole je k dispozici pouze pro úroveň předplatného a odráží stav pokrytí prostředků v rámci předplatného. Poznámka: Pole pricingTier odpovídá stavu plánu předplatného. Vzhledem k tomu, že stav plánu je možné definovat také na úrovni prostředku, může dojít k nesprávnému zarovnání mezi stavem plánu předplatného a stavem prostředku. Toto pole pomáhá indikovat stav pokrytí prostředků.

properties.subPlan

string

Dílčí plán vybraný pro konfiguraci cen Úrovně Standard, pokud je k dispozici více než jeden dílčí plán. Každý dílčí plán umožňuje sadu funkcí zabezpečení. Pokud není zadaný, použije se úplný plán. Pro plán VirtualMachines jsou dostupné dílčí plány P1 & P2, kde se podporuje pouze dílčí plán úrovně prostředků P1.

type

string

Typ prostředku

pricingTier

Určuje, jestli je u vybraného oboru povolený plán Defenderu. Microsoft Defender for Cloud je k dispozici ve dvou cenových úrovních: free a standard. Úroveň Standard nabízí pokročilé možnosti zabezpečení, zatímco úroveň Free nabízí základní funkce zabezpečení.

Name Typ Description
Free

string

Získejte bezplatné prostředí Microsoft Defenderu pro cloud se základními funkcemi zabezpečení

Standard

string

Získání standardního prostředí Microsoft Defenderu pro cloud s pokročilými funkcemi zabezpečení

resourcesCoverageStatus

Toto pole je k dispozici pouze pro úroveň předplatného a odráží stav pokrytí prostředků v rámci předplatného. Poznámka: Pole pricingTier odpovídá stavu plánu předplatného. Vzhledem k tomu, že stav plánu je možné definovat také na úrovni prostředku, může dojít k nesprávnému zarovnání mezi stavem plánu předplatného a stavem prostředku. Toto pole pomáhá indikovat stav pokrytí prostředků.

Name Typ Description
FullyCovered

string

Tato hodnota označuje, že všechny prostředky přidružené k předplatnému mají povolený plán Defenderu.

NotCovered

string

Tato hodnota označuje, že plán Defenderu je zakázaný pro všechny prostředky v rámci předplatného. Žádný z prostředků není chráněný plánem Defenderu.

PartiallyCovered

string

Tato hodnota označuje, že některé prostředky v rámci předplatného mají povolený plán Defenderu, zatímco jiné mají zakázaný plán. Mezi prostředky existuje smíšený stav pokrytí.