Pricings - Update
Aktualizace poskytnuté Microsoft Defender pro konfiguraci cen cloudu v oboru. Platné obory jsou: ID předplatného nebo konkrétní ID prostředku (Podporované prostředky jsou: VirtualMachines, VMSS a ARC Machines a pouze pro plan='VirtualMachines' a subPlan='P1').
PUT 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 |
---|---|---|---|---|
pricing
|
path | True |
string |
název konfigurace cen |
scope
|
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 |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
properties.pricingTier | True |
Určuje, jestli je ve vybraném oboru povolený plán Defenderu. Microsoft Defender pro 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.enforce |
Pokud je nastavená hodnota Nepravda, umožní potomkům tohoto oboru přepsat cenovou konfiguraci nastavenou pro tento obor (umožňuje nastavení inherited="False"). Pokud je nastavená hodnota True, zabrání přepsání a vynutí tuto cenovou konfiguraci pro všechny potomky tohoto oboru. Toto pole je k dispozici pouze pro ceny na úrovni předplatného. |
||
properties.extensions |
Nepovinný parametr. Seznam rozšíření nabízených v rámci plánu |
||
properties.subPlan |
string |
Dílčí plán vybraný pro konfiguraci cen úrovně Standard, pokud je k dispozici více než jeden podplán. Každý podplán umožňuje sadu funkcí zabezpečení. Pokud není zadaný, použije se úplný plán. V případě plánu VirtualMachines jsou dostupné dílčí plány P1 & P2, kde pro úroveň prostředků se podporuje pouze dílčí plán P1. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Aktualizace se úspěšně aktualizovala. |
|
201 Created |
Vytvoření proběhlo úspěšně. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Update pricing on resource (example for VirtualMachines plan)
Sample Request
PUT 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
{
"properties": {
"pricingTier": "Standard",
"subPlan": "P1"
}
}
Sample Response
{
"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": "P1",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"inherited": "False",
"inheritedFrom": null,
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
}
}
]
}
}
{
"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": "P1",
"freeTrialRemainingTime": "PT0S",
"enablementTime": "2023-03-01T12:42:42.1921106Z",
"inherited": "False",
"inheritedFrom": null,
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{'Key':'TestKey1','Value':'TestValue1'},{'Key':'TestKey2','Value':'TestValue2'}]"
}
}
]
}
}
Update pricing on subscription (example for CloudPosture plan)
Sample Request
Sample Response
{
"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",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
{
"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",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
Update pricing on subscription (example for CloudPosture plan) - partial success
Sample Request
Sample Response
{
"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",
"operationStatus": {
"code": "Failed",
"message": "Failed find dedicated first party application client ID for extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {d5a2ae44-610b-4500-93be-660a0c5f5ca6} to {identityName} for plan"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {f58310d9-a9f6-439a-9e8d-f62e7b41a168} to {identityName} for plan"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
{
"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",
"operationStatus": {
"code": "Failed",
"message": "Failed find dedicated first party application client ID for extension"
}
},
{
"name": "AgentlessDiscoveryForKubernetes",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {d5a2ae44-610b-4500-93be-660a0c5f5ca6} to {identityName} for plan"
}
},
{
"name": "SensitiveDataDiscovery",
"isEnabled": "True",
"operationStatus": {
"code": "Failed",
"message": "Failed assigning roles {f58310d9-a9f6-439a-9e8d-f62e7b41a168} to {identityName} for plan"
}
},
{
"name": "ContainerRegistriesVulnerabilityAssessments",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
},
{
"name": "EntraPermissionsManagement",
"isEnabled": "True",
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
Update pricing on subscription (example for VirtualMachines plan)
Sample Request
Sample Response
{
"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": "True",
"resourcesCoverageStatus": "FullyCovered",
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
},
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
{
"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": "True",
"resourcesCoverageStatus": "FullyCovered",
"extensions": [
{
"name": "MdeDesignatedSubscription",
"isEnabled": "False"
},
{
"name": "AgentlessVmScanning",
"isEnabled": "True",
"additionalExtensionProperties": {
"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
},
"operationStatus": {
"code": "Succeeded",
"message": "Successfully enabled extension"
}
}
]
}
}
Definice
Name | Description |
---|---|
Cloud |
Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.) |
Cloud |
Podrobnosti o chybě. |
code |
Stavový kód operace. |
enforce |
Pokud je nastavená hodnota Nepravda, umožní potomkům tohoto oboru přepsat cenovou konfiguraci nastavenou pro tento obor (umožňuje nastavení inherited="False"). Pokud je nastavená hodnota True, zabrání přepsání a vynutí tuto cenovou konfiguraci pro všechny potomky tohoto oboru. Toto pole je k dispozici pouze pro ceny na úrovni předplatného. |
Error |
Další informace o chybě správy prostředků |
Extension |
Vlastnosti rozšíření plánu |
inherited |
"zděděno" = "True" znamená, ž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 "inheritedFrom". Na druhou stranu výraz "zděděný" = "Nepravda" znamená, že aktuální obor má explicitně nastavenou vlastní cenovou konfiguraci a nedědí z nadřazeného objektu. Toto pole je jen pro čtení a je k dispozici pouze pro ceny na úrovni prostředků. |
is |
Určuje, jestli je rozšíření povolené. |
Operation |
Stav popisující úspěch/selhání operace povolení/zakázání rozšíření. |
Pricing |
Microsoft Defender pro 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í. |
pricing |
Určuje, jestli je ve vybraném oboru povolený plán Defenderu. Microsoft Defender pro 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í. |
resources |
Toto pole je dostupné jenom pro úroveň předplatného a odráží stav pokrytí prostředků v rámci předplatného. Poznámka: Pole pricingTier odráží stav plánu předplatného. Vzhledem k tomu, že stav plánu je také možné definovat na úrovni prostředku, může dojít k neshodě mezi stavem plánu předplatného a stavem prostředku. Toto pole pomáhá určit stav pokrytí prostředků. |
CloudError
Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.)
Name | Typ | Description |
---|---|---|
error.additionalInfo |
Další informace o chybě |
|
error.code |
string |
Kód chyby |
error.details |
Podrobnosti o chybě |
|
error.message |
string |
Chybová zpráva |
error.target |
string |
Cíl chyby. |
CloudErrorBody
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě |
|
code |
string |
Kód chyby |
details |
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í nebylo úspěšně vytvořeno nebo aktualizováno. Další podrobnosti najdete v tématu Zpráva o stavu operace. |
Succeeded |
string |
Rozšíření bylo úspěšně vytvořeno nebo aktualizováno. |
enforce
Pokud je nastavená hodnota Nepravda, umožní potomkům tohoto oboru přepsat cenovou konfiguraci nastavenou pro tento obor (umožňuje nastavení inherited="False"). Pokud je nastavená hodnota True, zabrání přepsání a vynutí tuto cenovou konfiguraci pro všechny potomky tohoto oboru. Toto pole je k dispozici pouze pro ceny na úrovni předplatného.
Name | Typ | Description |
---|---|---|
False |
string |
Umožňuje potomkům tohoto oboru přepsat cenovou konfiguraci nastavenou pro tento obor (umožňuje nastavení inherited="False"). |
True |
string |
Zabrání přepsání a vynutí konfiguraci cen aktuálního oboru 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 |
Určuje, jestli je rozšíření povolené. |
|
name |
string |
Název rozšíření. Podporované hodnoty jsou: |
operationStatus |
Nepovinný parametr. Stav popisující úspěch/selhání operace povolení/zakázání rozšíření. |
inherited
"zděděno" = "True" znamená, ž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 "inheritedFrom". Na druhou stranu výraz "zděděný" = "Nepravda" znamená, že aktuální obor má explicitně nastavenou vlastní cenovou konfiguraci a nedědí z nadřazeného objektu. Toto pole je jen pro čtení a je k dispozici pouze pro ceny na úrovni prostředků.
Name | Typ | Description |
---|---|---|
False |
string |
Označuje, že aktuální obor nastavuje vlastní cenovou konfiguraci 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 objektu. |
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 rozšíření je povolené. |
OperationStatus
Stav popisující úspěch/selhání operace povolení/zakázání rozšíření.
Name | Typ | Description |
---|---|---|
code |
Stavový kód operace. |
|
message |
string |
Další informace týkající se úspěchu nebo selhání operace |
Pricing
Microsoft Defender pro 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 |
Nepovinný parametr. Hodnota True, pokud je plán zastaralý. Pokud se plány nahrazují, zobrazí se ve |
properties.enablementTime |
string |
Nepovinný parametr. Pokud |
properties.enforce |
Pokud je nastavená hodnota Nepravda, umožní potomkům tohoto oboru přepsat cenovou konfiguraci nastavenou pro tento obor (umožňuje nastavení inherited="False"). Pokud je nastavená hodnota True, zabrání přepsání a vynutí tuto cenovou konfiguraci pro všechny potomky tohoto oboru. Toto pole je k dispozici pouze pro ceny na úrovni předplatného. |
|
properties.extensions |
Nepovinný parametr. Seznam rozšíření nabízených v rámci plánu |
|
properties.freeTrialRemainingTime |
string |
Zbývající doba zkušebního období předplatných – ve formátu ISO 8601 (např. P3Y6M4DT12H30M5S). |
properties.inherited |
"zděděno" = "True" znamená, ž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 "inheritedFrom". Na druhou stranu výraz "zděděný" = "Nepravda" znamená, že aktuální obor má explicitně nastavenou vlastní cenovou konfiguraci a nedědí z nadřazeného objektu. Toto pole je jen pro čtení a je 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 |
Určuje, jestli je ve vybraném oboru povolený plán Defenderu. Microsoft Defender pro 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[] |
Nepovinný parametr. Seznam plánů, které tento plán nahrazují Tato vlastnost existuje pouze v případě, že je tento plán zastaralý. |
properties.resourcesCoverageStatus |
Toto pole je dostupné jenom pro úroveň předplatného a odráží stav pokrytí prostředků v rámci předplatného. Poznámka: Pole pricingTier odráží stav plánu předplatného. Vzhledem k tomu, že stav plánu je také možné definovat na úrovni prostředku, může dojít k neshodě mezi stavem plánu předplatného a stavem prostředku. Toto pole pomáhá určit 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 podplán. Každý podplán umožňuje sadu funkcí zabezpečení. Pokud není zadaný, použije se úplný plán. V případě plánu VirtualMachines jsou dostupné dílčí plány P1 & P2, kde pro úroveň prostředků se podporuje pouze dílčí plán P1. |
type |
string |
Typ prostředku |
pricingTier
Určuje, jestli je ve vybraném oboru povolený plán Defenderu. Microsoft Defender pro 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é Microsoft Defender pro cloud se základními funkcemi zabezpečení |
Standard |
string |
Získejte standardní prostředí Microsoft Defender pro cloud s pokročilými funkcemi zabezpečení. |
resourcesCoverageStatus
Toto pole je dostupné jenom pro úroveň předplatného a odráží stav pokrytí prostředků v rámci předplatného. Poznámka: Pole pricingTier odráží stav plánu předplatného. Vzhledem k tomu, že stav plánu je také možné definovat na úrovni prostředku, může dojít k neshodě mezi stavem plánu předplatného a stavem prostředku. Toto pole pomáhá určit 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 Defender, zatímco jiné ho mají zakázaný. Mezi prostředky je smíšený stav pokrytí. |