Class ThresholdRule (1.11.1)

ThresholdRule(mapping=None, *, ignore_unknown_fields=False, **kwargs)

ThresholdRule contains the definition of a threshold. Threshold rules define the triggering events used to generate a budget notification email. When a threshold is crossed (spend exceeds the specified percentages of the budget), budget alert emails are sent to the email recipients you specify in the NotificationsRule <#notificationsrule>__.

Threshold rules also affect the fields included in the JSON data object <https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format>__ sent to a Pub/Sub topic.

Threshold rules are required if using email notifications.

Threshold rules are optional if only setting a `pubsubTopic NotificationsRule <#NotificationsRule>`__, unless you want your JSON data object to include data about the thresholds you set.

For more information, see set budget threshold rules and actions <https://cloud.google.com/billing/docs/how-to/budgets#budget-actions>__.

Attributes

NameDescription
threshold_percent float
Required. Send an alert when this threshold is exceeded. This is a 1.0-based percentage, so 0.5 = 50%. Validation: non-negative number.
spend_basis google.cloud.billing.budgets_v1.types.ThresholdRule.Basis
Optional. The type of basis used to determine if spend has passed the threshold. Behavior defaults to CURRENT_SPEND if not set.

Classes

Basis

Basis(value)

The type of basis used to determine if spend has passed the threshold.

Values: BASIS_UNSPECIFIED (0): Unspecified threshold basis. CURRENT_SPEND (1): Use current spend as the basis for comparison against the threshold. FORECASTED_SPEND (2): Use forecasted spend for the period as the basis for comparison against the threshold. FORECASTED_SPEND can only be set when the budget's time period is a Filter.calendar_period. It cannot be set in combination with Filter.custom_period.