NotificationsRule(mapping=None, *, ignore_unknown_fields=False, **kwargs)
NotificationsRule defines notifications that are sent based on budget spend and thresholds.
Attributes | |
---|---|
Name | Description |
pubsub_topic |
str
Optional. The name of the Pub/Sub topic where budget-related messages are published, in the form projects/{project_id}/topics/{topic_id} . Updates are
sent to the topic at regular intervals; the timing of the
updates is not dependent on the `threshold
rules <#thresholdrule>`__ you've set.
Note that if you want your `Pub/Sub JSON
object |
schema_version |
str
Optional. Required when NotificationsRule.pubsub_topic is set. The schema version of the notification sent to NotificationsRule.pubsub_topic. Only "1.0" is accepted. It represents the JSON schema as defined in https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format. |
monitoring_notification_channels |
MutableSequence[str]
Optional. Email targets to send notifications to when a threshold is exceeded. This is in addition to the DefaultIamRecipients who receive alert emails based on
their billing account IAM role. The value is the full REST
resource name of a Cloud Monitoring email notification
channel with the form
projects/{project_id}/notificationChannels/{channel_id} .
A maximum of 5 email notifications are allowed.
To customize budget alert email recipients with monitoring
notification channels, you *must create the monitoring
notification channels before you link them to a budget*. For
guidance on setting up notification channels to use with
budgets, see `Customize budget alert email
recipients |
disable_default_iam_recipients |
bool
Optional. When set to true, disables default notifications sent when a threshold is exceeded. Default notifications are sent to those with Billing Account Administrator and Billing Account User IAM roles for the target account. |