Azure Classic

Pulumi Official
Package maintained by Pulumi
v5.14.0 published on Thursday, Jul 28, 2022 by Pulumi

BudgetResourceGroup

Manages a Resource Group Consumption Budget.

Example Usage

using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
    public MyStack()
    {
        var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
        {
            Location = "eastus",
        });
        var exampleActionGroup = new Azure.Monitoring.ActionGroup("exampleActionGroup", new Azure.Monitoring.ActionGroupArgs
        {
            ResourceGroupName = exampleResourceGroup.Name,
            ShortName = "example",
        });
        var exampleBudgetResourceGroup = new Azure.Consumption.BudgetResourceGroup("exampleBudgetResourceGroup", new Azure.Consumption.BudgetResourceGroupArgs
        {
            ResourceGroupId = exampleResourceGroup.Id,
            Amount = 1000,
            TimeGrain = "Monthly",
            TimePeriod = new Azure.Consumption.Inputs.BudgetResourceGroupTimePeriodArgs
            {
                StartDate = "2022-06-01T00:00:00Z",
                EndDate = "2022-07-01T00:00:00Z",
            },
            Filter = new Azure.Consumption.Inputs.BudgetResourceGroupFilterArgs
            {
                Dimensions = 
                {
                    new Azure.Consumption.Inputs.BudgetResourceGroupFilterDimensionArgs
                    {
                        Name = "ResourceId",
                        Values = 
                        {
                            exampleActionGroup.Id,
                        },
                    },
                },
                Tags = 
                {
                    new Azure.Consumption.Inputs.BudgetResourceGroupFilterTagArgs
                    {
                        Name = "foo",
                        Values = 
                        {
                            "bar",
                            "baz",
                        },
                    },
                },
            },
            Notifications = 
            {
                new Azure.Consumption.Inputs.BudgetResourceGroupNotificationArgs
                {
                    Enabled = true,
                    Threshold = 90,
                    Operator = "EqualTo",
                    ThresholdType = "Forecasted",
                    ContactEmails = 
                    {
                        "foo@example.com",
                        "bar@example.com",
                    },
                    ContactGroups = 
                    {
                        exampleActionGroup.Id,
                    },
                    ContactRoles = 
                    {
                        "Owner",
                    },
                },
                new Azure.Consumption.Inputs.BudgetResourceGroupNotificationArgs
                {
                    Enabled = false,
                    Threshold = 100,
                    Operator = "GreaterThan",
                    ContactEmails = 
                    {
                        "foo@example.com",
                        "bar@example.com",
                    },
                },
            },
        });
    }

}
package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/consumption"
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/monitoring"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleResourceGroup, err := core.NewResourceGroup(ctx, "exampleResourceGroup", &core.ResourceGroupArgs{
			Location: pulumi.String("eastus"),
		})
		if err != nil {
			return err
		}
		exampleActionGroup, err := monitoring.NewActionGroup(ctx, "exampleActionGroup", &monitoring.ActionGroupArgs{
			ResourceGroupName: exampleResourceGroup.Name,
			ShortName:         pulumi.String("example"),
		})
		if err != nil {
			return err
		}
		_, err = consumption.NewBudgetResourceGroup(ctx, "exampleBudgetResourceGroup", &consumption.BudgetResourceGroupArgs{
			ResourceGroupId: exampleResourceGroup.ID(),
			Amount:          pulumi.Float64(1000),
			TimeGrain:       pulumi.String("Monthly"),
			TimePeriod: &consumption.BudgetResourceGroupTimePeriodArgs{
				StartDate: pulumi.String("2022-06-01T00:00:00Z"),
				EndDate:   pulumi.String("2022-07-01T00:00:00Z"),
			},
			Filter: &consumption.BudgetResourceGroupFilterArgs{
				Dimensions: consumption.BudgetResourceGroupFilterDimensionArray{
					&consumption.BudgetResourceGroupFilterDimensionArgs{
						Name: pulumi.String("ResourceId"),
						Values: pulumi.StringArray{
							exampleActionGroup.ID(),
						},
					},
				},
				Tags: consumption.BudgetResourceGroupFilterTagArray{
					&consumption.BudgetResourceGroupFilterTagArgs{
						Name: pulumi.String("foo"),
						Values: pulumi.StringArray{
							pulumi.String("bar"),
							pulumi.String("baz"),
						},
					},
				},
			},
			Notifications: consumption.BudgetResourceGroupNotificationArray{
				&consumption.BudgetResourceGroupNotificationArgs{
					Enabled:       pulumi.Bool(true),
					Threshold:     pulumi.Int(90),
					Operator:      pulumi.String("EqualTo"),
					ThresholdType: pulumi.String("Forecasted"),
					ContactEmails: pulumi.StringArray{
						pulumi.String("foo@example.com"),
						pulumi.String("bar@example.com"),
					},
					ContactGroups: pulumi.StringArray{
						exampleActionGroup.ID(),
					},
					ContactRoles: pulumi.StringArray{
						pulumi.String("Owner"),
					},
				},
				&consumption.BudgetResourceGroupNotificationArgs{
					Enabled:   pulumi.Bool(false),
					Threshold: pulumi.Int(100),
					Operator:  pulumi.String("GreaterThan"),
					ContactEmails: pulumi.StringArray{
						pulumi.String("foo@example.com"),
						pulumi.String("bar@example.com"),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.monitoring.ActionGroup;
import com.pulumi.azure.monitoring.ActionGroupArgs;
import com.pulumi.azure.consumption.BudgetResourceGroup;
import com.pulumi.azure.consumption.BudgetResourceGroupArgs;
import com.pulumi.azure.consumption.inputs.BudgetResourceGroupTimePeriodArgs;
import com.pulumi.azure.consumption.inputs.BudgetResourceGroupFilterArgs;
import com.pulumi.azure.consumption.inputs.BudgetResourceGroupNotificationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var exampleResourceGroup = new ResourceGroup("exampleResourceGroup", ResourceGroupArgs.builder()        
            .location("eastus")
            .build());

        var exampleActionGroup = new ActionGroup("exampleActionGroup", ActionGroupArgs.builder()        
            .resourceGroupName(exampleResourceGroup.name())
            .shortName("example")
            .build());

        var exampleBudgetResourceGroup = new BudgetResourceGroup("exampleBudgetResourceGroup", BudgetResourceGroupArgs.builder()        
            .resourceGroupId(exampleResourceGroup.id())
            .amount(1000)
            .timeGrain("Monthly")
            .timePeriod(BudgetResourceGroupTimePeriodArgs.builder()
                .startDate("2022-06-01T00:00:00Z")
                .endDate("2022-07-01T00:00:00Z")
                .build())
            .filter(BudgetResourceGroupFilterArgs.builder()
                .dimensions(BudgetResourceGroupFilterDimensionArgs.builder()
                    .name("ResourceId")
                    .values(exampleActionGroup.id())
                    .build())
                .tags(BudgetResourceGroupFilterTagArgs.builder()
                    .name("foo")
                    .values(                    
                        "bar",
                        "baz")
                    .build())
                .build())
            .notifications(            
                BudgetResourceGroupNotificationArgs.builder()
                    .enabled(true)
                    .threshold(90)
                    .operator("EqualTo")
                    .thresholdType("Forecasted")
                    .contactEmails(                    
                        "foo@example.com",
                        "bar@example.com")
                    .contactGroups(exampleActionGroup.id())
                    .contactRoles("Owner")
                    .build(),
                BudgetResourceGroupNotificationArgs.builder()
                    .enabled(false)
                    .threshold(100)
                    .operator("GreaterThan")
                    .contactEmails(                    
                        "foo@example.com",
                        "bar@example.com")
                    .build())
            .build());

    }
}
import pulumi
import pulumi_azure as azure

example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="eastus")
example_action_group = azure.monitoring.ActionGroup("exampleActionGroup",
    resource_group_name=example_resource_group.name,
    short_name="example")
example_budget_resource_group = azure.consumption.BudgetResourceGroup("exampleBudgetResourceGroup",
    resource_group_id=example_resource_group.id,
    amount=1000,
    time_grain="Monthly",
    time_period=azure.consumption.BudgetResourceGroupTimePeriodArgs(
        start_date="2022-06-01T00:00:00Z",
        end_date="2022-07-01T00:00:00Z",
    ),
    filter=azure.consumption.BudgetResourceGroupFilterArgs(
        dimensions=[azure.consumption.BudgetResourceGroupFilterDimensionArgs(
            name="ResourceId",
            values=[example_action_group.id],
        )],
        tags=[azure.consumption.BudgetResourceGroupFilterTagArgs(
            name="foo",
            values=[
                "bar",
                "baz",
            ],
        )],
    ),
    notifications=[
        azure.consumption.BudgetResourceGroupNotificationArgs(
            enabled=True,
            threshold=90,
            operator="EqualTo",
            threshold_type="Forecasted",
            contact_emails=[
                "foo@example.com",
                "bar@example.com",
            ],
            contact_groups=[example_action_group.id],
            contact_roles=["Owner"],
        ),
        azure.consumption.BudgetResourceGroupNotificationArgs(
            enabled=False,
            threshold=100,
            operator="GreaterThan",
            contact_emails=[
                "foo@example.com",
                "bar@example.com",
            ],
        ),
    ])
import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "eastus"});
const exampleActionGroup = new azure.monitoring.ActionGroup("exampleActionGroup", {
    resourceGroupName: exampleResourceGroup.name,
    shortName: "example",
});
const exampleBudgetResourceGroup = new azure.consumption.BudgetResourceGroup("exampleBudgetResourceGroup", {
    resourceGroupId: exampleResourceGroup.id,
    amount: 1000,
    timeGrain: "Monthly",
    timePeriod: {
        startDate: "2022-06-01T00:00:00Z",
        endDate: "2022-07-01T00:00:00Z",
    },
    filter: {
        dimensions: [{
            name: "ResourceId",
            values: [exampleActionGroup.id],
        }],
        tags: [{
            name: "foo",
            values: [
                "bar",
                "baz",
            ],
        }],
    },
    notifications: [
        {
            enabled: true,
            threshold: 90,
            operator: "EqualTo",
            thresholdType: "Forecasted",
            contactEmails: [
                "foo@example.com",
                "bar@example.com",
            ],
            contactGroups: [exampleActionGroup.id],
            contactRoles: ["Owner"],
        },
        {
            enabled: false,
            threshold: 100,
            operator: "GreaterThan",
            contactEmails: [
                "foo@example.com",
                "bar@example.com",
            ],
        },
    ],
});
resources:
  exampleResourceGroup:
    type: azure:core:ResourceGroup
    properties:
      location: eastus
  exampleActionGroup:
    type: azure:monitoring:ActionGroup
    properties:
      resourceGroupName: ${exampleResourceGroup.name}
      shortName: example
  exampleBudgetResourceGroup:
    type: azure:consumption:BudgetResourceGroup
    properties:
      resourceGroupId: ${exampleResourceGroup.id}
      amount: 1000
      timeGrain: Monthly
      timePeriod:
        startDate: 2022-06-01T00:00:00Z
        endDate: 2022-07-01T00:00:00Z
      filter:
        dimensions:
          - name: ResourceId
            values:
              - ${exampleActionGroup.id}
        tags:
          - name: foo
            values:
              - bar
              - baz
      notifications:
        - enabled: true
          threshold: 90
          operator: EqualTo
          thresholdType: Forecasted
          contactEmails:
            - foo@example.com
            - bar@example.com
          contactGroups:
            - ${exampleActionGroup.id}
          contactRoles:
            - Owner
        - enabled: false
          threshold: 100
          operator: GreaterThan
          contactEmails:
            - foo@example.com
            - bar@example.com

Create a BudgetResourceGroup Resource

new BudgetResourceGroup(name: string, args: BudgetResourceGroupArgs, opts?: CustomResourceOptions);
@overload
def BudgetResourceGroup(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        amount: Optional[float] = None,
                        etag: Optional[str] = None,
                        filter: Optional[BudgetResourceGroupFilterArgs] = None,
                        name: Optional[str] = None,
                        notifications: Optional[Sequence[BudgetResourceGroupNotificationArgs]] = None,
                        resource_group_id: Optional[str] = None,
                        time_grain: Optional[str] = None,
                        time_period: Optional[BudgetResourceGroupTimePeriodArgs] = None)
@overload
def BudgetResourceGroup(resource_name: str,
                        args: BudgetResourceGroupArgs,
                        opts: Optional[ResourceOptions] = None)
func NewBudgetResourceGroup(ctx *Context, name string, args BudgetResourceGroupArgs, opts ...ResourceOption) (*BudgetResourceGroup, error)
public BudgetResourceGroup(string name, BudgetResourceGroupArgs args, CustomResourceOptions? opts = null)
public BudgetResourceGroup(String name, BudgetResourceGroupArgs args)
public BudgetResourceGroup(String name, BudgetResourceGroupArgs args, CustomResourceOptions options)
type: azure:consumption:BudgetResourceGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args BudgetResourceGroupArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args BudgetResourceGroupArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args BudgetResourceGroupArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args BudgetResourceGroupArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args BudgetResourceGroupArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

BudgetResourceGroup Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The BudgetResourceGroup resource accepts the following input properties:

Amount double

The total amount of cost to track with the budget.

Notifications List<BudgetResourceGroupNotificationArgs>

One or more notification blocks as defined below.

ResourceGroupId string

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

TimePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

Etag string

The ETag of the Resource Group Consumption Budget

Filter BudgetResourceGroupFilterArgs

A filter block as defined below.

Name string

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

TimeGrain string

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

Amount float64

The total amount of cost to track with the budget.

Notifications []BudgetResourceGroupNotificationArgs

One or more notification blocks as defined below.

ResourceGroupId string

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

TimePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

Etag string

The ETag of the Resource Group Consumption Budget

Filter BudgetResourceGroupFilterArgs

A filter block as defined below.

Name string

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

TimeGrain string

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

amount Double

The total amount of cost to track with the budget.

notifications List<BudgetResourceGroupNotificationArgs>

One or more notification blocks as defined below.

resourceGroupId String

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

timePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

etag String

The ETag of the Resource Group Consumption Budget

filter BudgetResourceGroupFilterArgs

A filter block as defined below.

name String

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

timeGrain String

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

amount number

The total amount of cost to track with the budget.

notifications BudgetResourceGroupNotificationArgs[]

One or more notification blocks as defined below.

resourceGroupId string

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

timePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

etag string

The ETag of the Resource Group Consumption Budget

filter BudgetResourceGroupFilterArgs

A filter block as defined below.

name string

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

timeGrain string

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

amount float

The total amount of cost to track with the budget.

notifications Sequence[BudgetResourceGroupNotificationArgs]

One or more notification blocks as defined below.

resource_group_id str

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

time_period BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

etag str

The ETag of the Resource Group Consumption Budget

filter BudgetResourceGroupFilterArgs

A filter block as defined below.

name str

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

time_grain str

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

amount Number

The total amount of cost to track with the budget.

notifications List<Property Map>

One or more notification blocks as defined below.

resourceGroupId String

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

timePeriod Property Map

A time_period block as defined below.

etag String

The ETag of the Resource Group Consumption Budget

filter Property Map

A filter block as defined below.

name String

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

timeGrain String

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

Outputs

All input properties are implicitly available as output properties. Additionally, the BudgetResourceGroup resource produces the following output properties:

Id string

The provider-assigned unique ID for this managed resource.

Id string

The provider-assigned unique ID for this managed resource.

id String

The provider-assigned unique ID for this managed resource.

id string

The provider-assigned unique ID for this managed resource.

id str

The provider-assigned unique ID for this managed resource.

id String

The provider-assigned unique ID for this managed resource.

Look up an Existing BudgetResourceGroup Resource

Get an existing BudgetResourceGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: BudgetResourceGroupState, opts?: CustomResourceOptions): BudgetResourceGroup
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        amount: Optional[float] = None,
        etag: Optional[str] = None,
        filter: Optional[BudgetResourceGroupFilterArgs] = None,
        name: Optional[str] = None,
        notifications: Optional[Sequence[BudgetResourceGroupNotificationArgs]] = None,
        resource_group_id: Optional[str] = None,
        time_grain: Optional[str] = None,
        time_period: Optional[BudgetResourceGroupTimePeriodArgs] = None) -> BudgetResourceGroup
func GetBudgetResourceGroup(ctx *Context, name string, id IDInput, state *BudgetResourceGroupState, opts ...ResourceOption) (*BudgetResourceGroup, error)
public static BudgetResourceGroup Get(string name, Input<string> id, BudgetResourceGroupState? state, CustomResourceOptions? opts = null)
public static BudgetResourceGroup get(String name, Output<String> id, BudgetResourceGroupState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
Amount double

The total amount of cost to track with the budget.

Etag string

The ETag of the Resource Group Consumption Budget

Filter BudgetResourceGroupFilterArgs

A filter block as defined below.

Name string

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

Notifications List<BudgetResourceGroupNotificationArgs>

One or more notification blocks as defined below.

ResourceGroupId string

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

TimeGrain string

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

TimePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

Amount float64

The total amount of cost to track with the budget.

Etag string

The ETag of the Resource Group Consumption Budget

Filter BudgetResourceGroupFilterArgs

A filter block as defined below.

Name string

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

Notifications []BudgetResourceGroupNotificationArgs

One or more notification blocks as defined below.

ResourceGroupId string

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

TimeGrain string

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

TimePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

amount Double

The total amount of cost to track with the budget.

etag String

The ETag of the Resource Group Consumption Budget

filter BudgetResourceGroupFilterArgs

A filter block as defined below.

name String

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

notifications List<BudgetResourceGroupNotificationArgs>

One or more notification blocks as defined below.

resourceGroupId String

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

timeGrain String

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

timePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

amount number

The total amount of cost to track with the budget.

etag string

The ETag of the Resource Group Consumption Budget

filter BudgetResourceGroupFilterArgs

A filter block as defined below.

name string

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

notifications BudgetResourceGroupNotificationArgs[]

One or more notification blocks as defined below.

resourceGroupId string

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

timeGrain string

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

timePeriod BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

amount float

The total amount of cost to track with the budget.

etag str

The ETag of the Resource Group Consumption Budget

filter BudgetResourceGroupFilterArgs

A filter block as defined below.

name str

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

notifications Sequence[BudgetResourceGroupNotificationArgs]

One or more notification blocks as defined below.

resource_group_id str

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

time_grain str

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

time_period BudgetResourceGroupTimePeriodArgs

A time_period block as defined below.

amount Number

The total amount of cost to track with the budget.

etag String

The ETag of the Resource Group Consumption Budget

filter Property Map

A filter block as defined below.

name String

The name which should be used for this Resource Group Consumption Budget. Changing this forces a new Resource Group Consumption Budget to be created.

notifications List<Property Map>

One or more notification blocks as defined below.

resourceGroupId String

The ID of the Resource Group to create the consumption budget for in the form of /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1. Changing this forces a new Resource Group Consumption Budget to be created.

timeGrain String

The time covered by a budget. Tracking of the amount will be reset based on the time grain. Must be one of Monthly, Quarterly, Annually, BillingMonth, BillingQuarter, or BillingYear. Defaults to Monthly.

timePeriod Property Map

A time_period block as defined below.

Supporting Types

BudgetResourceGroupFilter

Dimensions List<BudgetResourceGroupFilterDimension>

One or more dimension blocks as defined below to filter the budget on.

Not BudgetResourceGroupFilterNot

A not block as defined below to filter the budget on.

Tags List<BudgetResourceGroupFilterTag>

One or more tag blocks as defined below to filter the budget on.

Dimensions []BudgetResourceGroupFilterDimension

One or more dimension blocks as defined below to filter the budget on.

Not BudgetResourceGroupFilterNot

A not block as defined below to filter the budget on.

Tags []BudgetResourceGroupFilterTag

One or more tag blocks as defined below to filter the budget on.

dimensions List<BudgetResourceGroupFilterDimension>

One or more dimension blocks as defined below to filter the budget on.

not BudgetResourceGroupFilterNot

A not block as defined below to filter the budget on.

tags List<BudgetResourceGroupFilterTag>

One or more tag blocks as defined below to filter the budget on.

dimensions BudgetResourceGroupFilterDimension[]

One or more dimension blocks as defined below to filter the budget on.

not BudgetResourceGroupFilterNot

A not block as defined below to filter the budget on.

tags BudgetResourceGroupFilterTag[]

One or more tag blocks as defined below to filter the budget on.

dimensions Sequence[BudgetResourceGroupFilterDimension]

One or more dimension blocks as defined below to filter the budget on.

not_ BudgetResourceGroupFilterNot

A not block as defined below to filter the budget on.

tags Sequence[BudgetResourceGroupFilterTag]

One or more tag blocks as defined below to filter the budget on.

dimensions List<Property Map>

One or more dimension blocks as defined below to filter the budget on.

not Property Map

A not block as defined below to filter the budget on.

tags List<Property Map>

One or more tag blocks as defined below to filter the budget on.

BudgetResourceGroupFilterDimension

Name string

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

Values List<string>

Specifies a list of values for the column.

Operator string

The operator to use for comparison. The allowed values are In.

Name string

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

Values []string

Specifies a list of values for the column.

Operator string

The operator to use for comparison. The allowed values are In.

name String

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values List<String>

Specifies a list of values for the column.

operator String

The operator to use for comparison. The allowed values are In.

name string

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values string[]

Specifies a list of values for the column.

operator string

The operator to use for comparison. The allowed values are In.

name str

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values Sequence[str]

Specifies a list of values for the column.

operator str

The operator to use for comparison. The allowed values are In.

name String

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values List<String>

Specifies a list of values for the column.

operator String

The operator to use for comparison. The allowed values are In.

BudgetResourceGroupFilterNot

Dimension BudgetResourceGroupFilterNotDimension

One dimension block as defined below to filter the budget on. Conflicts with tag.

Tag BudgetResourceGroupFilterNotTag

One tag block as defined below to filter the budget on. Conflicts with dimension.

Dimension BudgetResourceGroupFilterNotDimension

One dimension block as defined below to filter the budget on. Conflicts with tag.

Tag BudgetResourceGroupFilterNotTag

One tag block as defined below to filter the budget on. Conflicts with dimension.

dimension BudgetResourceGroupFilterNotDimension

One dimension block as defined below to filter the budget on. Conflicts with tag.

tag BudgetResourceGroupFilterNotTag

One tag block as defined below to filter the budget on. Conflicts with dimension.

dimension BudgetResourceGroupFilterNotDimension

One dimension block as defined below to filter the budget on. Conflicts with tag.

tag BudgetResourceGroupFilterNotTag

One tag block as defined below to filter the budget on. Conflicts with dimension.

dimension BudgetResourceGroupFilterNotDimension

One dimension block as defined below to filter the budget on. Conflicts with tag.

tag BudgetResourceGroupFilterNotTag

One tag block as defined below to filter the budget on. Conflicts with dimension.

dimension Property Map

One dimension block as defined below to filter the budget on. Conflicts with tag.

tag Property Map

One tag block as defined below to filter the budget on. Conflicts with dimension.

BudgetResourceGroupFilterNotDimension

Name string

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

Values List<string>

Specifies a list of values for the column.

Operator string

The operator to use for comparison. The allowed values are In.

Name string

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

Values []string

Specifies a list of values for the column.

Operator string

The operator to use for comparison. The allowed values are In.

name String

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values List<String>

Specifies a list of values for the column.

operator String

The operator to use for comparison. The allowed values are In.

name string

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values string[]

Specifies a list of values for the column.

operator string

The operator to use for comparison. The allowed values are In.

name str

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values Sequence[str]

Specifies a list of values for the column.

operator str

The operator to use for comparison. The allowed values are In.

name String

The name of the column to use for the filter. The allowed values are ChargeType, Frequency, InvoiceId, Meter, MeterCategory, MeterSubCategory, PartNumber, PricingModel, Product, ProductOrderId, ProductOrderName, PublisherType, ReservationId, ReservationName, ResourceGroupName, ResourceGuid, ResourceId, ResourceLocation, ResourceType, ServiceFamily, ServiceName, SubscriptionID, SubscriptionName, UnitOfMeasure.

values List<String>

Specifies a list of values for the column.

operator String

The operator to use for comparison. The allowed values are In.

BudgetResourceGroupFilterNotTag

Name string

The name of the tag to use for the filter.

Values List<string>

Specifies a list of values for the tag.

Operator string

The operator to use for comparison. The allowed values are In.

Name string

The name of the tag to use for the filter.

Values []string

Specifies a list of values for the tag.

Operator string

The operator to use for comparison. The allowed values are In.

name String

The name of the tag to use for the filter.

values List<String>

Specifies a list of values for the tag.

operator String

The operator to use for comparison. The allowed values are In.

name string

The name of the tag to use for the filter.

values string[]

Specifies a list of values for the tag.

operator string

The operator to use for comparison. The allowed values are In.

name str

The name of the tag to use for the filter.

values Sequence[str]

Specifies a list of values for the tag.

operator str

The operator to use for comparison. The allowed values are In.

name String

The name of the tag to use for the filter.

values List<String>

Specifies a list of values for the tag.

operator String

The operator to use for comparison. The allowed values are In.

BudgetResourceGroupFilterTag

Name string

The name of the tag to use for the filter.

Values List<string>

Specifies a list of values for the tag.

Operator string

The operator to use for comparison. The allowed values are In.

Name string

The name of the tag to use for the filter.

Values []string

Specifies a list of values for the tag.

Operator string

The operator to use for comparison. The allowed values are In.

name String

The name of the tag to use for the filter.

values List<String>

Specifies a list of values for the tag.

operator String

The operator to use for comparison. The allowed values are In.

name string

The name of the tag to use for the filter.

values string[]

Specifies a list of values for the tag.

operator string

The operator to use for comparison. The allowed values are In.

name str

The name of the tag to use for the filter.

values Sequence[str]

Specifies a list of values for the tag.

operator str

The operator to use for comparison. The allowed values are In.

name String

The name of the tag to use for the filter.

values List<String>

Specifies a list of values for the tag.

operator String

The operator to use for comparison. The allowed values are In.

BudgetResourceGroupNotification

Operator string

The comparison operator for the notification. Must be one of EqualTo, GreaterThan, or GreaterThanOrEqualTo.

Threshold int

Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.

ContactEmails List<string>

Specifies a list of email addresses to send the budget notification to when the threshold is exceeded.

ContactGroups List<string>

Specifies a list of Action Group IDs to send the budget notification to when the threshold is exceeded.

ContactRoles List<string>

Specifies a list of contact roles to send the budget notification to when the threshold is exceeded.

Enabled bool

Should the notification be enabled?

ThresholdType string

The type of threshold for the notification. This determines whether the notification is triggered by forecasted costs or actual costs. The allowed values are Actual and Forecasted. Default is Actual.

Operator string

The comparison operator for the notification. Must be one of EqualTo, GreaterThan, or GreaterThanOrEqualTo.

Threshold int

Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.

ContactEmails []string

Specifies a list of email addresses to send the budget notification to when the threshold is exceeded.

ContactGroups []string

Specifies a list of Action Group IDs to send the budget notification to when the threshold is exceeded.

ContactRoles []string

Specifies a list of contact roles to send the budget notification to when the threshold is exceeded.

Enabled bool

Should the notification be enabled?

ThresholdType string

The type of threshold for the notification. This determines whether the notification is triggered by forecasted costs or actual costs. The allowed values are Actual and Forecasted. Default is Actual.

operator String

The comparison operator for the notification. Must be one of EqualTo, GreaterThan, or GreaterThanOrEqualTo.

threshold Integer

Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.

contactEmails List<String>

Specifies a list of email addresses to send the budget notification to when the threshold is exceeded.

contactGroups List<String>

Specifies a list of Action Group IDs to send the budget notification to when the threshold is exceeded.

contactRoles List<String>

Specifies a list of contact roles to send the budget notification to when the threshold is exceeded.

enabled Boolean

Should the notification be enabled?

thresholdType String

The type of threshold for the notification. This determines whether the notification is triggered by forecasted costs or actual costs. The allowed values are Actual and Forecasted. Default is Actual.

operator string

The comparison operator for the notification. Must be one of EqualTo, GreaterThan, or GreaterThanOrEqualTo.

threshold number

Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.

contactEmails string[]

Specifies a list of email addresses to send the budget notification to when the threshold is exceeded.

contactGroups string[]

Specifies a list of Action Group IDs to send the budget notification to when the threshold is exceeded.

contactRoles string[]

Specifies a list of contact roles to send the budget notification to when the threshold is exceeded.

enabled boolean

Should the notification be enabled?

thresholdType string

The type of threshold for the notification. This determines whether the notification is triggered by forecasted costs or actual costs. The allowed values are Actual and Forecasted. Default is Actual.

operator str

The comparison operator for the notification. Must be one of EqualTo, GreaterThan, or GreaterThanOrEqualTo.

threshold int

Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.

contact_emails Sequence[str]

Specifies a list of email addresses to send the budget notification to when the threshold is exceeded.

contact_groups Sequence[str]

Specifies a list of Action Group IDs to send the budget notification to when the threshold is exceeded.

contact_roles Sequence[str]

Specifies a list of contact roles to send the budget notification to when the threshold is exceeded.

enabled bool

Should the notification be enabled?

threshold_type str

The type of threshold for the notification. This determines whether the notification is triggered by forecasted costs or actual costs. The allowed values are Actual and Forecasted. Default is Actual.

operator String

The comparison operator for the notification. Must be one of EqualTo, GreaterThan, or GreaterThanOrEqualTo.

threshold Number

Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.

contactEmails List<String>

Specifies a list of email addresses to send the budget notification to when the threshold is exceeded.

contactGroups List<String>

Specifies a list of Action Group IDs to send the budget notification to when the threshold is exceeded.

contactRoles List<String>

Specifies a list of contact roles to send the budget notification to when the threshold is exceeded.

enabled Boolean

Should the notification be enabled?

thresholdType String

The type of threshold for the notification. This determines whether the notification is triggered by forecasted costs or actual costs. The allowed values are Actual and Forecasted. Default is Actual.

BudgetResourceGroupTimePeriod

StartDate string

The start date for the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should be selected within the timegrain period. Changing this forces a new Resource Group Consumption Budget to be created.

EndDate string

The end date for the budget. If not set this will be 10 years after the start date.

StartDate string

The start date for the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should be selected within the timegrain period. Changing this forces a new Resource Group Consumption Budget to be created.

EndDate string

The end date for the budget. If not set this will be 10 years after the start date.

startDate String

The start date for the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should be selected within the timegrain period. Changing this forces a new Resource Group Consumption Budget to be created.

endDate String

The end date for the budget. If not set this will be 10 years after the start date.

startDate string

The start date for the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should be selected within the timegrain period. Changing this forces a new Resource Group Consumption Budget to be created.

endDate string

The end date for the budget. If not set this will be 10 years after the start date.

start_date str

The start date for the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should be selected within the timegrain period. Changing this forces a new Resource Group Consumption Budget to be created.

end_date str

The end date for the budget. If not set this will be 10 years after the start date.

startDate String

The start date for the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should be selected within the timegrain period. Changing this forces a new Resource Group Consumption Budget to be created.

endDate String

The end date for the budget. If not set this will be 10 years after the start date.

Import

Resource Group Consumption Budgets can be imported using the resource id, e.g.

 $ pulumi import azure:consumption/budgetResourceGroup:BudgetResourceGroup example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1/providers/Microsoft.Consumption/budgets/resourceGroup1

Package Details

Repository
https://github.com/pulumi/pulumi-azure
License
Apache-2.0
Notes

This Pulumi package is based on the azurerm Terraform Provider.