Pricings - Update

Service:

Defender for Cloud

API-versie:

2024-01-01

Hiermee wordt een opgegeven microsoft Defender for Cloud-prijsconfiguratie in het bereik bijgewerkt. Geldige bereiken zijn: abonnements-id of een specifieke resource-id (Ondersteunde resources zijn: 'VirtualMachines, VMSS en ARC-machines' en alleen voor plan='VirtualMachines' en subPlan='P1').

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

URI-parameters

Name	In	Vereist	Type	Description
pricingName	path	True	string	naam van de prijsconfiguratie
scopeId	path	True	string	De bereik-id van de prijzen. Geldige bereiken zijn: abonnement (indeling: 'subscriptions/{subscriptionId}' of een specifieke resource (indeling: 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) - Ondersteunde resources zijn (VirtualMachines)
api-version	query	True	string	API-versie voor de bewerking

Aanvraagbody

Name	Vereist	Type	Description
properties.pricingTier	True	pricingTier	Hiermee wordt aangegeven of het Defender-plan is ingeschakeld voor het geselecteerde bereik. Microsoft Defender voor Cloud is beschikbaar in twee prijscategorieën: gratis en standaard. De standard-laag biedt geavanceerde beveiligingsmogelijkheden, terwijl de gratis laag basisbeveiligingsfuncties biedt.
properties.enforce		enforce	Als deze optie is ingesteld op Onwaar, kunnen de afstammelingen van dit bereik de prijsconfiguratie voor dit bereik overschrijven (staat instelling overgenomen="False" toe). Als deze optie is ingesteld op 'Waar', voorkomt u onderdrukkingen en dwingt u deze prijsconfiguratie af op alle afstammelingen van dit bereik. Dit veld is alleen beschikbaar voor prijzen op abonnementsniveau.
properties.extensions		Extension[]	Facultatief. Lijst met extensies die worden aangeboden onder een plan.
properties.subPlan		string	Het subabonnement dat is geselecteerd voor een standard-prijsconfiguratie, wanneer er meer dan één subabonnement beschikbaar is. Elk subplan maakt een set beveiligingsfuncties mogelijk. Wanneer dit niet is opgegeven, wordt een volledig plan toegepast. Voor het VirtualMachines-plan zijn de beschikbare subplannen P1 & 'P2', waarbij voor het resourceniveau alleen het subplan P1 wordt ondersteund.

Antwoorden

Name	Type	Description
200 OK	Pricing	Bijgewerkt
201 Created	Pricing	Gemaakt.
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

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 (example for VirtualMachines plan)

Voorbeeldaanvraag

HTTP

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

Java

import com.azure.resourcemanager.security.fluent.models.PricingInner;
import com.azure.resourcemanager.security.models.PricingTier;

/**
 * Samples for Pricings Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/
     * PutResourcePricingByNameVirtualMachines_example.json
     */
    /**
     * Sample code: Update pricing on resource (example for VirtualMachines plan).
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void updatePricingOnResourceExampleForVirtualMachinesPlan(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.pricings().updateWithResponse(
            "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1",
            "virtualMachines", new PricingInner().withPricingTier(PricingTier.STANDARD).withSubPlan("P1"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsecurity_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutResourcePricingByNameVirtualMachines_example.json
func ExamplePricingsClient_Update_updatePricingOnResourceExampleForVirtualMachinesPlan() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewPricingsClient().Update(ctx, "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1", "virtualMachines", armsecurity.Pricing{
		Properties: &armsecurity.PricingProperties{
			PricingTier: to.Ptr(armsecurity.PricingTierStandard),
			SubPlan:     to.Ptr("P1"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Pricing = armsecurity.Pricing{
	// 	Name: to.Ptr("virtualMachines"),
	// 	Type: to.Ptr("Microsoft.Security/pricings"),
	// 	ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/virtualMachines"),
	// 	Properties: &armsecurity.PricingProperties{
	// 		EnablementTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-03-01T12:42:42.192Z"); return t}()),
	// 		FreeTrialRemainingTime: to.Ptr("PT0S"),
	// 		Inherited: to.Ptr(armsecurity.InheritedFalse),
	// 		PricingTier: to.Ptr(armsecurity.PricingTierStandard),
	// 		SubPlan: to.Ptr("P1"),
	// 		Extensions: []*armsecurity.Extension{
	// 			{
	// 				Name: to.Ptr("MdeDesignatedSubscription"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledFalse),
	// 			},
	// 			{
	// 				Name: to.Ptr("AgentlessVmScanning"),
	// 				AdditionalExtensionProperties: map[string]any{
	// 					"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]",
	// 				},
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 		}},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 *
 * @summary Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutResourcePricingByNameVirtualMachines_example.json
 */
async function updatePricingOnResourceExampleForVirtualMachinesPlan() {
  const scopeId =
    "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1";
  const pricingName = "virtualMachines";
  const pricing = { pricingTier: "Standard", subPlan: "P1" };
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const result = await client.pricings.update(scopeId, pricingName, pricing);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

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

Statuscode:

201

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

Voorbeeldaanvraag

HTTP

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

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

Java

import com.azure.resourcemanager.security.fluent.models.PricingInner;
import com.azure.resourcemanager.security.models.PricingTier;

/**
 * Samples for Pricings Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/
     * PutPricingByName_example.json
     */
    /**
     * Sample code: Update pricing on subscription (example for CloudPosture plan).
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void updatePricingOnSubscriptionExampleForCloudPosturePlan(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.pricings().updateWithResponse("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", "CloudPosture",
            new PricingInner().withPricingTier(PricingTier.STANDARD), com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsecurity_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutPricingByName_example.json
func ExamplePricingsClient_Update_updatePricingOnSubscriptionExampleForCloudPosturePlan() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewPricingsClient().Update(ctx, "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", "CloudPosture", armsecurity.Pricing{
		Properties: &armsecurity.PricingProperties{
			PricingTier: to.Ptr(armsecurity.PricingTierStandard),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Pricing = armsecurity.Pricing{
	// 	Name: to.Ptr("CloudPosture"),
	// 	Type: to.Ptr("Microsoft.Security/pricings"),
	// 	ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture"),
	// 	Properties: &armsecurity.PricingProperties{
	// 		EnablementTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-03-01T12:42:42.192Z"); return t}()),
	// 		Enforce: to.Ptr(armsecurity.EnforceFalse),
	// 		FreeTrialRemainingTime: to.Ptr("PT0S"),
	// 		PricingTier: to.Ptr(armsecurity.PricingTierStandard),
	// 		ResourcesCoverageStatus: to.Ptr(armsecurity.ResourcesCoverageStatusFullyCovered),
	// 		Extensions: []*armsecurity.Extension{
	// 			{
	// 				Name: to.Ptr("AgentlessVmScanning"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("AgentlessDiscoveryForKubernetes"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("SensitiveDataDiscovery"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("ContainerRegistriesVulnerabilityAssessments"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("EntraPermissionsManagement"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 		}},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 *
 * @summary Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutPricingByName_example.json
 */
async function updatePricingOnSubscriptionExampleForCloudPosturePlan() {
  const scopeId = "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23";
  const pricingName = "CloudPosture";
  const pricing = { pricingTier: "Standard" };
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const result = await client.pricings.update(scopeId, pricingName, pricing);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

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

Statuscode:

201

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

Voorbeeldaanvraag

HTTP

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

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

Java

import com.azure.resourcemanager.security.fluent.models.PricingInner;
import com.azure.resourcemanager.security.models.PricingTier;

/**
 * Samples for Pricings Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/
     * PutPricingByNamePartialSuccess_example.json
     */
    /**
     * Sample code: Update pricing on subscription (example for CloudPosture plan) - partial success.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void updatePricingOnSubscriptionExampleForCloudPosturePlanPartialSuccess(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.pricings().updateWithResponse("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", "CloudPosture",
            new PricingInner().withPricingTier(PricingTier.STANDARD), com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsecurity_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutPricingByNamePartialSuccess_example.json
func ExamplePricingsClient_Update_updatePricingOnSubscriptionExampleForCloudPosturePlanPartialSuccess() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewPricingsClient().Update(ctx, "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", "CloudPosture", armsecurity.Pricing{
		Properties: &armsecurity.PricingProperties{
			PricingTier: to.Ptr(armsecurity.PricingTierStandard),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Pricing = armsecurity.Pricing{
	// 	Name: to.Ptr("CloudPosture"),
	// 	Type: to.Ptr("Microsoft.Security/pricings"),
	// 	ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture"),
	// 	Properties: &armsecurity.PricingProperties{
	// 		EnablementTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-03-01T12:42:42.192Z"); return t}()),
	// 		Enforce: to.Ptr(armsecurity.EnforceFalse),
	// 		FreeTrialRemainingTime: to.Ptr("PT0S"),
	// 		PricingTier: to.Ptr(armsecurity.PricingTierStandard),
	// 		ResourcesCoverageStatus: to.Ptr(armsecurity.ResourcesCoverageStatusFullyCovered),
	// 		Extensions: []*armsecurity.Extension{
	// 			{
	// 				Name: to.Ptr("AgentlessVmScanning"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeFailed),
	// 					Message: to.Ptr("Failed find dedicated first party application client ID for extension"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("AgentlessDiscoveryForKubernetes"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeFailed),
	// 					Message: to.Ptr("Failed assigning roles {d5a2ae44-610b-4500-93be-660a0c5f5ca6} to {identityName} for plan"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("SensitiveDataDiscovery"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeFailed),
	// 					Message: to.Ptr("Failed assigning roles {f58310d9-a9f6-439a-9e8d-f62e7b41a168} to {identityName} for plan"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("ContainerRegistriesVulnerabilityAssessments"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("EntraPermissionsManagement"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 		}},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 *
 * @summary Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutPricingByNamePartialSuccess_example.json
 */
async function updatePricingOnSubscriptionExampleForCloudPosturePlanPartialSuccess() {
  const scopeId = "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23";
  const pricingName = "CloudPosture";
  const pricing = { pricingTier: "Standard" };
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const result = await client.pricings.update(scopeId, pricingName, pricing);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

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

Statuscode:

201

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

Voorbeeldaanvraag

HTTP

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

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

Java

import com.azure.resourcemanager.security.fluent.models.PricingInner;
import com.azure.resourcemanager.security.models.Enforce;
import com.azure.resourcemanager.security.models.PricingTier;

/**
 * Samples for Pricings Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/
     * PutPricingVMsByName_example.json
     */
    /**
     * Sample code: Update pricing on subscription (example for VirtualMachines plan).
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void updatePricingOnSubscriptionExampleForVirtualMachinesPlan(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.pricings().updateWithResponse("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", "VirtualMachines",
            new PricingInner().withPricingTier(PricingTier.STANDARD).withSubPlan("P2").withEnforce(Enforce.TRUE),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsecurity_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutPricingVMsByName_example.json
func ExamplePricingsClient_Update_updatePricingOnSubscriptionExampleForVirtualMachinesPlan() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewPricingsClient().Update(ctx, "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", "VirtualMachines", armsecurity.Pricing{
		Properties: &armsecurity.PricingProperties{
			Enforce:     to.Ptr(armsecurity.EnforceTrue),
			PricingTier: to.Ptr(armsecurity.PricingTierStandard),
			SubPlan:     to.Ptr("P2"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Pricing = armsecurity.Pricing{
	// 	Name: to.Ptr("VirtualMachines"),
	// 	Type: to.Ptr("Microsoft.Security/pricings"),
	// 	ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines"),
	// 	Properties: &armsecurity.PricingProperties{
	// 		EnablementTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-03-01T12:42:42.192Z"); return t}()),
	// 		Enforce: to.Ptr(armsecurity.EnforceTrue),
	// 		FreeTrialRemainingTime: to.Ptr("PT0S"),
	// 		PricingTier: to.Ptr(armsecurity.PricingTierStandard),
	// 		ResourcesCoverageStatus: to.Ptr(armsecurity.ResourcesCoverageStatusFullyCovered),
	// 		SubPlan: to.Ptr("P2"),
	// 		Extensions: []*armsecurity.Extension{
	// 			{
	// 				Name: to.Ptr("MdeDesignatedSubscription"),
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledFalse),
	// 			},
	// 			{
	// 				Name: to.Ptr("AgentlessVmScanning"),
	// 				AdditionalExtensionProperties: map[string]any{
	// 					"ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]",
	// 				},
	// 				IsEnabled: to.Ptr(armsecurity.IsEnabledTrue),
	// 				OperationStatus: &armsecurity.OperationStatusAutoGenerated{
	// 					Code: to.Ptr(armsecurity.CodeSucceeded),
	// 					Message: to.Ptr("Successfully enabled extension"),
	// 				},
	// 		}},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 *
 * @summary Updates a provided Microsoft Defender for Cloud pricing configuration in the scope. Valid scopes are: subscription id or a specific resource id (Supported resources are: 'VirtualMachines, VMSS and ARC Machines' and only for plan='VirtualMachines' and subPlan='P1').
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2024-01-01/examples/Pricings/PutPricingVMsByName_example.json
 */
async function updatePricingOnSubscriptionExampleForVirtualMachinesPlan() {
  const scopeId = "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23";
  const pricingName = "VirtualMachines";
  const pricing = {
    enforce: "True",
    pricingTier: "Standard",
    subPlan: "P2",
  };
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const result = await client.pricings.update(scopeId, pricingName, pricing);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

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

Statuscode:

201

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

Definities

Name	Description
CloudError	Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)
CloudErrorBody	De foutdetails.
code	De bewerkingsstatuscode.
enforce	Als deze optie is ingesteld op Onwaar, kunnen de afstammelingen van dit bereik de prijsconfiguratie voor dit bereik overschrijven (staat instelling overgenomen="False" toe). Als deze optie is ingesteld op 'Waar', voorkomt u onderdrukkingen en dwingt u deze prijsconfiguratie af op alle afstammelingen van dit bereik. Dit veld is alleen beschikbaar voor prijzen op abonnementsniveau.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
Extension	Uitbreidingseigenschappen van een plan
inherited	"overgenomen" = "True" geeft aan dat het huidige bereik de prijsconfiguratie van het bovenliggende bereik overneemt. De id van het bovenliggende bereik dat de overgenomen configuratie biedt, wordt weergegeven in het veld OvergenomenVan. Aan de andere kant geeft 'overgenomen' = 'False' aan dat het huidige bereik expliciet een eigen prijsconfiguratie heeft ingesteld en niet wordt overgenomen van het bovenliggende bereik. Dit veld is alleen-lezen en alleen beschikbaar voor prijzen op resourceniveau.
isEnabled	Geeft aan of de extensie is ingeschakeld.
OperationStatus	Een status waarin het slagen/mislukken van de activerings-/uitschakelingsbewerking van de extensie wordt beschreven.
Pricing	Microsoft Defender voor Cloud is beschikbaar in twee prijscategorieën: gratis en standaard. De standard-laag biedt geavanceerde beveiligingsmogelijkheden, terwijl de gratis laag basisbeveiligingsfuncties biedt.
pricingTier	Hiermee wordt aangegeven of het Defender-plan is ingeschakeld voor het geselecteerde bereik. Microsoft Defender voor Cloud is beschikbaar in twee prijscategorieën: gratis en standaard. De standard-laag biedt geavanceerde beveiligingsmogelijkheden, terwijl de gratis laag basisbeveiligingsfuncties biedt.
resourcesCoverageStatus	Dit veld is alleen beschikbaar voor abonnementsniveau en geeft de dekkingsstatus van de resources onder het abonnement weer. Let op: Het veld 'pricingTier' weerspiegelt de status van het abonnement. Omdat de planstatus echter ook kan worden gedefinieerd op resourceniveau, kan er sprake zijn van een onjuiste uitlijning tussen de abonnementsstatus en de resourcestatus van het abonnement. Dit veld geeft de dekkingsstatus van de resources aan.

CloudError

Veelvoorkomende foutreactie voor alle Azure Resource Manager-API's om foutdetails te retourneren voor mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

Name	Type	Description
error.additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
error.code	string	De foutcode.
error.details	CloudErrorBody[]	De foutdetails.
error.message	string	Het foutbericht.
error.target	string	Het foutdoel.

CloudErrorBody

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	CloudErrorBody[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

code

De bewerkingsstatuscode.

Name	Type	Description
Failed	string	De extensie is niet gemaakt/bijgewerkt. Zie het bericht over de bewerkingsstatus voor meer informatie.
Succeeded	string	De extensie is gemaakt/bijgewerkt.

enforce

Als deze optie is ingesteld op Onwaar, kunnen de afstammelingen van dit bereik de prijsconfiguratie voor dit bereik overschrijven (staat instelling overgenomen="False" toe). Als deze optie is ingesteld op 'Waar', voorkomt u onderdrukkingen en dwingt u deze prijsconfiguratie af op alle afstammelingen van dit bereik. Dit veld is alleen beschikbaar voor prijzen op abonnementsniveau.

Name	Type	Description
False	string	Hiermee staat u de afstammelingen van dit bereik toe om de prijsconfiguratieset voor dit bereik te overschrijven (staat instelling overgenomen="Onwaar") toe
True	string	Voorkomt onderdrukkingen en dwingt de prijsconfiguratie van het huidige bereik af naar alle afstammelingen

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

Extension

Uitbreidingseigenschappen van een plan

Name	Type	Description
additionalExtensionProperties		Eigenschapswaarden die zijn gekoppeld aan de extensie.
isEnabled	isEnabled	Geeft aan of de extensie is ingeschakeld.
name	string	De extensienaam. Ondersteunde waarden zijn: AgentlessDiscoveryForKubernetes : biedt geen footprint, op API gebaseerde detectie van Kubernetes-clusters, hun configuraties en implementaties. De verzamelde gegevens worden gebruikt om een contextuele beveiligingsgrafiek te maken voor Kubernetes-clusters, mogelijkheden voor het opsporen van risico's te bieden en risico's en bedreigingen voor Kubernetes-omgevingen en -workloads te visualiseren. Beschikbaar voor CloudPosture-plan en Containers-abonnement. OnUploadMalwareScanning : beperkt de GB die per maand moet worden gescand voor elk opslagaccount binnen het abonnement. Zodra deze limiet voor een bepaald opslagaccount is bereikt, worden Blobs niet gescand tijdens de huidige kalendermaand. Beschikbaar voor het StorageAccounts-abonnement (DefenderForStorageV2-subabonnementen). SensitiveDataDiscovery- - Detectie van gevoelige gegevens identificeert Blob Storage-container met gevoelige gegevens, zoals referenties, creditcards en meer, om prioriteit te geven aan beveiligingsgebeurtenissen en deze te onderzoeken. Beschikbaar voor het StorageAccounts-abonnement (DefenderForStorageV2-subplan) en het CloudPosture-plan. ContainerRegistriesVulnerabilityAssessments : biedt beveiligingsbeheer voor installatiekopieën die zijn opgeslagen in uw containerregisters. Beschikbaar voor CloudPosture-plan en Containers-abonnement. MdeDesignatedSubscription - Directe onboarding is een naadloze integratie tussen Defender voor Eindpunt en Defender voor Cloud waarvoor geen extra software-implementatie op uw servers is vereist. De onboarding-resources worden weergegeven onder een toegewezen Azure-abonnement dat u configureert Beschikbaar voor VirtualMachines-abonnement (P1- en P2-subabonnementen). AgentlessVmScanning - Scant uw machines op geïnstalleerde software, beveiligingsproblemen, malware en geheim scannen zonder dat er agents nodig zijn of dat de prestaties van de machine worden beïnvloed. Meer informatie hier https://learn.microsoft.com/en-us/azure/defender-for-cloud/concept-agentless-data-collection. Beschikbaar voor CloudPosture-plan, VirtualMachines-plan (P2-subplan) en Containers-plan. EntraPermissionsManagement - Permissions Management biedt CIEM-mogelijkheden (Cloud Infrastructure Entitlement Management) waarmee organisaties gebruikerstoegang en rechten in hun cloudinfrastructuur kunnen beheren en beheren: belangrijke aanvalsvector voor cloudomgevingen. Machtigingenbeheer analyseert alle machtigingen en actief gebruik en doet aanbevelingen voor het verminderen van machtigingen om het principe van minimale bevoegdheden af te dwingen. Meer informatie hier https://learn.microsoft.com/en-us/azure/defender-for-cloud/permissions-management. Beschikbaar voor CloudPosture-abonnement. FileIntegrityMonitoring - Fim (File Integrity Monitoring), onderzoekt besturingssysteembestanden. Windows-registers, Linux-systeembestanden, in realtime, voor wijzigingen die kunnen duiden op een aanval. Beschikbaar voor VirtualMachines-abonnement (P2-subplan). ContainerSensor: de sensor is gebaseerd op IG en biedt een uitgebreide suite voor bedreigingsdetectie voor Kubernetes-clusters, -knooppunten en -workloads, mogelijk gemaakt door toonaangevende bedreigingsinformatie van Microsoft, biedt toewijzing aan MITRE ATT&CK-framework. Beschikbaar voor containers-abonnement. AIPromptEvidence: geeft de prompts weer die tussen de gebruiker en het AI-model zijn doorgegeven als waarschuwingsbewijs. Dit helpt bij het classificeren en classificeren van de waarschuwingen met relevante gebruikerscontext. De promptfragmenten bevatten alleen segmenten van de gebruikersprompt of het modelantwoord die verdacht en relevant zijn voor beveiligingsclassificaties. Het bewijs is beschikbaar via de Defender-portal als onderdeel van elke waarschuwing. Beschikbaar voor AI-plan.
operationStatus	OperationStatus	Facultatief. Een status waarin het slagen/mislukken van de activerings-/uitschakelingsbewerking van de extensie wordt beschreven.

inherited

"overgenomen" = "True" geeft aan dat het huidige bereik de prijsconfiguratie van het bovenliggende bereik overneemt. De id van het bovenliggende bereik dat de overgenomen configuratie biedt, wordt weergegeven in het veld OvergenomenVan. Aan de andere kant geeft 'overgenomen' = 'False' aan dat het huidige bereik expliciet een eigen prijsconfiguratie heeft ingesteld en niet wordt overgenomen van het bovenliggende bereik. Dit veld is alleen-lezen en alleen beschikbaar voor prijzen op resourceniveau.

Name	Type	Description
False	string	Geeft aan dat het huidige bereik een eigen prijsconfiguratie instelt en deze niet overneemt van het bovenliggende bereik
True	string	Geeft aan dat het huidige bereik de prijsconfiguratie van het bovenliggende bereik overneemt

isEnabled

Geeft aan of de extensie is ingeschakeld.

Name	Type	Description
False	string	Geeft aan dat de extensie is uitgeschakeld
True	string	Geeft aan dat de extensie is ingeschakeld

OperationStatus

Een status waarin het slagen/mislukken van de activerings-/uitschakelingsbewerking van de extensie wordt beschreven.

Name	Type	Description
code	code	De bewerkingsstatuscode.
message	string	Aanvullende informatie over het slagen/mislukken van de bewerking.

Pricing

Microsoft Defender voor Cloud is beschikbaar in twee prijscategorieën: gratis en standaard. De standard-laag biedt geavanceerde beveiligingsmogelijkheden, terwijl de gratis laag basisbeveiligingsfuncties biedt.

Name	Type	Description
id	string	Resource-id
name	string	Resourcenaam
properties.deprecated	boolean	Facultatief. Waar als het plan is afgeschaft. Als er plannen worden vervangen, worden deze weergegeven in replacedBy eigenschap
properties.enablementTime	string	Facultatief. Als pricingTier is Standard, bevat deze eigenschap de datum van de laatste keer dat de pricingTier is ingesteld op Standard, indien beschikbaar (bijvoorbeeld 2023-03-01T12:42:42.1921106Z).
properties.enforce	enforce	Als deze optie is ingesteld op Onwaar, kunnen de afstammelingen van dit bereik de prijsconfiguratie voor dit bereik overschrijven (staat instelling overgenomen="False" toe). Als deze optie is ingesteld op 'Waar', voorkomt u onderdrukkingen en dwingt u deze prijsconfiguratie af op alle afstammelingen van dit bereik. Dit veld is alleen beschikbaar voor prijzen op abonnementsniveau.
properties.extensions	Extension[]	Facultatief. Lijst met extensies die worden aangeboden onder een plan.
properties.freeTrialRemainingTime	string	De duur die overblijft voor de gratis proefperiode van abonnementen- in ISO 8601-indeling (bijvoorbeeld P3Y6M4DT12H30M5S).
properties.inherited	inherited	"overgenomen" = "True" geeft aan dat het huidige bereik de prijsconfiguratie van het bovenliggende bereik overneemt. De id van het bovenliggende bereik dat de overgenomen configuratie biedt, wordt weergegeven in het veld OvergenomenVan. Aan de andere kant geeft 'overgenomen' = 'False' aan dat het huidige bereik expliciet een eigen prijsconfiguratie heeft ingesteld en niet wordt overgenomen van het bovenliggende bereik. Dit veld is alleen-lezen en alleen beschikbaar voor prijzen op resourceniveau.
properties.inheritedFrom	string	De id van het bereik dat is overgenomen van. 'Null' als deze niet is overgenomen. Dit veld is alleen beschikbaar voor prijzen op resourceniveau.
properties.pricingTier	pricingTier	Hiermee wordt aangegeven of het Defender-plan is ingeschakeld voor het geselecteerde bereik. Microsoft Defender voor Cloud is beschikbaar in twee prijscategorieën: gratis en standaard. De standard-laag biedt geavanceerde beveiligingsmogelijkheden, terwijl de gratis laag basisbeveiligingsfuncties biedt.
properties.replacedBy	string[]	Facultatief. Lijst met plannen die dit plan vervangen. Deze eigenschap bestaat alleen als dit plan is afgeschaft.
properties.resourcesCoverageStatus	resourcesCoverageStatus	Dit veld is alleen beschikbaar voor abonnementsniveau en geeft de dekkingsstatus van de resources onder het abonnement weer. Let op: Het veld 'pricingTier' weerspiegelt de status van het abonnement. Omdat de planstatus echter ook kan worden gedefinieerd op resourceniveau, kan er sprake zijn van een onjuiste uitlijning tussen de abonnementsstatus en de resourcestatus van het abonnement. Dit veld geeft de dekkingsstatus van de resources aan.
properties.subPlan	string	Het subabonnement dat is geselecteerd voor een standard-prijsconfiguratie, wanneer er meer dan één subabonnement beschikbaar is. Elk subplan maakt een set beveiligingsfuncties mogelijk. Wanneer dit niet is opgegeven, wordt een volledig plan toegepast. Voor het VirtualMachines-plan zijn de beschikbare subplannen P1 & 'P2', waarbij voor het resourceniveau alleen het subplan P1 wordt ondersteund.
type	string	Resourcetype

pricingTier

Hiermee wordt aangegeven of het Defender-plan is ingeschakeld voor het geselecteerde bereik. Microsoft Defender voor Cloud is beschikbaar in twee prijscategorieën: gratis en standaard. De standard-laag biedt geavanceerde beveiligingsmogelijkheden, terwijl de gratis laag basisbeveiligingsfuncties biedt.

Name	Type	Description
Free	string	Krijg gratis Microsoft Defender voor Cloud-ervaring met basisbeveiligingsfuncties
Standard	string	Krijg de standaardervaring van Microsoft Defender voor Cloud met geavanceerde beveiligingsfuncties

resourcesCoverageStatus

Dit veld is alleen beschikbaar voor abonnementsniveau en geeft de dekkingsstatus van de resources onder het abonnement weer. Let op: Het veld 'pricingTier' weerspiegelt de status van het abonnement. Omdat de planstatus echter ook kan worden gedefinieerd op resourceniveau, kan er sprake zijn van een onjuiste uitlijning tussen de abonnementsstatus en de resourcestatus van het abonnement. Dit veld geeft de dekkingsstatus van de resources aan.

Name	Type	Description
FullyCovered	string	Deze waarde geeft aan dat alle resources die aan het abonnement zijn gekoppeld, het Defender-abonnement hebben ingeschakeld.
NotCovered	string	Deze waarde geeft aan dat het Defender-abonnement is uitgeschakeld voor alle resources in het abonnement. Geen van de resources wordt beveiligd door het Defender-plan.
PartiallyCovered	string	Deze waarde geeft aan dat voor sommige resources onder het abonnement het Defender-abonnement is ingeschakeld, terwijl andere resources het abonnement hebben uitgeschakeld. Er is een gemengde dekkingsstatus tussen resources.