google-apis-billingbudgets_v1 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1dc9980daa065be270240db1cbb13143b4b69956e53b81475c2a174733bda94
-  data.tar.gz: f1efe4174dfe15e334879eb442853c47ed073b5f1fd9f8fee870ad4294e6f0a2
+  metadata.gz: 04e74543f3f2cc51aa2235756c7b58e05c0719c76d7b37867b061a878dbc5d35
+  data.tar.gz: 62e5f9899c16e71048e4fa46d3151172ea388bd009c047b55337888f400f0c4a
 SHA512:
-  metadata.gz: 961e2f3250bf8b4669291b2c6f02145ebf018e1825975abc2bb7244a7e1df01365277c1bbb8b98a2c9af85d6c2b3390c20324da5c526f73e84f37163c11f6462
-  data.tar.gz: 90765375f65e1b82c0ae3f4259d5dc3249bc765f34261e535c23fc4b4fd504dcd7612d27c53852933d58a614ebec65eebf1222852a21ed675dd7d0dd47ca7c5a
+  metadata.gz: 8beb3fdff564ed27bf773d654fe5fef80ac4db9c9b0266c19731ea50bf041bdc94ea53307c27160a5f9595dab344be8d1dded5e04573472969369e9f7f47c14f
+  data.tar.gz: 7ee9e181dbf22da11f59f6c1b35e4dc6fa51453e9c2d78dada4829b02f4cabba802285cf039522347c2ce3ca1c2d3aed64bfed782c4707a21ea408a748b5be85

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-billingbudgets_v1
 
+### v0.10.0 (2021-09-01)
+
+* Regenerated from discovery document revision 20210813
+
 ### v0.9.0 (2021-06-29)
 
 * Regenerated using generator version 0.4.0

data/lib/google/apis/billingbudgets_v1/classes.rb

@@ -47,7 +47,7 @@ module Google
         attr_accessor :display_name
       
         # 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.
+        # write operation. An empty etag causes an update to overwrite other changes.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -94,10 +94,8 @@ module Google
       
         # Describes a budget amount targeted to the last Filter.calendar_period spend.
         # At this time, the amount is automatically 100% of the last calendar period's
-        # spend; that is, there are no other options yet. Future configuration options
-        # will be described here (for example, configuring a percentage of last period's
-        # spend). LastPeriodAmount cannot be set for a budget configured with a Filter.
-        # custom_period.
+        # spend; that is, there are no other options yet. LastPeriodAmount cannot be set
+        # for a budget configured with a Filter.custom_period.
         # Corresponds to the JSON property `lastPeriodAmount`
         # @return [Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1LastPeriodAmount]
         attr_accessor :last_period_amount
@@ -162,10 +160,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Specifies to track usage for recurring calendar period. For example,
-        # assume that CalendarPeriod.QUARTER is set. The budget will track usage from
-        # April 1 to June 30, when the current calendar month is April, May, June. After
-        # that, it will track usage from July 1 to September 30 when the current
-        # calendar month is July, August, September, so on.
+        # assume that CalendarPeriod.QUARTER is set. The budget tracks usage from April
+        # 1 to June 30, when the current calendar month is April, May, June. After that,
+        # it tracks usage from July 1 to September 30 when the current calendar month is
+        # July, August, September, so on.
         # Corresponds to the JSON property `calendarPeriod`
         # @return [String]
         attr_accessor :calendar_period
@@ -191,27 +189,28 @@ module Google
         attr_accessor :custom_period
       
         # Optional. A single label and value pair specifying that usage from only this
-        # set of labeled resources should be included in the budget. Currently, multiple
-        # entries or multiple values per entry are not allowed. If omitted, the report
-        # will include all labeled and unlabeled usage.
+        # set of labeled resources should be included in the budget. If omitted, the
+        # report includes all labeled and unlabeled usage. An object containing a single
+        # `"key": value` pair. Example: `` "name": "wrench" ``. _Currently, multiple
+        # entries or multiple values per entry are not allowed._
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,Array<Object>>]
         attr_accessor :labels
       
         # Optional. A set of projects of the form `projects/`project``, specifying that
         # usage from only this set of projects should be included in the budget. If
-        # omitted, the report will include all usage for the billing account, regardless
-        # of which project the usage occurred on. Only zero or one project can be
-        # specified currently.
+        # omitted, the report includes all usage for the billing account, regardless of
+        # which project the usage occurred on. Only zero or one project can be specified
+        # currently.
         # Corresponds to the JSON property `projects`
         # @return [Array<String>]
         attr_accessor :projects
       
         # Optional. A set of services of the form `services/`service_id``, specifying
         # that usage from only this set of services should be included in the budget. If
-        # omitted, the report will include usage for all the services. The service names
-        # are available through the Catalog API: https://cloud.google.com/billing/v1/how-
-        # tos/catalog-api.
+        # omitted, the report includes usage for all the services. The service names are
+        # available through the Catalog API: https://cloud.google.com/billing/v1/how-tos/
+        # catalog-api.
         # Corresponds to the JSON property `services`
         # @return [Array<String>]
         attr_accessor :services
@@ -219,8 +218,8 @@ module Google
         # Optional. A set of subaccounts of the form `billingAccounts/`account_id``,
         # specifying that usage from only this set of subaccounts should be included in
         # the budget. If a subaccount is set to the name of the parent account, usage
-        # from the parent account will be included. If the field is omitted, the report
-        # will include usage from the parent account and all subaccounts, if they exist.
+        # from the parent account is included. If the field is omitted, the report
+        # includes usage from the parent account and all subaccounts, if they exist.
         # Corresponds to the JSON property `subaccounts`
         # @return [Array<String>]
         attr_accessor :subaccounts
@@ -244,10 +243,8 @@ module Google
       
       # Describes a budget amount targeted to the last Filter.calendar_period spend.
       # At this time, the amount is automatically 100% of the last calendar period's
-      # spend; that is, there are no other options yet. Future configuration options
-      # will be described here (for example, configuring a percentage of last period's
-      # spend). LastPeriodAmount cannot be set for a budget configured with a Filter.
-      # custom_period.
+      # spend; that is, there are no other options yet. LastPeriodAmount cannot be set
+      # for a budget configured with a Filter.custom_period.
       class GoogleCloudBillingBudgetsV1LastPeriodAmount
         include Google::Apis::Core::Hashable
       
@@ -300,25 +297,46 @@ module Google
         attr_accessor :disable_default_iam_recipients
         alias_method :disable_default_iam_recipients?, :disable_default_iam_recipients
       
-        # Optional. Targets to send notifications to when a threshold is exceeded. This
-        # is in addition to default recipients who have billing account IAM roles. The
-        # value is the full REST resource name of a monitoring notification channel with
-        # the form `projects/`project_id`/notificationChannels/`channel_id``. A maximum
-        # of 5 channels are allowed. See https://cloud.google.com/billing/docs/how-to/
-        # budgets-notification-recipients for more details.
+        # 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](https://cloud.google.com/billing/docs/how-to/budgets-notification-
+        # recipients). For Cloud Billing budget alerts, you _must use email notification
+        # channels_. The other types of notification channels are _not_ supported, such
+        # as Slack, SMS, or PagerDuty. If you want to [send budget notifications to
+        # Slack](https://cloud.google.com/billing/docs/how-to/notify#
+        # send_notifications_to_slack), use a pubsubTopic and configure [programmatic
+        # notifications](https://cloud.google.com/billing/docs/how-to/budgets-
+        # programmatic-notifications).
         # Corresponds to the JSON property `monitoringNotificationChannels`
         # @return [Array<String>]
         attr_accessor :monitoring_notification_channels
       
-        # Optional. The name of the Pub/Sub topic where budget related messages will be
+        # 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 at regular intervals to the topic. The topic needs to be created before
-        # the budget is created; see https://cloud.google.com/billing/docs/how-to/
-        # budgets#manage-notifications for more details. Caller is expected to have `
-        # pubsub.topics.setIamPolicy` permission on the topic when it's set for a budget,
-        # otherwise, the API call will fail with PERMISSION_DENIED. See https://cloud.
-        # google.com/billing/docs/how-to/budgets-programmatic-notifications for more
-        # details on Pub/Sub roles and permissions.
+        # 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](https://cloud.google.com/billing/docs/how-
+        # to/budgets-programmatic-notifications#notification_format) to contain data for
+        # `alertThresholdExceeded`, you need at least one [alert threshold rule](#
+        # thresholdrule). When you set threshold rules, you must also enable at least
+        # one of the email notification options, either using the default IAM recipients
+        # or Cloud Monitoring email notification channels. To use Pub/Sub topics with
+        # budgets, you must do the following: 1. Create the Pub/Sub topic before
+        # connecting it to your budget. For guidance, see [Manage programmatic budget
+        # alert notifications](https://cloud.google.com/billing/docs/how-to/budgets-
+        # programmatic-notifications). 2. Grant the API caller the `pubsub.topics.
+        # setIamPolicy` permission on the Pub/Sub topic. If not set, the API call fails
+        # with PERMISSION_DENIED. For additional details on Pub/Sub roles and
+        # permissions, see [Permissions required for this task](https://cloud.google.com/
+        # billing/docs/how-to/budgets-programmatic-notifications#
+        # permissions_required_for_this_task).
         # Corresponds to the JSON property `pubsubTopic`
         # @return [String]
         attr_accessor :pubsub_topic

data/lib/google/apis/billingbudgets_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module BillingbudgetsV1
       # Version of the google-apis-billingbudgets_v1 gem
-      GEM_VERSION = "0.9.0"
+      GEM_VERSION = "0.10.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210621"
+      REVISION = "20210813"
     end
   end
 end

data/lib/google/apis/billingbudgets_v1.rb

@@ -33,7 +33,7 @@ module Google
       # View and manage your Google Cloud Platform billing accounts
       AUTH_CLOUD_BILLING = 'https://www.googleapis.com/auth/cloud-billing'
 
-      # See, edit, configure, and delete your Google Cloud Platform data
+      # See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-billingbudgets_v1
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-05 00:00:00.000000000 Z
+date: 2021-09-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-billingbudgets_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-billingbudgets_v1/v0.9.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-billingbudgets_v1/v0.10.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-billingbudgets_v1
 post_install_message: 
 rdoc_options: []