Pricings - Update

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

Aggiorna una configurazione dei prezzi di Microsoft Defender per il cloud fornita nell'ambito. Gli ambiti validi sono: ID sottoscrizione o ID risorsa specifico (le risorse supportate sono: "VirtualMachines, VMSS e ARC Machines" e solo per plan='VirtualMachines' e subPlan='P1').

PUT 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

L'identificatore Azure Resource Manager completamente qualificato della risorsa.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
properties.pricingTier True

PricingTier

Indica se il piano defender è abilitato nell'ambito selezionato. Microsoft Defender per il 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.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.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.

Risposte

Nome Tipo Descrizione
200 OK

Pricing

Operazione di aggiornamento 'Pricing' delle risorse riuscita
201 Created

Pricing

Risorse 'Pricing' crea un'operazione di successo
Other Status Codes

Common.CloudError

Risposta di errore imprevista.

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

Update pricing on resource (Container Registry ACR)
Update pricing on resource (example for Containers plan)
Update pricing on resource (example for VirtualMachines plan)
Update pricing on subscription (example for CloudPosture plan)
Update pricing on subscription (example for CloudPosture plan) - partial success
Update pricing on subscription (example for VirtualMachines plan)

Update pricing on resource (Container Registry ACR)

Esempio di richiesta

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myContainerRegistry/providers/Microsoft.Security/pricings/Containers?api-version=2024-01-01

{
  "properties": {
    "pricingTier": "Standard",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "ContainerIntegrityContribution",
        "isEnabled": "True"
      }
    ]
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "name": "Containers",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myContainerRegistry/providers/Microsoft.Security/pricings/Containers",
  "properties": {
    "enablementTime": "2025-01-14T16:35:12.4567890Z",
    "freeTrialRemainingTime": "P29DT23H55M",
    "inherited": "False",
    "inheritedFrom": null,
    "pricingTier": "Standard",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "ContainerIntegrityContribution",
        "isEnabled": "True"
      }
    ]
  }
}
Codice di stato:
201 
{
  "name": "Containers",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myContainerRegistry/providers/Microsoft.Security/pricings/Containers",
  "properties": {
    "enablementTime": "2025-01-14T16:35:12.4567890Z",
    "freeTrialRemainingTime": "P29DT23H55M",
    "inherited": "False",
    "inheritedFrom": null,
    "pricingTier": "Standard",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "ContainerIntegrityContribution",
        "isEnabled": "True"
      }
    ]
  }
}

Update pricing on resource (example for Containers plan)

Esempio di richiesta

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/demo-containers-rg/providers/Microsoft.ContainerService/managedClusters/demo-aks-cluster/providers/Microsoft.Security/pricings/Containers?api-version=2024-01-01

{
  "properties": {
    "pricingTier": "Standard",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "ContainerSensor",
        "isEnabled": "True"
      },
      {
        "name": "AgentlessDiscoveryForKubernetes",
        "isEnabled": "True"
      },
      {
        "name": "AgentlessVmScanning",
        "additionalExtensionProperties": {
          "ExclusionTags": "[]"
        },
        "isEnabled": "True"
      },
      {
        "name": "ContainerIntegrityContribution",
        "isEnabled": "True"
      }
    ]
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "name": "Containers",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/demo-containers-rg/providers/Microsoft.ContainerService/managedClusters/demo-aks-cluster/providers/Microsoft.Security/pricings/Containers",
  "properties": {
    "enablementTime": "2025-01-14T16:35:12.4567890Z",
    "freeTrialRemainingTime": "P29DT23H55M",
    "inherited": "False",
    "inheritedFrom": null,
    "pricingTier": "Standard",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "ContainerSensor",
        "isEnabled": "True"
      },
      {
        "name": "AgentlessDiscoveryForKubernetes",
        "isEnabled": "True"
      },
      {
        "name": "AgentlessVmScanning",
        "additionalExtensionProperties": {
          "ExclusionTags": "[]"
        },
        "isEnabled": "True"
      },
      {
        "name": "ContainerIntegrityContribution",
        "isEnabled": "True"
      }
    ]
  }
}
Codice di stato:
201 
{
  "name": "Containers",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/demo-containers-rg/providers/Microsoft.ContainerService/managedClusters/demo-aks-cluster/providers/Microsoft.Security/pricings/Containers",
  "properties": {
    "enablementTime": "2025-01-14T16:35:12.4567890Z",
    "freeTrialRemainingTime": "P30DT0H0M",
    "inherited": "False",
    "inheritedFrom": null,
    "pricingTier": "Standard",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "ContainerSensor",
        "isEnabled": "True"
      },
      {
        "name": "AgentlessDiscoveryForKubernetes",
        "isEnabled": "True"
      },
      {
        "name": "AgentlessVmScanning",
        "additionalExtensionProperties": {
          "ExclusionTags": "[]"
        },
        "isEnabled": "True"
      },
      {
        "name": "ContainerIntegrityContribution",
        "isEnabled": "True"
      }
    ]
  }
}

Update pricing on resource (example for VirtualMachines plan)

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200 
{
  "name": "virtualMachines",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/virtualMachines",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "freeTrialRemainingTime": "PT0S",
    "inherited": "False",
    "inheritedFrom": null,
    "pricingTier": "Standard",
    "subPlan": "P1",
    "extensions": [
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "False"
      },
      {
        "name": "AgentlessVmScanning",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
        },
        "isEnabled": "True"
      }
    ]
  }
}
Codice di stato:
201 
{
  "name": "virtualMachines",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/virtualMachines",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "freeTrialRemainingTime": "PT0S",
    "inherited": "False",
    "inheritedFrom": null,
    "pricingTier": "Standard",
    "subPlan": "P1",
    "extensions": [
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "False"
      },
      {
        "name": "AgentlessVmScanning",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{'Key':'TestKey1','Value':'TestValue1'},{'Key':'TestKey2','Value':'TestValue2'}]"
        },
        "isEnabled": "True"
      }
    ]
  }
}

Update pricing on subscription (example for CloudPosture plan)

Esempio di richiesta

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

{
  "properties": {
    "pricingTier": "Standard"
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "name": "CloudPosture",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "freeTrialRemainingTime": "PT0S",
    "pricingTier": "Standard",
    "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"
        }
      }
    ]
  }
}
Codice di stato:
201 
{
  "name": "CloudPosture",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "freeTrialRemainingTime": "PT0S",
    "pricingTier": "Standard",
    "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

Esempio di richiesta

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

{
  "properties": {
    "pricingTier": "Standard"
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "name": "CloudPosture",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "freeTrialRemainingTime": "PT0S",
    "pricingTier": "Standard",
    "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"
        }
      }
    ]
  }
}
Codice di stato:
201 
{
  "name": "CloudPosture",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "freeTrialRemainingTime": "PT0S",
    "pricingTier": "Standard",
    "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)

Esempio di richiesta

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

{
  "properties": {
    "enforce": "True",
    "pricingTier": "Standard",
    "subPlan": "P2"
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "name": "VirtualMachines",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "True",
    "freeTrialRemainingTime": "PT0S",
    "pricingTier": "Standard",
    "resourcesCoverageStatus": "FullyCovered",
    "subPlan": "P2",
    "extensions": [
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "False"
      },
      {
        "name": "AgentlessVmScanning",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
        },
        "isEnabled": "True",
        "operationStatus": {
          "code": "Succeeded",
          "message": "Successfully enabled extension"
        }
      }
    ]
  }
}
Codice di stato:
201 
{
  "name": "VirtualMachines",
  "type": "Microsoft.Security/pricings",
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines",
  "properties": {
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "True",
    "freeTrialRemainingTime": "PT0S",
    "pricingTier": "Standard",
    "resourcesCoverageStatus": "FullyCovered",
    "subPlan": "P2",
    "extensions": [
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "False"
      },
      {
        "name": "AgentlessVmScanning",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
        },
        "isEnabled": "True",
        "operationStatus": {
          "code": "Succeeded",
          "message": "Successfully enabled extension"
        }
      }
    ]
  }
}

Definizioni

Nome Descrizione
Common.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.
Common.CloudErrorBody

Dettagli dell'errore.
Common.OperationStatus

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

Tipo di identità che ha creato la risorsa.
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.
Pricing

Microsoft Defender per il 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 il 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.
systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Common.CloudError

Oggetto

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

Common.CloudErrorBody[]

Dettagli dell'errore.
error.message

string

Messaggio di errore.
error.target

string

Destinazione dell'errore.

Common.CloudErrorBody

Oggetto

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

Common.CloudErrorBody[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

Common.OperationStatus

Oggetto

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

Nome Tipo Descrizione
code

string

Codice di stato dell'operazione.
message

string

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

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

Enforce

Enumerazione

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.

Valore Descrizione
False

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

Impedisce l'override e forza la configurazione dei prezzi dell'ambito corrente in tutti i discendenti

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

Extension

Oggetto

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 fluida tra Defender per Endpoint e Defender per il cloud che non richiede ulteriore distribuzione software sui tuoi 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

Common.OperationStatus

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

Inherited

Enumerazione

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

Valore Descrizione
True

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

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

IsEnabled

Enumerazione

Indica se l'estensione è abilitata.

Valore Descrizione
True

Indica che l'estensione è abilitata
False

Indica che l'estensione è disabilitata

Pricing

Oggetto

Microsoft Defender per il 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 (arm-id)

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Nome della risorsa
properties.deprecated

boolean

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

string (date-time)

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 (duration)

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 per il 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.
systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PricingTier

Enumerazione

Indica se il piano defender è abilitato nell'ambito selezionato. Microsoft Defender per il 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.

Valore Descrizione
Free

Ottenere un'esperienza gratuita di Microsoft Defender per il cloud con funzionalità di sicurezza di base
Standard

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

ResourcesCoverageStatus

Enumerazione

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.

Valore Descrizione
FullyCovered

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

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.
NotCovered

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

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string (date-time)

Timestamp della creazione della risorsa (UTC).
createdBy

string

Identità che ha creato la risorsa.
createdByType

createdByType

Tipo di identità che ha creato la risorsa.
lastModifiedAt

string (date-time)

Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.