budgets

package
v1.31.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 13, 2020 License: Apache-2.0 Imports: 4 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Budget

type Budget struct {
	pulumi.CustomResourceState

	// The ID of the target account for budget. Will use current user's accountId by default if omitted.
	AccountId pulumi.StringOutput `pulumi:"accountId"`
	// Whether this budget tracks monetary cost or usage.
	BudgetType pulumi.StringOutput `pulumi:"budgetType"`
	// Map of CostFilters key/value pairs to apply to the budget.
	CostFilters pulumi.MapOutput `pulumi:"costFilters"`
	// Object containing CostTypes The types of cost included in a budget, such as tax and subscriptions..
	CostTypes BudgetCostTypesOutput `pulumi:"costTypes"`
	// The amount of cost or usage being measured for a budget.
	LimitAmount pulumi.StringOutput `pulumi:"limitAmount"`
	// The unit of measurement used for the budget forecast, actual spend, or budget threshold, such as dollars or GB. See [Spend](http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/data-type-spend.html) documentation.
	LimitUnit pulumi.StringOutput `pulumi:"limitUnit"`
	// The name of a budget. Unique within accounts.
	Name pulumi.StringOutput `pulumi:"name"`
	// The prefix of the name of a budget. Unique within accounts.
	NamePrefix pulumi.StringOutput `pulumi:"namePrefix"`
	// Object containing Budget Notifications. Can be used multiple times to define more than one budget notification
	Notifications BudgetNotificationArrayOutput `pulumi:"notifications"`
	// The end of the time period covered by the budget. There are no restrictions on the end date. Format: `2017-01-01_12:00`.
	TimePeriodEnd pulumi.StringPtrOutput `pulumi:"timePeriodEnd"`
	// The start of the time period covered by the budget. The start date must come before the end date. Format: `2017-01-01_12:00`.
	TimePeriodStart pulumi.StringOutput `pulumi:"timePeriodStart"`
	// The length of time until a budget resets the actual and forecasted spend. Valid values: `MONTHLY`, `QUARTERLY`, `ANNUALLY`.
	TimeUnit pulumi.StringOutput `pulumi:"timeUnit"`
}

Provides a budgets budget resource. Budgets use the cost visualisation provided by Cost Explorer to show you the status of your budgets, to provide forecasts of your estimated costs, and to track your AWS usage, including your free tier usage.

func GetBudget

func GetBudget(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *BudgetState, opts ...pulumi.ResourceOption) (*Budget, error)

GetBudget gets an existing Budget resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewBudget

func NewBudget(ctx *pulumi.Context,
	name string, args *BudgetArgs, opts ...pulumi.ResourceOption) (*Budget, error)

NewBudget registers a new resource with the given unique name, arguments, and options.

type BudgetArgs

type BudgetArgs struct {
	// The ID of the target account for budget. Will use current user's accountId by default if omitted.
	AccountId pulumi.StringPtrInput
	// Whether this budget tracks monetary cost or usage.
	BudgetType pulumi.StringInput
	// Map of CostFilters key/value pairs to apply to the budget.
	CostFilters pulumi.MapInput
	// Object containing CostTypes The types of cost included in a budget, such as tax and subscriptions..
	CostTypes BudgetCostTypesPtrInput
	// The amount of cost or usage being measured for a budget.
	LimitAmount pulumi.StringInput
	// The unit of measurement used for the budget forecast, actual spend, or budget threshold, such as dollars or GB. See [Spend](http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/data-type-spend.html) documentation.
	LimitUnit pulumi.StringInput
	// The name of a budget. Unique within accounts.
	Name pulumi.StringPtrInput
	// The prefix of the name of a budget. Unique within accounts.
	NamePrefix pulumi.StringPtrInput
	// Object containing Budget Notifications. Can be used multiple times to define more than one budget notification
	Notifications BudgetNotificationArrayInput
	// The end of the time period covered by the budget. There are no restrictions on the end date. Format: `2017-01-01_12:00`.
	TimePeriodEnd pulumi.StringPtrInput
	// The start of the time period covered by the budget. The start date must come before the end date. Format: `2017-01-01_12:00`.
	TimePeriodStart pulumi.StringInput
	// The length of time until a budget resets the actual and forecasted spend. Valid values: `MONTHLY`, `QUARTERLY`, `ANNUALLY`.
	TimeUnit pulumi.StringInput
}

The set of arguments for constructing a Budget resource.

func (BudgetArgs) ElementType

func (BudgetArgs) ElementType() reflect.Type

type BudgetCostTypes

type BudgetCostTypes struct {
	// A boolean value whether to include credits in the cost budget. Defaults to `true`
	IncludeCredit *bool `pulumi:"includeCredit"`
	// Specifies whether a budget includes discounts. Defaults to `true`
	IncludeDiscount *bool `pulumi:"includeDiscount"`
	// A boolean value whether to include other subscription costs in the cost budget. Defaults to `true`
	IncludeOtherSubscription *bool `pulumi:"includeOtherSubscription"`
	// A boolean value whether to include recurring costs in the cost budget. Defaults to `true`
	IncludeRecurring *bool `pulumi:"includeRecurring"`
	// A boolean value whether to include refunds in the cost budget. Defaults to `true`
	IncludeRefund *bool `pulumi:"includeRefund"`
	// A boolean value whether to include subscriptions in the cost budget. Defaults to `true`
	IncludeSubscription *bool `pulumi:"includeSubscription"`
	// A boolean value whether to include support costs in the cost budget. Defaults to `true`
	IncludeSupport *bool `pulumi:"includeSupport"`
	// A boolean value whether to include tax in the cost budget. Defaults to `true`
	IncludeTax *bool `pulumi:"includeTax"`
	// A boolean value whether to include upfront costs in the cost budget. Defaults to `true`
	IncludeUpfront *bool `pulumi:"includeUpfront"`
	// Specifies whether a budget uses the amortized rate. Defaults to `false`
	UseAmortized *bool `pulumi:"useAmortized"`
	// A boolean value whether to use blended costs in the cost budget. Defaults to `false`
	UseBlended *bool `pulumi:"useBlended"`
}

type BudgetCostTypesArgs

type BudgetCostTypesArgs struct {
	// A boolean value whether to include credits in the cost budget. Defaults to `true`
	IncludeCredit pulumi.BoolPtrInput `pulumi:"includeCredit"`
	// Specifies whether a budget includes discounts. Defaults to `true`
	IncludeDiscount pulumi.BoolPtrInput `pulumi:"includeDiscount"`
	// A boolean value whether to include other subscription costs in the cost budget. Defaults to `true`
	IncludeOtherSubscription pulumi.BoolPtrInput `pulumi:"includeOtherSubscription"`
	// A boolean value whether to include recurring costs in the cost budget. Defaults to `true`
	IncludeRecurring pulumi.BoolPtrInput `pulumi:"includeRecurring"`
	// A boolean value whether to include refunds in the cost budget. Defaults to `true`
	IncludeRefund pulumi.BoolPtrInput `pulumi:"includeRefund"`
	// A boolean value whether to include subscriptions in the cost budget. Defaults to `true`
	IncludeSubscription pulumi.BoolPtrInput `pulumi:"includeSubscription"`
	// A boolean value whether to include support costs in the cost budget. Defaults to `true`
	IncludeSupport pulumi.BoolPtrInput `pulumi:"includeSupport"`
	// A boolean value whether to include tax in the cost budget. Defaults to `true`
	IncludeTax pulumi.BoolPtrInput `pulumi:"includeTax"`
	// A boolean value whether to include upfront costs in the cost budget. Defaults to `true`
	IncludeUpfront pulumi.BoolPtrInput `pulumi:"includeUpfront"`
	// Specifies whether a budget uses the amortized rate. Defaults to `false`
	UseAmortized pulumi.BoolPtrInput `pulumi:"useAmortized"`
	// A boolean value whether to use blended costs in the cost budget. Defaults to `false`
	UseBlended pulumi.BoolPtrInput `pulumi:"useBlended"`
}

func (BudgetCostTypesArgs) ElementType

func (BudgetCostTypesArgs) ElementType() reflect.Type

func (BudgetCostTypesArgs) ToBudgetCostTypesOutput

func (i BudgetCostTypesArgs) ToBudgetCostTypesOutput() BudgetCostTypesOutput

func (BudgetCostTypesArgs) ToBudgetCostTypesOutputWithContext

func (i BudgetCostTypesArgs) ToBudgetCostTypesOutputWithContext(ctx context.Context) BudgetCostTypesOutput

func (BudgetCostTypesArgs) ToBudgetCostTypesPtrOutput

func (i BudgetCostTypesArgs) ToBudgetCostTypesPtrOutput() BudgetCostTypesPtrOutput

func (BudgetCostTypesArgs) ToBudgetCostTypesPtrOutputWithContext

func (i BudgetCostTypesArgs) ToBudgetCostTypesPtrOutputWithContext(ctx context.Context) BudgetCostTypesPtrOutput

type BudgetCostTypesInput

type BudgetCostTypesInput interface {
	pulumi.Input

	ToBudgetCostTypesOutput() BudgetCostTypesOutput
	ToBudgetCostTypesOutputWithContext(context.Context) BudgetCostTypesOutput
}

type BudgetCostTypesOutput

type BudgetCostTypesOutput struct{ *pulumi.OutputState }

func (BudgetCostTypesOutput) ElementType

func (BudgetCostTypesOutput) ElementType() reflect.Type

func (BudgetCostTypesOutput) IncludeCredit

func (o BudgetCostTypesOutput) IncludeCredit() pulumi.BoolPtrOutput

A boolean value whether to include credits in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) IncludeDiscount

func (o BudgetCostTypesOutput) IncludeDiscount() pulumi.BoolPtrOutput

Specifies whether a budget includes discounts. Defaults to `true`

func (BudgetCostTypesOutput) IncludeOtherSubscription

func (o BudgetCostTypesOutput) IncludeOtherSubscription() pulumi.BoolPtrOutput

A boolean value whether to include other subscription costs in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) IncludeRecurring

func (o BudgetCostTypesOutput) IncludeRecurring() pulumi.BoolPtrOutput

A boolean value whether to include recurring costs in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) IncludeRefund

func (o BudgetCostTypesOutput) IncludeRefund() pulumi.BoolPtrOutput

A boolean value whether to include refunds in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) IncludeSubscription

func (o BudgetCostTypesOutput) IncludeSubscription() pulumi.BoolPtrOutput

A boolean value whether to include subscriptions in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) IncludeSupport

func (o BudgetCostTypesOutput) IncludeSupport() pulumi.BoolPtrOutput

A boolean value whether to include support costs in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) IncludeTax

A boolean value whether to include tax in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) IncludeUpfront

func (o BudgetCostTypesOutput) IncludeUpfront() pulumi.BoolPtrOutput

A boolean value whether to include upfront costs in the cost budget. Defaults to `true`

func (BudgetCostTypesOutput) ToBudgetCostTypesOutput

func (o BudgetCostTypesOutput) ToBudgetCostTypesOutput() BudgetCostTypesOutput

func (BudgetCostTypesOutput) ToBudgetCostTypesOutputWithContext

func (o BudgetCostTypesOutput) ToBudgetCostTypesOutputWithContext(ctx context.Context) BudgetCostTypesOutput

func (BudgetCostTypesOutput) ToBudgetCostTypesPtrOutput

func (o BudgetCostTypesOutput) ToBudgetCostTypesPtrOutput() BudgetCostTypesPtrOutput

func (BudgetCostTypesOutput) ToBudgetCostTypesPtrOutputWithContext

func (o BudgetCostTypesOutput) ToBudgetCostTypesPtrOutputWithContext(ctx context.Context) BudgetCostTypesPtrOutput

func (BudgetCostTypesOutput) UseAmortized

func (o BudgetCostTypesOutput) UseAmortized() pulumi.BoolPtrOutput

Specifies whether a budget uses the amortized rate. Defaults to `false`

func (BudgetCostTypesOutput) UseBlended

A boolean value whether to use blended costs in the cost budget. Defaults to `false`

type BudgetCostTypesPtrInput

type BudgetCostTypesPtrInput interface {
	pulumi.Input

	ToBudgetCostTypesPtrOutput() BudgetCostTypesPtrOutput
	ToBudgetCostTypesPtrOutputWithContext(context.Context) BudgetCostTypesPtrOutput
}

type BudgetCostTypesPtrOutput

type BudgetCostTypesPtrOutput struct{ *pulumi.OutputState }

func (BudgetCostTypesPtrOutput) Elem

func (BudgetCostTypesPtrOutput) ElementType

func (BudgetCostTypesPtrOutput) ElementType() reflect.Type

func (BudgetCostTypesPtrOutput) IncludeCredit

func (o BudgetCostTypesPtrOutput) IncludeCredit() pulumi.BoolPtrOutput

A boolean value whether to include credits in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeDiscount

func (o BudgetCostTypesPtrOutput) IncludeDiscount() pulumi.BoolPtrOutput

Specifies whether a budget includes discounts. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeOtherSubscription

func (o BudgetCostTypesPtrOutput) IncludeOtherSubscription() pulumi.BoolPtrOutput

A boolean value whether to include other subscription costs in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeRecurring

func (o BudgetCostTypesPtrOutput) IncludeRecurring() pulumi.BoolPtrOutput

A boolean value whether to include recurring costs in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeRefund

func (o BudgetCostTypesPtrOutput) IncludeRefund() pulumi.BoolPtrOutput

A boolean value whether to include refunds in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeSubscription

func (o BudgetCostTypesPtrOutput) IncludeSubscription() pulumi.BoolPtrOutput

A boolean value whether to include subscriptions in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeSupport

func (o BudgetCostTypesPtrOutput) IncludeSupport() pulumi.BoolPtrOutput

A boolean value whether to include support costs in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeTax

A boolean value whether to include tax in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) IncludeUpfront

func (o BudgetCostTypesPtrOutput) IncludeUpfront() pulumi.BoolPtrOutput

A boolean value whether to include upfront costs in the cost budget. Defaults to `true`

func (BudgetCostTypesPtrOutput) ToBudgetCostTypesPtrOutput

func (o BudgetCostTypesPtrOutput) ToBudgetCostTypesPtrOutput() BudgetCostTypesPtrOutput

func (BudgetCostTypesPtrOutput) ToBudgetCostTypesPtrOutputWithContext

func (o BudgetCostTypesPtrOutput) ToBudgetCostTypesPtrOutputWithContext(ctx context.Context) BudgetCostTypesPtrOutput

func (BudgetCostTypesPtrOutput) UseAmortized

Specifies whether a budget uses the amortized rate. Defaults to `false`

func (BudgetCostTypesPtrOutput) UseBlended

A boolean value whether to use blended costs in the cost budget. Defaults to `false`

type BudgetNotification

type BudgetNotification struct {
	// (Required) Comparison operator to use to evaluate the condition. Can be `LESS_THAN`, `EQUAL_TO` or `GREATER_THAN`.
	ComparisonOperator string `pulumi:"comparisonOperator"`
	// (Required) What kind of budget value to notify on. Can be `ACTUAL` or `FORECASTED`
	NotificationType string `pulumi:"notificationType"`
	// (Optional) E-Mail addresses to notify. Either this or `subscriberSnsTopicArns` is required.
	SubscriberEmailAddresses []string `pulumi:"subscriberEmailAddresses"`
	// (Optional) SNS topics to notify. Either this or `subscriberEmailAddresses` is required.
	SubscriberSnsTopicArns []string `pulumi:"subscriberSnsTopicArns"`
	// (Required) Threshold when the notification should be sent.
	Threshold float64 `pulumi:"threshold"`
	// (Required) What kind of threshold is defined. Can be `PERCENTAGE` OR `ABSOLUTE_VALUE`.
	ThresholdType string `pulumi:"thresholdType"`
}

type BudgetNotificationArgs

type BudgetNotificationArgs struct {
	// (Required) Comparison operator to use to evaluate the condition. Can be `LESS_THAN`, `EQUAL_TO` or `GREATER_THAN`.
	ComparisonOperator pulumi.StringInput `pulumi:"comparisonOperator"`
	// (Required) What kind of budget value to notify on. Can be `ACTUAL` or `FORECASTED`
	NotificationType pulumi.StringInput `pulumi:"notificationType"`
	// (Optional) E-Mail addresses to notify. Either this or `subscriberSnsTopicArns` is required.
	SubscriberEmailAddresses pulumi.StringArrayInput `pulumi:"subscriberEmailAddresses"`
	// (Optional) SNS topics to notify. Either this or `subscriberEmailAddresses` is required.
	SubscriberSnsTopicArns pulumi.StringArrayInput `pulumi:"subscriberSnsTopicArns"`
	// (Required) Threshold when the notification should be sent.
	Threshold pulumi.Float64Input `pulumi:"threshold"`
	// (Required) What kind of threshold is defined. Can be `PERCENTAGE` OR `ABSOLUTE_VALUE`.
	ThresholdType pulumi.StringInput `pulumi:"thresholdType"`
}

func (BudgetNotificationArgs) ElementType

func (BudgetNotificationArgs) ElementType() reflect.Type

func (BudgetNotificationArgs) ToBudgetNotificationOutput

func (i BudgetNotificationArgs) ToBudgetNotificationOutput() BudgetNotificationOutput

func (BudgetNotificationArgs) ToBudgetNotificationOutputWithContext

func (i BudgetNotificationArgs) ToBudgetNotificationOutputWithContext(ctx context.Context) BudgetNotificationOutput

type BudgetNotificationArray

type BudgetNotificationArray []BudgetNotificationInput

func (BudgetNotificationArray) ElementType

func (BudgetNotificationArray) ElementType() reflect.Type

func (BudgetNotificationArray) ToBudgetNotificationArrayOutput

func (i BudgetNotificationArray) ToBudgetNotificationArrayOutput() BudgetNotificationArrayOutput

func (BudgetNotificationArray) ToBudgetNotificationArrayOutputWithContext

func (i BudgetNotificationArray) ToBudgetNotificationArrayOutputWithContext(ctx context.Context) BudgetNotificationArrayOutput

type BudgetNotificationArrayInput

type BudgetNotificationArrayInput interface {
	pulumi.Input

	ToBudgetNotificationArrayOutput() BudgetNotificationArrayOutput
	ToBudgetNotificationArrayOutputWithContext(context.Context) BudgetNotificationArrayOutput
}

type BudgetNotificationArrayOutput

type BudgetNotificationArrayOutput struct{ *pulumi.OutputState }

func (BudgetNotificationArrayOutput) ElementType

func (BudgetNotificationArrayOutput) Index

func (BudgetNotificationArrayOutput) ToBudgetNotificationArrayOutput

func (o BudgetNotificationArrayOutput) ToBudgetNotificationArrayOutput() BudgetNotificationArrayOutput

func (BudgetNotificationArrayOutput) ToBudgetNotificationArrayOutputWithContext

func (o BudgetNotificationArrayOutput) ToBudgetNotificationArrayOutputWithContext(ctx context.Context) BudgetNotificationArrayOutput

type BudgetNotificationInput

type BudgetNotificationInput interface {
	pulumi.Input

	ToBudgetNotificationOutput() BudgetNotificationOutput
	ToBudgetNotificationOutputWithContext(context.Context) BudgetNotificationOutput
}

type BudgetNotificationOutput

type BudgetNotificationOutput struct{ *pulumi.OutputState }

func (BudgetNotificationOutput) ComparisonOperator

func (o BudgetNotificationOutput) ComparisonOperator() pulumi.StringOutput

(Required) Comparison operator to use to evaluate the condition. Can be `LESS_THAN`, `EQUAL_TO` or `GREATER_THAN`.

func (BudgetNotificationOutput) ElementType

func (BudgetNotificationOutput) ElementType() reflect.Type

func (BudgetNotificationOutput) NotificationType

func (o BudgetNotificationOutput) NotificationType() pulumi.StringOutput

(Required) What kind of budget value to notify on. Can be `ACTUAL` or `FORECASTED`

func (BudgetNotificationOutput) SubscriberEmailAddresses

func (o BudgetNotificationOutput) SubscriberEmailAddresses() pulumi.StringArrayOutput

(Optional) E-Mail addresses to notify. Either this or `subscriberSnsTopicArns` is required.

func (BudgetNotificationOutput) SubscriberSnsTopicArns

func (o BudgetNotificationOutput) SubscriberSnsTopicArns() pulumi.StringArrayOutput

(Optional) SNS topics to notify. Either this or `subscriberEmailAddresses` is required.

func (BudgetNotificationOutput) Threshold

(Required) Threshold when the notification should be sent.

func (BudgetNotificationOutput) ThresholdType

func (o BudgetNotificationOutput) ThresholdType() pulumi.StringOutput

(Required) What kind of threshold is defined. Can be `PERCENTAGE` OR `ABSOLUTE_VALUE`.

func (BudgetNotificationOutput) ToBudgetNotificationOutput

func (o BudgetNotificationOutput) ToBudgetNotificationOutput() BudgetNotificationOutput

func (BudgetNotificationOutput) ToBudgetNotificationOutputWithContext

func (o BudgetNotificationOutput) ToBudgetNotificationOutputWithContext(ctx context.Context) BudgetNotificationOutput

type BudgetState

type BudgetState struct {
	// The ID of the target account for budget. Will use current user's accountId by default if omitted.
	AccountId pulumi.StringPtrInput
	// Whether this budget tracks monetary cost or usage.
	BudgetType pulumi.StringPtrInput
	// Map of CostFilters key/value pairs to apply to the budget.
	CostFilters pulumi.MapInput
	// Object containing CostTypes The types of cost included in a budget, such as tax and subscriptions..
	CostTypes BudgetCostTypesPtrInput
	// The amount of cost or usage being measured for a budget.
	LimitAmount pulumi.StringPtrInput
	// The unit of measurement used for the budget forecast, actual spend, or budget threshold, such as dollars or GB. See [Spend](http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/data-type-spend.html) documentation.
	LimitUnit pulumi.StringPtrInput
	// The name of a budget. Unique within accounts.
	Name pulumi.StringPtrInput
	// The prefix of the name of a budget. Unique within accounts.
	NamePrefix pulumi.StringPtrInput
	// Object containing Budget Notifications. Can be used multiple times to define more than one budget notification
	Notifications BudgetNotificationArrayInput
	// The end of the time period covered by the budget. There are no restrictions on the end date. Format: `2017-01-01_12:00`.
	TimePeriodEnd pulumi.StringPtrInput
	// The start of the time period covered by the budget. The start date must come before the end date. Format: `2017-01-01_12:00`.
	TimePeriodStart pulumi.StringPtrInput
	// The length of time until a budget resets the actual and forecasted spend. Valid values: `MONTHLY`, `QUARTERLY`, `ANNUALLY`.
	TimeUnit pulumi.StringPtrInput
}

func (BudgetState) ElementType

func (BudgetState) ElementType() reflect.Type

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL