Class NotificationsRule (1.11.1)

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

NotificationsRule defines notifications that are sent based on budget spend and thresholds.

Attributes

NameDescription
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.