Google Cloud Billing Budgets V1 Client - Class Budget (1.1.0)

Reference documentation and code samples for the Google Cloud Billing Budgets V1 Client class Budget.

A budget is a plan that describes what you expect to spend on Cloud projects, plus the rules to execute as spend is tracked against that plan, (for example, send an alert when 90% of the target spend is met).

The budget time period is configurable, with options such as month (default), quarter, year, or custom time period.

Generated from protobuf message google.cloud.billing.budgets.v1.Budget

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

Output only. Resource name of the budget. The resource name implies the scope of a budget. Values are of the form billingAccounts/{billingAccountId}/budgets/{budgetId}.

↳ display_name string

User data for display name in UI. The name must be less than or equal to 60 characters.

↳ budget_filter Google\Cloud\Billing\Budgets\V1\Filter

Optional. Filters that define which resources are used to compute the actual spend against the budget amount, such as projects, services, and the budget's time period, as well as other filters.

↳ amount Google\Cloud\Billing\Budgets\V1\BudgetAmount

Required. Budgeted amount.

↳ threshold_rules array<Google\Cloud\Billing\Budgets\V1\ThresholdRule>

Optional. Rules that trigger alerts (notifications of thresholds being crossed) when spend exceeds the specified percentages of the budget.

↳ notifications_rule Google\Cloud\Billing\Budgets\V1\NotificationsRule

Optional. Rules to apply to notifications sent based on budget spend and thresholds.

↳ etag string

Optional. Etag to validate that the object is unchanged for a read-modify-write operation. An empty etag will cause an update to overwrite other changes.

getName

Output only. Resource name of the budget.

The resource name implies the scope of a budget. Values are of the form billingAccounts/{billingAccountId}/budgets/{budgetId}.

Returns
TypeDescription
string

setName

Output only. Resource name of the budget.

The resource name implies the scope of a budget. Values are of the form billingAccounts/{billingAccountId}/budgets/{budgetId}.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDisplayName

User data for display name in UI. The name must be less than or equal to 60 characters.

Returns
TypeDescription
string

setDisplayName

User data for display name in UI. The name must be less than or equal to 60 characters.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getBudgetFilter

Optional. Filters that define which resources are used to compute the actual spend against the budget amount, such as projects, services, and the budget's time period, as well as other filters.

Returns
TypeDescription
Google\Cloud\Billing\Budgets\V1\Filter|null

hasBudgetFilter

clearBudgetFilter

setBudgetFilter

Optional. Filters that define which resources are used to compute the actual spend against the budget amount, such as projects, services, and the budget's time period, as well as other filters.

Parameter
NameDescription
var Google\Cloud\Billing\Budgets\V1\Filter
Returns
TypeDescription
$this

getAmount

Required. Budgeted amount.

Returns
TypeDescription
Google\Cloud\Billing\Budgets\V1\BudgetAmount|null

hasAmount

clearAmount

setAmount

Required. Budgeted amount.

Parameter
NameDescription
var Google\Cloud\Billing\Budgets\V1\BudgetAmount
Returns
TypeDescription
$this

getThresholdRules

Optional. Rules that trigger alerts (notifications of thresholds being crossed) when spend exceeds the specified percentages of the budget.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setThresholdRules

Optional. Rules that trigger alerts (notifications of thresholds being crossed) when spend exceeds the specified percentages of the budget.

Parameter
NameDescription
var array<Google\Cloud\Billing\Budgets\V1\ThresholdRule>
Returns
TypeDescription
$this

getNotificationsRule

Optional. Rules to apply to notifications sent based on budget spend and thresholds.

Returns
TypeDescription
Google\Cloud\Billing\Budgets\V1\NotificationsRule|null

hasNotificationsRule

clearNotificationsRule

setNotificationsRule

Optional. Rules to apply to notifications sent based on budget spend and thresholds.

Parameter
NameDescription
var Google\Cloud\Billing\Budgets\V1\NotificationsRule
Returns
TypeDescription
$this

getEtag

Optional. Etag to validate that the object is unchanged for a read-modify-write operation.

An empty etag will cause an update to overwrite other changes.

Returns
TypeDescription
string

setEtag

Optional. Etag to validate that the object is unchanged for a read-modify-write operation.

An empty etag will cause an update to overwrite other changes.

Parameter
NameDescription
var string
Returns
TypeDescription
$this