Condividi tramite

Pricings - Get

  • Riferimento
Servizio:
Defender for Cloud
Versione API:
2024-01-01

Ottenere le configurazioni dei prezzi dei piani di Defender dell'ambito selezionato (gli ambiti validi sono l'ID risorsa o un 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

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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 di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo 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à dell'estensione di un piano
inherited

"ereditato" = "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 la 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 for 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 for 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 errore di allineamento 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 di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo 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 del set di configurazione dei prezzi in questo ambito (consente l'impostazione ereditata="False")
True

string

Impedisce l'override e forza la configurazione dei prezzi dell'ambito corrente in 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à dell'estensione di un piano

Nome Tipo Descrizione
additionalExtensionProperties

Valori delle proprietà associati all'estensione.
isEnabled

isEnabled

Indica se l'estensione è abilitata.
name

string

Nome dell'estensione. I valori supportati sono:

AgentlessDiscoveryForKubernetes: fornisce un footprint zero, l'individuazione basata su API dei cluster Kubernetes, le relative configurazioni e distribuzioni. I dati raccolti vengono usati per creare un grafico di sicurezza contestualizzato per i cluster Kubernetes, fornire funzionalità di ricerca dei rischi e visualizzare rischi e minacce per ambienti e carichi di lavoro Kubernetes.
Disponibile per il piano CloudPosture e il piano contenitori.

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 (piani secondari DefenderForStorageV2).

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 il piano StorageAccounts (piano secondario DefenderForStorageV2) e il piano CloudPosture.

ContainerRegistriesVulnerabilityAssessments : fornisce la gestione delle vulnerabilità per le immagini archiviate nei registri contenitori.
Disponibile per il piano CloudPosture e il piano contenitori.

MdeDesignatedSubscription: l'onboarding diretto è un'integrazione perfetta tra Defender per endpoint e Defender for Cloud che non richiede una distribuzione software aggiuntiva nei server. Le risorse di cui è stato eseguito l'onboarding verranno presentate in una sottoscrizione di Azure designata configurata
Disponibile per il piano VirtualMachines (piani secondari P1 e P2).

AgentlessVmScanning: analizza i computer per individuare software, vulnerabilità, malware e analisi dei segreti installati senza basarsi su agenti o influire sulle prestazioni del computer. Altre informazioni sono disponibili qui https://learn.microsoft.com/en-us/azure/defender-for-cloud/concept-agentless-data-collection.
Disponibile per il piano CloudPosture, il piano VirtualMachines (piano secondario P2) e il piano Contenitori.

EntraPermissionsManagement - Gestione delle autorizzazioni offre funzionalità CIEM (Cloud Infrastructure Entitlement Management) che consentono alle organizzazioni di gestire e controllare l'accesso e i diritti degli utenti nell'infrastruttura cloud, importante vettore di attacco per gli ambienti cloud.
Gestione autorizzazioni analizza tutte le autorizzazioni e l'utilizzo attivo e suggerisce raccomandazioni per ridurre le autorizzazioni per applicare il principio dei privilegi minimi. Altre informazioni sono disponibili qui https://learn.microsoft.com/en-us/azure/defender-for-cloud/permissions-management.
Disponibile per il piano CloudPosture.

FileIntegrityMonitoring - Monitoraggio dell'integrità dei file (FIM), esamina i file del sistema operativo.
Registri di Windows, file di sistema Linux, in tempo reale, per le modifiche che potrebbero indicare un attacco.
Disponibile per il piano VirtualMachines (piano secondario P2).

ContainerSensor: il sensore si basa su IG e offre una suite di rilevamento delle minacce avanzata per cluster, nodi e carichi di lavoro Kubernetes, basati sull'intelligence sulle minacce leader di Microsoft, fornisce il mapping al framework MITRE ATT&CK.
Disponibile per il piano Contenitori.

aiPromptEvidence: espone le richieste passate tra l'utente e il modello di intelligenza artificiale come evidenza degli avvisi. Ciò consente di classificare e valutare gli avvisi con il contesto utente pertinente. I frammenti di richiesta includono solo i segmenti della richiesta dell'utente o della risposta del modello ritenuti sospetti e rilevanti per le classificazioni di sicurezza. L'evidenza della richiesta sarà disponibile tramite il portale di Defender come parte di ogni avviso.
Disponibile per il piano di intelligenza artificiale.

operationStatus

OperationStatus

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

inherited

"ereditato" = "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 la 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 for 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

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

string

Opzionale. Se pricingTier è Standard, questa proprietà contiene la data dell'ultima volta in cui il pricingTier è stato impostato su Standard, 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[]

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

string

Durata lasciata per il periodo di valutazione gratuita delle sottoscrizioni, in formato ISO 8601 (ad esempio, P3Y6M4DT12H30M5S).
properties.inherited

inherited

"ereditato" = "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 la 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 for 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[]

Opzionale. 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 errore di allineamento 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 sotto piani 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 for 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 un'esperienza gratuita di Microsoft Defender for Cloud con funzionalità di sicurezza di base
Standard

string

Ottenere l'esperienza standard di Microsoft Defender for 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 errore di allineamento 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.