Pricings - Get

  • Riferimento
Service:
Defender for Cloud
API Version:
2024-01-01

Ottenere le configurazioni dei prezzi dei piani di Defender dell'ambito selezionato (gli ambiti validi sono ID risorsa o ID sottoscrizione). A livello di risorsa, i tipi di risorse supportati sono "VirtualMachines, VMSS e ARC Machines".

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
pricingName
 path True

string

nome della configurazione dei prezzi
scopeId
 path True

string

ID ambito dei prezzi. Gli ambiti validi sono: sottoscrizione (formato: 'subscriptions/{subscriptionId}') o una risorsa specifica (formato: 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) - Le risorse supportate sono (VirtualMachines)
api-version
 query True

string

Versione dell'API per l'operazione

Risposte

Nome Tipo Descrizione
200 OK

Pricing

OK
Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

Nome Descrizione
CloudError

Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.
CloudErrorBody

Dettagli dell'errore.
code

Codice di stato dell'operazione.
enforce

Se impostato su "False", consente ai discendenti di questo ambito di eseguire l'override della configurazione dei prezzi impostata in questo ambito (consente l'impostazione ereditata="False"). Se impostato su "True", impedisce l'override e forza questa configurazione dei prezzi in tutti i discendenti di questo ambito. Questo campo è disponibile solo per i prezzi a livello di sottoscrizione.
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
Extension

Proprietà di estensione di un piano
inherited

"inherited" = "True" indica che l'ambito corrente eredita la configurazione dei prezzi dal relativo elemento padre. L'ID dell'ambito padre che fornisce la configurazione ereditata viene visualizzato nel campo "inheritedFrom". D'altra parte, "ereditato" = "False" indica che l'ambito corrente ha una propria configurazione dei prezzi impostata in modo esplicito e non eredita dal relativo elemento padre. Questo campo è di sola lettura e disponibile solo per i prezzi a livello di risorsa.
isEnabled

Indica se l'estensione è abilitata.
OperationStatus

Stato che descrive l'esito positivo/negativo dell'operazione di abilitazione/disabilitazione dell'estensione.
Pricing

Microsoft Defender per cloud è disponibile in due piani tariffari: gratuito e standard. Il livello Standard offre funzionalità di sicurezza avanzate, mentre il livello gratuito offre funzionalità di sicurezza di base.
pricingTier

Indica se il piano defender è abilitato nell'ambito selezionato. Microsoft Defender per cloud è disponibile in due piani tariffari: gratuito e standard. Il livello Standard offre funzionalità di sicurezza avanzate, mentre il livello gratuito offre funzionalità di sicurezza di base.
resourcesCoverageStatus

Questo campo è disponibile solo a livello di sottoscrizione e riflette lo stato di copertura delle risorse nella sottoscrizione. Nota: il campo "pricingTier" riflette lo stato del piano della sottoscrizione. Tuttavia, poiché lo stato del piano può essere definito anche a livello di risorsa, potrebbe verificarsi un disallineamento tra lo stato del piano della sottoscrizione e lo stato della risorsa. Questo campo consente di indicare lo stato di copertura delle risorse.

CloudError

Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

Nome Tipo Descrizione
error.additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
error.code

string

Codice di errore.
error.details

CloudErrorBody[]

Dettagli dell'errore.
error.message

string

Messaggio di errore.
error.target

string

Destinazione dell'errore.

CloudErrorBody

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

CloudErrorBody[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

code

Codice di stato dell'operazione.

Nome Tipo Descrizione
Failed

string

L'estensione non è stata creata/aggiornata correttamente. Per altri dettagli, vedere il messaggio di stato dell'operazione.
Succeeded

string

L'estensione è stata creata/aggiornata correttamente.

enforce

Se impostato su "False", consente ai discendenti di questo ambito di eseguire l'override della configurazione dei prezzi impostata in questo ambito (consente l'impostazione ereditata="False"). Se impostato su "True", impedisce l'override e forza questa configurazione dei prezzi in tutti i discendenti di questo ambito. Questo campo è disponibile solo per i prezzi a livello di sottoscrizione.

Nome Tipo Descrizione
False

string

Consente ai discendenti di questo ambito di eseguire l'override della configurazione dei prezzi impostata in questo ambito (consente l'impostazione inherited="False")
True

string

Impedisce le sostituzioni e forza la configurazione dei prezzi dell'ambito corrente a tutti i discendenti

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

Extension

Proprietà di estensione di un piano

Nome Tipo Descrizione
additionalExtensionProperties

Valori di proprietà associati all'estensione.
isEnabled

isEnabled

Indica se l'estensione è abilitata.
name

string

Nome dell'estensione. I valori supportati sono:

AgentlessDiscoveryForKubernetes : individuazione basata su API delle informazioni sull'architettura del cluster Kubernetes, sugli oggetti del carico di lavoro e sulla configurazione. Obbligatorio per l'inventario, l'identità e il rilevamento dell'esposizione alla rete, l'analisi dei percorsi di attacco e la ricerca dei rischi come parte di Esplora sicurezza cloud. Disponibile per il piano CloudPosture.

OnUploadMalwareScanning : limita i GB da analizzare al mese per ogni account di archiviazione all'interno della sottoscrizione. Una volta raggiunto questo limite per un determinato account di archiviazione, i BLOB non verranno analizzati durante il mese di calendario corrente. Disponibile per il piano StorageAccounts.

SensitiveDataDiscovery : l'individuazione dei dati sensibili identifica il contenitore di archiviazione BLOB con dati sensibili, ad esempio credenziali, carte di credito e altro ancora, per definire le priorità e analizzare gli eventi di sicurezza. Disponibile per i piani StorageAccounts e CloudPosture.

ContainerRegistriesVulnerabilityAssessments : fornisce la gestione delle vulnerabilità per le immagini archiviate nei registri contenitori. Disponibile per i piani CloudPosture e Contenitori.
operationStatus

OperationStatus

facoltativo. Stato che descrive l'esito positivo/negativo dell'operazione di abilitazione/disabilitazione dell'estensione.

inherited

"inherited" = "True" indica che l'ambito corrente eredita la configurazione dei prezzi dal relativo elemento padre. L'ID dell'ambito padre che fornisce la configurazione ereditata viene visualizzato nel campo "inheritedFrom". D'altra parte, "ereditato" = "False" indica che l'ambito corrente ha una propria configurazione dei prezzi impostata in modo esplicito e non eredita dal relativo elemento padre. Questo campo è di sola lettura e disponibile solo per i prezzi a livello di risorsa.

Nome Tipo Descrizione
False

string

Indica che l'ambito corrente imposta la propria configurazione dei prezzi e non lo eredita dal padre
True

string

Indica che l'ambito corrente eredita la configurazione dei prezzi dal relativo elemento padre

isEnabled

Indica se l'estensione è abilitata.

Nome Tipo Descrizione
False

string

Indica che l'estensione è disabilitata
True

string

Indica che l'estensione è abilitata

OperationStatus

Stato che descrive l'esito positivo/negativo dell'operazione di abilitazione/disabilitazione dell'estensione.

Nome Tipo Descrizione
code

code

Codice di stato dell'operazione.
message

string

Informazioni aggiuntive relative all'esito positivo/negativo dell'operazione.

Pricing

Microsoft Defender per cloud è disponibile in due piani tariffari: gratuito e standard. Il livello Standard offre funzionalità di sicurezza avanzate, mentre il livello gratuito offre funzionalità di sicurezza di base.

Nome Tipo Descrizione
id

string

ID risorsa
name

string

Nome risorsa
properties.deprecated

boolean

facoltativo. True se il piano è deprecato. Se sono presenti piani sostitutivi, verranno visualizzati nella replacedBy proprietà
properties.enablementTime

string

facoltativo. Se pricingTier è Standard allora questa proprietà contiene la data dell'ultima volta in cui è pricingTier stato impostato Standardsu , se disponibile ,ad esempio 2023-03-01T12:42:42.1921106Z.
properties.enforce

enforce

Se impostato su "False", consente ai discendenti di questo ambito di eseguire l'override della configurazione dei prezzi impostata in questo ambito (consente l'impostazione ereditata="False"). Se impostato su "True", impedisce l'override e forza questa configurazione dei prezzi in tutti i discendenti di questo ambito. Questo campo è disponibile solo per i prezzi a livello di sottoscrizione.
properties.extensions

Extension[]

facoltativo. Elenco delle estensioni offerte in un piano.
properties.freeTrialRemainingTime

string

Durata rimanente per il periodo di valutazione gratuita delle sottoscrizioni, nel formato ISO 8601 ,ad esempio P3Y6M4DT12H30M5S.
properties.inherited

inherited

"inherited" = "True" indica che l'ambito corrente eredita la configurazione dei prezzi dal relativo elemento padre. L'ID dell'ambito padre che fornisce la configurazione ereditata viene visualizzato nel campo "inheritedFrom". D'altra parte, "ereditato" = "False" indica che l'ambito corrente ha una propria configurazione dei prezzi impostata in modo esplicito e non eredita dal relativo elemento padre. Questo campo è di sola lettura e disponibile solo per i prezzi a livello di risorsa.
properties.inheritedFrom

string

ID dell'ambito ereditato da . "Null" se non ereditato. Questo campo è disponibile solo per i prezzi a livello di risorsa.
properties.pricingTier

pricingTier

Indica se il piano defender è abilitato nell'ambito selezionato. Microsoft Defender per cloud è disponibile in due piani tariffari: gratuito e standard. Il livello Standard offre funzionalità di sicurezza avanzate, mentre il livello gratuito offre funzionalità di sicurezza di base.
properties.replacedBy

string[]

facoltativo. Elenco di piani che sostituiscono questo piano. Questa proprietà esiste solo se questo piano è deprecato.
properties.resourcesCoverageStatus

resourcesCoverageStatus

Questo campo è disponibile solo a livello di sottoscrizione e riflette lo stato di copertura delle risorse nella sottoscrizione. Nota: il campo "pricingTier" riflette lo stato del piano della sottoscrizione. Tuttavia, poiché lo stato del piano può essere definito anche a livello di risorsa, potrebbe verificarsi un disallineamento tra lo stato del piano della sottoscrizione e lo stato della risorsa. Questo campo consente di indicare lo stato di copertura delle risorse.
properties.subPlan

string

Piano secondario selezionato per una configurazione dei prezzi Standard, quando è disponibile più di un piano secondario. Ogni piano secondario abilita un set di funzionalità di sicurezza. Se non specificato, viene applicato il piano completo. Per il piano VirtualMachines, i piani secondari disponibili sono "P1" & "P2", dove per il piano secondario "P1" è supportato solo il livello di risorsa.
type

string

Tipo di risorsa

pricingTier

Indica se il piano defender è abilitato nell'ambito selezionato. Microsoft Defender per cloud è disponibile in due piani tariffari: gratuito e standard. Il livello Standard offre funzionalità di sicurezza avanzate, mentre il livello gratuito offre funzionalità di sicurezza di base.

Nome Tipo Descrizione
Free

string

Ottenere Microsoft Defender gratuito per l'esperienza cloud con funzionalità di sicurezza di base
Standard

string

Ottenere la Microsoft Defender standard per l'esperienza cloud con funzionalità di sicurezza avanzate

resourcesCoverageStatus

Questo campo è disponibile solo a livello di sottoscrizione e riflette lo stato di copertura delle risorse nella sottoscrizione. Nota: il campo "pricingTier" riflette lo stato del piano della sottoscrizione. Tuttavia, poiché lo stato del piano può essere definito anche a livello di risorsa, potrebbe verificarsi un disallineamento tra lo stato del piano della sottoscrizione e lo stato della risorsa. Questo campo consente di indicare lo stato di copertura delle risorse.

Nome Tipo Descrizione
FullyCovered

string

Questo valore indica che tutte le risorse associate alla sottoscrizione hanno il piano Defender abilitato.
NotCovered

string

Questo valore indica che il piano defender è disabilitato per tutte le risorse nella sottoscrizione. Nessuna delle risorse è protetta dal piano Defender.
PartiallyCovered

string

Questo valore indica che alcune risorse nella sottoscrizione hanno il piano Defender abilitato, mentre altri lo hanno disabilitato. Tra le risorse è presente uno stato di copertura misto.