Costs - Create Or Update

Reference

Service:: Dev Test Labs

API Version:: 2018-09-15

Create or replace an existing cost.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/costs/{name}?api-version=2018-09-15

URI Parameters

Name	In	Required	Type	Description
labName	path	True	string	The name of the lab.
name	path	True	string	The name of the cost.
resourceGroupName	path	True	string	The name of the resource group.
subscriptionId	path	True	string	The subscription ID.
api-version	query	True	string	Client API version.

Request Body

Name	Type	Description
location	string	The location of the resource.
properties.createdDate	string	The creation date of the cost.
properties.currencyCode	string	The currency code of the cost.
properties.endDateTime	string	The end time of the cost data.
properties.startDateTime	string	The start time of the cost data.
properties.targetCost	TargetCostProperties	The target cost properties
tags	object	The tags of the resource.

Responses

Name	Type	Description
200 OK	LabCost	OK
201 Created	LabCost	Created
Other Status Codes	CloudError	BadRequest

Security

azure_auth

OAuth2 Implicit Grant

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

Scopes

Name	Description
user_impersonation	Access Microsoft Azure

Examples

Costs_CreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/costs/targetCost?api-version=2018-09-15

{
  "properties": {
    "currencyCode": "USD",
    "startDateTime": "2020-12-01T00:00:00Z",
    "endDateTime": "2020-12-31T23:59:59Z",
    "targetCost": {
      "costThresholds": [
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "percentageThreshold": {
            "thresholdValue": 25
          }
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000002",
          "displayOnChart": "Enabled",
          "sendNotificationWhenExceeded": "Enabled",
          "percentageThreshold": {
            "thresholdValue": 50
          }
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000003",
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "percentageThreshold": {
            "thresholdValue": 75
          }
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000004",
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "percentageThreshold": {
            "thresholdValue": 100
          }
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000005",
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "percentageThreshold": {
            "thresholdValue": 125
          }
        }
      ],
      "target": 100,
      "cycleStartDateTime": "2020-12-01T00:00:00.000Z",
      "cycleEndDateTime": "2020-12-31T00:00:00.000Z",
      "cycleType": "CalendarMonth",
      "status": "Enabled"
    }
  }
}

import com.azure.resourcemanager.devtestlabs.models.CostThresholdProperties;
import com.azure.resourcemanager.devtestlabs.models.CostThresholdStatus;
import com.azure.resourcemanager.devtestlabs.models.PercentageCostThresholdProperties;
import com.azure.resourcemanager.devtestlabs.models.ReportingCycleType;
import com.azure.resourcemanager.devtestlabs.models.TargetCostProperties;
import com.azure.resourcemanager.devtestlabs.models.TargetCostStatus;
import java.time.OffsetDateTime;
import java.util.Arrays;

/** Samples for Costs CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/devtestlabs/resource-manager/Microsoft.DevTestLab/stable/2018-09-15/examples/Costs_CreateOrUpdate.json
     */
    /**
     * Sample code: Costs_CreateOrUpdate.
     *
     * @param manager Entry point to DevTestLabsManager.
     */
    public static void costsCreateOrUpdate(com.azure.resourcemanager.devtestlabs.DevTestLabsManager manager) {
        manager
            .costs()
            .define("targetCost")
            .withRegion((String) null)
            .withExistingLab("resourceGroupName", "{labName}")
            .withTargetCost(
                new TargetCostProperties()
                    .withStatus(TargetCostStatus.ENABLED)
                    .withTarget(100)
                    .withCostThresholds(
                        Arrays
                            .asList(
                                new CostThresholdProperties()
                                    .withThresholdId("00000000-0000-0000-0000-000000000001")
                                    .withPercentageThreshold(
                                        new PercentageCostThresholdProperties().withThresholdValue(25.0D))
                                    .withDisplayOnChart(CostThresholdStatus.DISABLED)
                                    .withSendNotificationWhenExceeded(CostThresholdStatus.DISABLED),
                                new CostThresholdProperties()
                                    .withThresholdId("00000000-0000-0000-0000-000000000002")
                                    .withPercentageThreshold(
                                        new PercentageCostThresholdProperties().withThresholdValue(50.0D))
                                    .withDisplayOnChart(CostThresholdStatus.ENABLED)
                                    .withSendNotificationWhenExceeded(CostThresholdStatus.ENABLED),
                                new CostThresholdProperties()
                                    .withThresholdId("00000000-0000-0000-0000-000000000003")
                                    .withPercentageThreshold(
                                        new PercentageCostThresholdProperties().withThresholdValue(75.0D))
                                    .withDisplayOnChart(CostThresholdStatus.DISABLED)
                                    .withSendNotificationWhenExceeded(CostThresholdStatus.DISABLED),
                                new CostThresholdProperties()
                                    .withThresholdId("00000000-0000-0000-0000-000000000004")
                                    .withPercentageThreshold(
                                        new PercentageCostThresholdProperties().withThresholdValue(100.0D))
                                    .withDisplayOnChart(CostThresholdStatus.DISABLED)
                                    .withSendNotificationWhenExceeded(CostThresholdStatus.DISABLED),
                                new CostThresholdProperties()
                                    .withThresholdId("00000000-0000-0000-0000-000000000005")
                                    .withPercentageThreshold(
                                        new PercentageCostThresholdProperties().withThresholdValue(125.0D))
                                    .withDisplayOnChart(CostThresholdStatus.DISABLED)
                                    .withSendNotificationWhenExceeded(CostThresholdStatus.DISABLED)))
                    .withCycleStartDateTime(OffsetDateTime.parse("2020-12-01T00:00:00.000Z"))
                    .withCycleEndDateTime(OffsetDateTime.parse("2020-12-31T00:00:00.000Z"))
                    .withCycleType(ReportingCycleType.CALENDAR_MONTH))
            .withCurrencyCode("USD")
            .withStartDateTime(OffsetDateTime.parse("2020-12-01T00:00:00Z"))
            .withEndDateTime(OffsetDateTime.parse("2020-12-31T23:59:59Z"))
            .create();
    }
}

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

from azure.identity import DefaultAzureCredential
from azure.mgmt.devtestlabs import DevTestLabsClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-devtestlabs
# USAGE
    python costs_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DevTestLabsClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscriptionId}",
    )

    response = client.costs.create_or_update(
        resource_group_name="resourceGroupName",
        lab_name="{labName}",
        name="targetCost",
        lab_cost={
            "properties": {
                "currencyCode": "USD",
                "endDateTime": "2020-12-31T23:59:59Z",
                "startDateTime": "2020-12-01T00:00:00Z",
                "targetCost": {
                    "costThresholds": [
                        {
                            "displayOnChart": "Disabled",
                            "percentageThreshold": {"thresholdValue": 25},
                            "sendNotificationWhenExceeded": "Disabled",
                            "thresholdId": "00000000-0000-0000-0000-000000000001",
                        },
                        {
                            "displayOnChart": "Enabled",
                            "percentageThreshold": {"thresholdValue": 50},
                            "sendNotificationWhenExceeded": "Enabled",
                            "thresholdId": "00000000-0000-0000-0000-000000000002",
                        },
                        {
                            "displayOnChart": "Disabled",
                            "percentageThreshold": {"thresholdValue": 75},
                            "sendNotificationWhenExceeded": "Disabled",
                            "thresholdId": "00000000-0000-0000-0000-000000000003",
                        },
                        {
                            "displayOnChart": "Disabled",
                            "percentageThreshold": {"thresholdValue": 100},
                            "sendNotificationWhenExceeded": "Disabled",
                            "thresholdId": "00000000-0000-0000-0000-000000000004",
                        },
                        {
                            "displayOnChart": "Disabled",
                            "percentageThreshold": {"thresholdValue": 125},
                            "sendNotificationWhenExceeded": "Disabled",
                            "thresholdId": "00000000-0000-0000-0000-000000000005",
                        },
                    ],
                    "cycleEndDateTime": "2020-12-31T00:00:00.000Z",
                    "cycleStartDateTime": "2020-12-01T00:00:00.000Z",
                    "cycleType": "CalendarMonth",
                    "status": "Enabled",
                    "target": 100,
                },
            }
        },
    )
    print(response)


# x-ms-original-file: specification/devtestlabs/resource-manager/Microsoft.DevTestLab/stable/2018-09-15/examples/Costs_CreateOrUpdate.json
if __name__ == "__main__":
    main()

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

package armdevtestlabs_test

import (
	"context"
	"log"

	"time"

	"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/devtestlabs/armdevtestlabs"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d55b8005f05b040b852c15e74a0f3e36494a15e1/specification/devtestlabs/resource-manager/Microsoft.DevTestLab/stable/2018-09-15/examples/Costs_CreateOrUpdate.json
func ExampleCostsClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdevtestlabs.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewCostsClient().CreateOrUpdate(ctx, "resourceGroupName", "{labName}", "targetCost", armdevtestlabs.LabCost{
		Properties: &armdevtestlabs.LabCostProperties{
			CurrencyCode:  to.Ptr("USD"),
			EndDateTime:   to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-31T23:59:59.000Z"); return t }()),
			StartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-01T00:00:00.000Z"); return t }()),
			TargetCost: &armdevtestlabs.TargetCostProperties{
				CostThresholds: []*armdevtestlabs.CostThresholdProperties{
					{
						DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
							ThresholdValue: to.Ptr[float64](25),
						},
						SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						ThresholdID:                  to.Ptr("00000000-0000-0000-0000-000000000001"),
					},
					{
						DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusEnabled),
						PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
							ThresholdValue: to.Ptr[float64](50),
						},
						SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusEnabled),
						ThresholdID:                  to.Ptr("00000000-0000-0000-0000-000000000002"),
					},
					{
						DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
							ThresholdValue: to.Ptr[float64](75),
						},
						SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						ThresholdID:                  to.Ptr("00000000-0000-0000-0000-000000000003"),
					},
					{
						DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
							ThresholdValue: to.Ptr[float64](100),
						},
						SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						ThresholdID:                  to.Ptr("00000000-0000-0000-0000-000000000004"),
					},
					{
						DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
							ThresholdValue: to.Ptr[float64](125),
						},
						SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
						ThresholdID:                  to.Ptr("00000000-0000-0000-0000-000000000005"),
					}},
				CycleEndDateTime:   to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-31T00:00:00.000Z"); return t }()),
				CycleStartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-01T00:00:00.000Z"); return t }()),
				CycleType:          to.Ptr(armdevtestlabs.ReportingCycleTypeCalendarMonth),
				Status:             to.Ptr(armdevtestlabs.TargetCostStatusEnabled),
				Target:             to.Ptr[int32](100),
			},
		},
	}, 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.LabCost = armdevtestlabs.LabCost{
	// 	Properties: &armdevtestlabs.LabCostProperties{
	// 		CreatedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-23T22:43:54.725Z"); return t}()),
	// 		CurrencyCode: to.Ptr("USD"),
	// 		EndDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-31T23:59:59.000Z"); return t}()),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		StartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-01T00:00:00.000Z"); return t}()),
	// 		TargetCost: &armdevtestlabs.TargetCostProperties{
	// 			CostThresholds: []*armdevtestlabs.CostThresholdProperties{
	// 				{
	// 					DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					NotificationSent: to.Ptr("0001-01-01T00:00:00.0000000"),
	// 					PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
	// 						ThresholdValue: to.Ptr[float64](25),
	// 					},
	// 					SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					ThresholdID: to.Ptr("00000000-0000-0000-0000-000000000001"),
	// 				},
	// 				{
	// 					DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusEnabled),
	// 					NotificationSent: to.Ptr("0001-01-01T00:00:00.0000000"),
	// 					PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
	// 						ThresholdValue: to.Ptr[float64](50),
	// 					},
	// 					SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusEnabled),
	// 					ThresholdID: to.Ptr("00000000-0000-0000-0000-000000000001"),
	// 				},
	// 				{
	// 					DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					NotificationSent: to.Ptr("0001-01-01T00:00:00.0000000"),
	// 					PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
	// 						ThresholdValue: to.Ptr[float64](75),
	// 					},
	// 					SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					ThresholdID: to.Ptr("00000000-0000-0000-0000-000000000001"),
	// 				},
	// 				{
	// 					DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					NotificationSent: to.Ptr("0001-01-01T00:00:00.0000000"),
	// 					PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
	// 						ThresholdValue: to.Ptr[float64](100),
	// 					},
	// 					SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					ThresholdID: to.Ptr("00000000-0000-0000-0000-000000000001"),
	// 				},
	// 				{
	// 					DisplayOnChart: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					NotificationSent: to.Ptr("0001-01-01T00:00:00.0000000"),
	// 					PercentageThreshold: &armdevtestlabs.PercentageCostThresholdProperties{
	// 						ThresholdValue: to.Ptr[float64](125),
	// 					},
	// 					SendNotificationWhenExceeded: to.Ptr(armdevtestlabs.CostThresholdStatusDisabled),
	// 					ThresholdID: to.Ptr("00000000-0000-0000-0000-000000000001"),
	// 			}},
	// 			CycleEndDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-31T23:59:59.000Z"); return t}()),
	// 			CycleStartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-12-01T00:00:00.000Z"); return t}()),
	// 			CycleType: to.Ptr(armdevtestlabs.ReportingCycleTypeCalendarMonth),
	// 			Status: to.Ptr(armdevtestlabs.TargetCostStatusEnabled),
	// 			Target: to.Ptr[int32](100),
	// 		},
	// 		UniqueIdentifier: to.Ptr("{uniqueIdentifier}"),
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to Create or replace an existing cost.
 *
 * @summary Create or replace an existing cost.
 * x-ms-original-file: specification/devtestlabs/resource-manager/Microsoft.DevTestLab/stable/2018-09-15/examples/Costs_CreateOrUpdate.json
 */
async function costsCreateOrUpdate() {
  const subscriptionId = "{subscriptionId}";
  const resourceGroupName = "resourceGroupName";
  const labName = "{labName}";
  const name = "targetCost";
  const labCost = {
    currencyCode: "USD",
    endDateTime: new Date("2020-12-31T23:59:59Z"),
    startDateTime: new Date("2020-12-01T00:00:00Z"),
    targetCost: {
      costThresholds: [
        {
          displayOnChart: "Disabled",
          percentageThreshold: { thresholdValue: 25 },
          sendNotificationWhenExceeded: "Disabled",
          thresholdId: "00000000-0000-0000-0000-000000000001",
        },
        {
          displayOnChart: "Enabled",
          percentageThreshold: { thresholdValue: 50 },
          sendNotificationWhenExceeded: "Enabled",
          thresholdId: "00000000-0000-0000-0000-000000000002",
        },
        {
          displayOnChart: "Disabled",
          percentageThreshold: { thresholdValue: 75 },
          sendNotificationWhenExceeded: "Disabled",
          thresholdId: "00000000-0000-0000-0000-000000000003",
        },
        {
          displayOnChart: "Disabled",
          percentageThreshold: { thresholdValue: 100 },
          sendNotificationWhenExceeded: "Disabled",
          thresholdId: "00000000-0000-0000-0000-000000000004",
        },
        {
          displayOnChart: "Disabled",
          percentageThreshold: { thresholdValue: 125 },
          sendNotificationWhenExceeded: "Disabled",
          thresholdId: "00000000-0000-0000-0000-000000000005",
        },
      ],
      cycleEndDateTime: new Date("2020-12-31T00:00:00.000Z"),
      cycleStartDateTime: new Date("2020-12-01T00:00:00.000Z"),
      cycleType: "CalendarMonth",
      status: "Enabled",
      target: 100,
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DevTestLabsClient(credential, subscriptionId);
  const result = await client.costs.createOrUpdate(resourceGroupName, labName, name, labCost);
  console.log(result);
}

costsCreateOrUpdate().catch(console.error);

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

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.DevTestLabs;
using Azure.ResourceManager.DevTestLabs.Models;

// Generated from example definition: specification/devtestlabs/resource-manager/Microsoft.DevTestLab/stable/2018-09-15/examples/Costs_CreateOrUpdate.json
// this example is just showing the usage of "Costs_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this DevTestLabCostResource created on azure
// for more information of creating DevTestLabCostResource, please refer to the document of DevTestLabCostResource
string subscriptionId = "{subscriptionId}";
string resourceGroupName = "resourceGroupName";
string labName = "{labName}";
string name = "targetCost";
ResourceIdentifier devTestLabCostResourceId = DevTestLabCostResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, labName, name);
DevTestLabCostResource devTestLabCost = client.GetDevTestLabCostResource(devTestLabCostResourceId);

// invoke the operation
DevTestLabCostData data = new DevTestLabCostData(new AzureLocation("placeholder"))
{
    TargetCost = new DevTestLabTargetCost()
    {
        Status = DevTestLabTargetCostStatus.Enabled,
        Target = 100,
        CostThresholds =
        {
        new DevTestLabCostThreshold()
        {
        ThresholdId = "00000000-0000-0000-0000-000000000001",
        ThresholdValue = 25,
        DisplayOnChart = DevTestLabCostThresholdStatus.Disabled,
        SendNotificationWhenExceeded = DevTestLabCostThresholdStatus.Disabled,
        },new DevTestLabCostThreshold()
        {
        ThresholdId = "00000000-0000-0000-0000-000000000002",
        ThresholdValue = 50,
        DisplayOnChart = DevTestLabCostThresholdStatus.Enabled,
        SendNotificationWhenExceeded = DevTestLabCostThresholdStatus.Enabled,
        },new DevTestLabCostThreshold()
        {
        ThresholdId = "00000000-0000-0000-0000-000000000003",
        ThresholdValue = 75,
        DisplayOnChart = DevTestLabCostThresholdStatus.Disabled,
        SendNotificationWhenExceeded = DevTestLabCostThresholdStatus.Disabled,
        },new DevTestLabCostThreshold()
        {
        ThresholdId = "00000000-0000-0000-0000-000000000004",
        ThresholdValue = 100,
        DisplayOnChart = DevTestLabCostThresholdStatus.Disabled,
        SendNotificationWhenExceeded = DevTestLabCostThresholdStatus.Disabled,
        },new DevTestLabCostThreshold()
        {
        ThresholdId = "00000000-0000-0000-0000-000000000005",
        ThresholdValue = 125,
        DisplayOnChart = DevTestLabCostThresholdStatus.Disabled,
        SendNotificationWhenExceeded = DevTestLabCostThresholdStatus.Disabled,
        }
        },
        CycleStartOn = DateTimeOffset.Parse("2020-12-01T00:00:00.000Z"),
        CycleEndOn = DateTimeOffset.Parse("2020-12-31T00:00:00.000Z"),
        CycleType = DevTestLabReportingCycleType.CalendarMonth,
    },
    CurrencyCode = "USD",
    StartOn = DateTimeOffset.Parse("2020-12-01T00:00:00Z"),
    EndOn = DateTimeOffset.Parse("2020-12-31T23:59:59Z"),
};
ArmOperation<DevTestLabCostResource> lro = await devTestLabCost.UpdateAsync(WaitUntil.Completed, data);
DevTestLabCostResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
DevTestLabCostData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Sample Response

Status code:: 200

{
  "properties": {
    "targetCost": {
      "costThresholds": [
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 25
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 50
          },
          "displayOnChart": "Enabled",
          "sendNotificationWhenExceeded": "Enabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 75
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 100
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 125
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        }
      ],
      "status": "Enabled",
      "target": 100,
      "cycleStartDateTime": "2020-12-01T00:00:00+00:00",
      "cycleEndDateTime": "2020-12-31T23:59:59+00:00",
      "cycleType": "CalendarMonth"
    },
    "currencyCode": "USD",
    "startDateTime": "2020-12-01T00:00:00Z",
    "endDateTime": "2020-12-31T23:59:59Z",
    "createdDate": "2020-12-23T22:43:54.7253204+00:00",
    "provisioningState": "Succeeded",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "id": "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/microsoft.devtestlab/labs/{labName}/costs/{costName}",
  "name": "{costName}",
  "type": "Microsoft.DevTestLab/labs/costs",
  "location": "{location}",
  "tags": {
    "tagName1": "tagValue1"
  }
}

Status code:: 201

{
  "properties": {
    "targetCost": {
      "costThresholds": [
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 25
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 50
          },
          "displayOnChart": "Enabled",
          "sendNotificationWhenExceeded": "Enabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 75
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 100
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        },
        {
          "thresholdId": "00000000-0000-0000-0000-000000000001",
          "percentageThreshold": {
            "thresholdValue": 125
          },
          "displayOnChart": "Disabled",
          "sendNotificationWhenExceeded": "Disabled",
          "notificationSent": "0001-01-01T00:00:00.0000000"
        }
      ],
      "status": "Enabled",
      "target": 100,
      "cycleStartDateTime": "2020-12-01T00:00:00+00:00",
      "cycleEndDateTime": "2020-12-31T23:59:59+00:00",
      "cycleType": "CalendarMonth"
    },
    "currencyCode": "USD",
    "startDateTime": "2020-12-01T00:00:00Z",
    "endDateTime": "2020-12-31T23:59:59Z",
    "createdDate": "2020-12-23T22:43:54.7253204+00:00",
    "provisioningState": "Creating",
    "uniqueIdentifier": "{uniqueIdentifier}"
  },
  "id": "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/microsoft.devtestlab/labs/{labName}/costs/{costName}",
  "name": "{costName}",
  "type": "Microsoft.DevTestLab/labs/costs",
  "location": "{location}",
  "tags": {
    "tagName1": "tagValue1"
  }
}

Definitions

Name	Description
CloudError	Error from a REST request.
CloudErrorBody	Body of an error from a REST request.
CostThresholdProperties	Properties of a cost threshold item.
CostThresholdStatus	Indicates whether this threshold will be displayed on cost charts.
CostType	The type of the cost.
LabCost	A cost item.
LabCostDetailsProperties	The properties of a lab cost item.
LabCostSummaryProperties	The properties of the cost summary.
LabResourceCostProperties	The properties of a resource cost item.
PercentageCostThresholdProperties	Properties of a percentage cost threshold.
ReportingCycleType	Reporting cycle type.
TargetCostProperties	Properties of a cost target.
TargetCostStatus	Target cost status

CloudError

Error from a REST request.

Name	Type	Description
error	CloudErrorBody	The cloud error that occurred

CloudErrorBody

Body of an error from a REST request.

Name	Type	Description
code	string	The error code.
details	CloudErrorBody[]	Inner errors.
message	string	The error message.
target	string	The error target.

CostThresholdProperties

Properties of a cost threshold item.

Name	Type	Description
displayOnChart	CostThresholdStatus	Indicates whether this threshold will be displayed on cost charts.
notificationSent	string	Indicates the datetime when notifications were last sent for this threshold.
percentageThreshold	PercentageCostThresholdProperties	The value of the percentage cost threshold.
sendNotificationWhenExceeded	CostThresholdStatus	Indicates whether notifications will be sent when this threshold is exceeded.
thresholdId	string	The ID of the cost threshold item.

CostThresholdStatus

Indicates whether this threshold will be displayed on cost charts.

Name	Type	Description
Disabled	string
Enabled	string

CostType

The type of the cost.

Name	Type	Description
Projected	string
Reported	string
Unavailable	string

LabCost

A cost item.

Name	Type	Description
id	string	The identifier of the resource.
location	string	The location of the resource.
name	string	The name of the resource.
properties.createdDate	string	The creation date of the cost.
properties.currencyCode	string	The currency code of the cost.
properties.endDateTime	string	The end time of the cost data.
properties.labCostDetails	LabCostDetailsProperties[]	The lab cost details component of the cost data.
properties.labCostSummary	LabCostSummaryProperties	The lab cost summary component of the cost data.
properties.provisioningState	string	The provisioning status of the resource.
properties.resourceCosts	LabResourceCostProperties[]	The resource cost component of the cost data.
properties.startDateTime	string	The start time of the cost data.
properties.targetCost	TargetCostProperties	The target cost properties
properties.uniqueIdentifier	string	The unique immutable identifier of a resource (Guid).
tags	object	The tags of the resource.
type	string	The type of the resource.

LabCostDetailsProperties

The properties of a lab cost item.

Name	Type	Description
cost	number	The cost component of the cost item.
costType	CostType	The type of the cost.
date	string	The date of the cost item.

LabCostSummaryProperties

The properties of the cost summary.

Name	Type	Description
estimatedLabCost	number	The cost component of the cost item.

LabResourceCostProperties

The properties of a resource cost item.

Name	Type	Description
externalResourceId	string	The ID of the external resource
resourceCost	number	The cost component of the resource cost item.
resourceId	string	The ID of the resource
resourceOwner	string	The owner of the resource (ex. janedoe@microsoft.com)
resourcePricingTier	string	The category of the resource (ex. Premium_LRS, Standard_DS1)
resourceStatus	string	The status of the resource (ex. Active)
resourceType	string	The logical resource type (ex. virtualmachine, storageaccount)
resourceUId	string	The unique identifier of the resource.
resourcename	string	The name of the resource.

PercentageCostThresholdProperties

Properties of a percentage cost threshold.

Name	Type	Description
thresholdValue	number	The cost threshold value.

ReportingCycleType

Reporting cycle type.

Name	Type	Description
CalendarMonth	string
Custom	string

TargetCostProperties

Properties of a cost target.

Name	Type	Description
costThresholds	CostThresholdProperties[]	Cost thresholds.
cycleEndDateTime	string	Reporting cycle end date.
cycleStartDateTime	string	Reporting cycle start date.
cycleType	ReportingCycleType	Reporting cycle type.
status	TargetCostStatus	Target cost status
target	integer	Lab target cost

TargetCostStatus

Target cost status

Name	Type	Description
Disabled	string
Enabled	string