google-apis-billingbudgets_v1 0.7.0 → 0.11.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +17 -0
- data/OVERVIEW.md +2 -2
- data/lib/google/apis/billingbudgets_v1/classes.rb +71 -45
- data/lib/google/apis/billingbudgets_v1/gem_version.rb +3 -3
- data/lib/google/apis/billingbudgets_v1.rb +1 -1
- metadata +15 -9
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 822ea03ca5b99d42c52aefe2bb10f68a295de63e1cac50e492dc2268fe9cfc13
|
4
|
+
data.tar.gz: 5ea0263c1237464244cbff3e86bb2570f1af827b00d958ada638e3d73d2b22f1
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: bfc05afaa25c2dd2e0d1b296c0090e3b2c0d8bea4e300e789a4ed98ca35a99b0759108f7ffcbd0b8469d635e8970755e94acedad3eafb3ff39d33f6c7f9d7d3d
|
7
|
+
data.tar.gz: 639db8331ac2673c9ba1882d07a0ac636050fccf42453b0f215d0101b5c0f8b9f618c512fc59327e8d511e44d8d781a67aa950b0581bbba9a79872e2f3256f99
|
data/CHANGELOG.md
CHANGED
@@ -1,5 +1,22 @@
|
|
1
1
|
# Release history for google-apis-billingbudgets_v1
|
2
2
|
|
3
|
+
### v0.11.0 (2021-10-20)
|
4
|
+
|
5
|
+
* Unspecified changes
|
6
|
+
|
7
|
+
### v0.10.0 (2021-09-01)
|
8
|
+
|
9
|
+
* Regenerated from discovery document revision 20210813
|
10
|
+
|
11
|
+
### v0.9.0 (2021-06-29)
|
12
|
+
|
13
|
+
* Regenerated using generator version 0.4.0
|
14
|
+
|
15
|
+
### v0.8.0 (2021-06-24)
|
16
|
+
|
17
|
+
* Regenerated from discovery document revision 20210621
|
18
|
+
* Regenerated using generator version 0.3.0
|
19
|
+
|
3
20
|
### v0.7.0 (2021-05-19)
|
4
21
|
|
5
22
|
* Unspecified changes
|
data/OVERVIEW.md
CHANGED
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
|
|
60
60
|
|
61
61
|
More detailed descriptions of the Google simple REST clients are available in two documents.
|
62
62
|
|
63
|
-
* The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/
|
64
|
-
* The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/
|
63
|
+
* The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
|
64
|
+
* The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
|
65
65
|
|
66
66
|
(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Billingbudgets service in particular.)
|
67
67
|
|
@@ -47,7 +47,7 @@ module Google
|
|
47
47
|
attr_accessor :display_name
|
48
48
|
|
49
49
|
# Optional. Etag to validate that the object is unchanged for a read-modify-
|
50
|
-
# write operation. An empty etag
|
50
|
+
# write operation. An empty etag causes an update to overwrite other changes.
|
51
51
|
# Corresponds to the JSON property `etag`
|
52
52
|
# @return [String]
|
53
53
|
attr_accessor :etag
|
@@ -66,7 +66,8 @@ module Google
|
|
66
66
|
attr_accessor :notifications_rule
|
67
67
|
|
68
68
|
# Optional. Rules that trigger alerts (notifications of thresholds being crossed)
|
69
|
-
# when spend exceeds the specified percentages of the budget.
|
69
|
+
# when spend exceeds the specified percentages of the budget. Optional for `
|
70
|
+
# pubsubTopic` notifications. Required if using email notifications.
|
70
71
|
# Corresponds to the JSON property `thresholdRules`
|
71
72
|
# @return [Array<Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1ThresholdRule>]
|
72
73
|
attr_accessor :threshold_rules
|
@@ -93,10 +94,8 @@ module Google
|
|
93
94
|
|
94
95
|
# Describes a budget amount targeted to the last Filter.calendar_period spend.
|
95
96
|
# At this time, the amount is automatically 100% of the last calendar period's
|
96
|
-
# spend; that is, there are no other options yet.
|
97
|
-
#
|
98
|
-
# spend). LastPeriodAmount cannot be set for a budget configured with a Filter.
|
99
|
-
# custom_period.
|
97
|
+
# spend; that is, there are no other options yet. LastPeriodAmount cannot be set
|
98
|
+
# for a budget configured with a Filter.custom_period.
|
100
99
|
# Corresponds to the JSON property `lastPeriodAmount`
|
101
100
|
# @return [Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1LastPeriodAmount]
|
102
101
|
attr_accessor :last_period_amount
|
@@ -161,10 +160,10 @@ module Google
|
|
161
160
|
include Google::Apis::Core::Hashable
|
162
161
|
|
163
162
|
# Optional. Specifies to track usage for recurring calendar period. For example,
|
164
|
-
# assume that CalendarPeriod.QUARTER is set. The budget
|
165
|
-
#
|
166
|
-
#
|
167
|
-
#
|
163
|
+
# assume that CalendarPeriod.QUARTER is set. The budget tracks usage from April
|
164
|
+
# 1 to June 30, when the current calendar month is April, May, June. After that,
|
165
|
+
# it tracks usage from July 1 to September 30 when the current calendar month is
|
166
|
+
# July, August, September, so on.
|
168
167
|
# Corresponds to the JSON property `calendarPeriod`
|
169
168
|
# @return [String]
|
170
169
|
attr_accessor :calendar_period
|
@@ -190,27 +189,28 @@ module Google
|
|
190
189
|
attr_accessor :custom_period
|
191
190
|
|
192
191
|
# Optional. A single label and value pair specifying that usage from only this
|
193
|
-
# set of labeled resources should be included in the budget.
|
194
|
-
#
|
195
|
-
#
|
192
|
+
# set of labeled resources should be included in the budget. If omitted, the
|
193
|
+
# report includes all labeled and unlabeled usage. An object containing a single
|
194
|
+
# `"key": value` pair. Example: `` "name": "wrench" ``. _Currently, multiple
|
195
|
+
# entries or multiple values per entry are not allowed._
|
196
196
|
# Corresponds to the JSON property `labels`
|
197
197
|
# @return [Hash<String,Array<Object>>]
|
198
198
|
attr_accessor :labels
|
199
199
|
|
200
200
|
# Optional. A set of projects of the form `projects/`project``, specifying that
|
201
201
|
# usage from only this set of projects should be included in the budget. If
|
202
|
-
# omitted, the report
|
203
|
-
#
|
204
|
-
#
|
202
|
+
# omitted, the report includes all usage for the billing account, regardless of
|
203
|
+
# which project the usage occurred on. Only zero or one project can be specified
|
204
|
+
# currently.
|
205
205
|
# Corresponds to the JSON property `projects`
|
206
206
|
# @return [Array<String>]
|
207
207
|
attr_accessor :projects
|
208
208
|
|
209
209
|
# Optional. A set of services of the form `services/`service_id``, specifying
|
210
210
|
# that usage from only this set of services should be included in the budget. If
|
211
|
-
# omitted, the report
|
212
|
-
#
|
213
|
-
#
|
211
|
+
# omitted, the report includes usage for all the services. The service names are
|
212
|
+
# available through the Catalog API: https://cloud.google.com/billing/v1/how-tos/
|
213
|
+
# catalog-api.
|
214
214
|
# Corresponds to the JSON property `services`
|
215
215
|
# @return [Array<String>]
|
216
216
|
attr_accessor :services
|
@@ -218,8 +218,8 @@ module Google
|
|
218
218
|
# Optional. A set of subaccounts of the form `billingAccounts/`account_id``,
|
219
219
|
# specifying that usage from only this set of subaccounts should be included in
|
220
220
|
# the budget. If a subaccount is set to the name of the parent account, usage
|
221
|
-
# from the parent account
|
222
|
-
#
|
221
|
+
# from the parent account is included. If the field is omitted, the report
|
222
|
+
# includes usage from the parent account and all subaccounts, if they exist.
|
223
223
|
# Corresponds to the JSON property `subaccounts`
|
224
224
|
# @return [Array<String>]
|
225
225
|
attr_accessor :subaccounts
|
@@ -243,10 +243,8 @@ module Google
|
|
243
243
|
|
244
244
|
# Describes a budget amount targeted to the last Filter.calendar_period spend.
|
245
245
|
# At this time, the amount is automatically 100% of the last calendar period's
|
246
|
-
# spend; that is, there are no other options yet.
|
247
|
-
#
|
248
|
-
# spend). LastPeriodAmount cannot be set for a budget configured with a Filter.
|
249
|
-
# custom_period.
|
246
|
+
# spend; that is, there are no other options yet. LastPeriodAmount cannot be set
|
247
|
+
# for a budget configured with a Filter.custom_period.
|
250
248
|
class GoogleCloudBillingBudgetsV1LastPeriodAmount
|
251
249
|
include Google::Apis::Core::Hashable
|
252
250
|
|
@@ -299,25 +297,46 @@ module Google
|
|
299
297
|
attr_accessor :disable_default_iam_recipients
|
300
298
|
alias_method :disable_default_iam_recipients?, :disable_default_iam_recipients
|
301
299
|
|
302
|
-
# Optional.
|
303
|
-
# is in addition to
|
304
|
-
#
|
305
|
-
# the form `projects/`
|
306
|
-
#
|
307
|
-
#
|
300
|
+
# Optional. Email targets to send notifications to when a threshold is exceeded.
|
301
|
+
# This is in addition to the `DefaultIamRecipients` who receive alert emails
|
302
|
+
# based on their billing account IAM role. The value is the full REST resource
|
303
|
+
# name of a Cloud Monitoring email notification channel with the form `projects/`
|
304
|
+
# project_id`/notificationChannels/`channel_id``. A maximum of 5 email
|
305
|
+
# notifications are allowed. To customize budget alert email recipients with
|
306
|
+
# monitoring notification channels, you _must create the monitoring notification
|
307
|
+
# channels before you link them to a budget_. For guidance on setting up
|
308
|
+
# notification channels to use with budgets, see [Customize budget alert email
|
309
|
+
# recipients](https://cloud.google.com/billing/docs/how-to/budgets-notification-
|
310
|
+
# recipients). For Cloud Billing budget alerts, you _must use email notification
|
311
|
+
# channels_. The other types of notification channels are _not_ supported, such
|
312
|
+
# as Slack, SMS, or PagerDuty. If you want to [send budget notifications to
|
313
|
+
# Slack](https://cloud.google.com/billing/docs/how-to/notify#
|
314
|
+
# send_notifications_to_slack), use a pubsubTopic and configure [programmatic
|
315
|
+
# notifications](https://cloud.google.com/billing/docs/how-to/budgets-
|
316
|
+
# programmatic-notifications).
|
308
317
|
# Corresponds to the JSON property `monitoringNotificationChannels`
|
309
318
|
# @return [Array<String>]
|
310
319
|
attr_accessor :monitoring_notification_channels
|
311
320
|
|
312
|
-
# Optional. The name of the Pub/Sub topic where budget
|
321
|
+
# Optional. The name of the Pub/Sub topic where budget-related messages are
|
313
322
|
# published, in the form `projects/`project_id`/topics/`topic_id``. Updates are
|
314
|
-
# sent at regular intervals
|
315
|
-
# the
|
316
|
-
#
|
317
|
-
#
|
318
|
-
#
|
319
|
-
#
|
320
|
-
#
|
323
|
+
# sent to the topic at regular intervals; the timing of the updates is not
|
324
|
+
# dependent on the [threshold rules](#thresholdrule) you've set. Note that if
|
325
|
+
# you want your [Pub/Sub JSON object](https://cloud.google.com/billing/docs/how-
|
326
|
+
# to/budgets-programmatic-notifications#notification_format) to contain data for
|
327
|
+
# `alertThresholdExceeded`, you need at least one [alert threshold rule](#
|
328
|
+
# thresholdrule). When you set threshold rules, you must also enable at least
|
329
|
+
# one of the email notification options, either using the default IAM recipients
|
330
|
+
# or Cloud Monitoring email notification channels. To use Pub/Sub topics with
|
331
|
+
# budgets, you must do the following: 1. Create the Pub/Sub topic before
|
332
|
+
# connecting it to your budget. For guidance, see [Manage programmatic budget
|
333
|
+
# alert notifications](https://cloud.google.com/billing/docs/how-to/budgets-
|
334
|
+
# programmatic-notifications). 2. Grant the API caller the `pubsub.topics.
|
335
|
+
# setIamPolicy` permission on the Pub/Sub topic. If not set, the API call fails
|
336
|
+
# with PERMISSION_DENIED. For additional details on Pub/Sub roles and
|
337
|
+
# permissions, see [Permissions required for this task](https://cloud.google.com/
|
338
|
+
# billing/docs/how-to/budgets-programmatic-notifications#
|
339
|
+
# permissions_required_for_this_task).
|
321
340
|
# Corresponds to the JSON property `pubsubTopic`
|
322
341
|
# @return [String]
|
323
342
|
attr_accessor :pubsub_topic
|
@@ -343,12 +362,19 @@ module Google
|
|
343
362
|
end
|
344
363
|
end
|
345
364
|
|
346
|
-
# ThresholdRule contains
|
347
|
-
#
|
348
|
-
#
|
349
|
-
#
|
350
|
-
#
|
351
|
-
#
|
365
|
+
# ThresholdRule contains the definition of a threshold. Threshold rules define
|
366
|
+
# the triggering events used to generate a budget notification email. When a
|
367
|
+
# threshold is crossed (spend exceeds the specified percentages of the budget),
|
368
|
+
# budget alert emails are sent to the email recipients you specify in the [
|
369
|
+
# NotificationsRule](#notificationsrule). Threshold rules also affect the fields
|
370
|
+
# included in the [JSON data object](https://cloud.google.com/billing/docs/how-
|
371
|
+
# to/budgets-programmatic-notifications#notification_format) sent to a Pub/Sub
|
372
|
+
# topic. Threshold rules are _required_ if using email notifications. Threshold
|
373
|
+
# rules are _optional_ if only setting a [`pubsubTopic` NotificationsRule](#
|
374
|
+
# NotificationsRule), unless you want your JSON data object to include data
|
375
|
+
# about the thresholds you set. For more information, see [set budget threshold
|
376
|
+
# rules and actions](https://cloud.google.com/billing/docs/how-to/budgets#budget-
|
377
|
+
# actions).
|
352
378
|
class GoogleCloudBillingBudgetsV1ThresholdRule
|
353
379
|
include Google::Apis::Core::Hashable
|
354
380
|
|
@@ -16,13 +16,13 @@ module Google
|
|
16
16
|
module Apis
|
17
17
|
module BillingbudgetsV1
|
18
18
|
# Version of the google-apis-billingbudgets_v1 gem
|
19
|
-
GEM_VERSION = "0.
|
19
|
+
GEM_VERSION = "0.11.0"
|
20
20
|
|
21
21
|
# Version of the code generator used to generate this client
|
22
|
-
GENERATOR_VERSION = "0.
|
22
|
+
GENERATOR_VERSION = "0.4.0"
|
23
23
|
|
24
24
|
# Revision of the discovery document this client was generated from
|
25
|
-
REVISION = "
|
25
|
+
REVISION = "20210813"
|
26
26
|
end
|
27
27
|
end
|
28
28
|
end
|
@@ -33,7 +33,7 @@ module Google
|
|
33
33
|
# View and manage your Google Cloud Platform billing accounts
|
34
34
|
AUTH_CLOUD_BILLING = 'https://www.googleapis.com/auth/cloud-billing'
|
35
35
|
|
36
|
-
# See, edit, configure, and delete your Google Cloud
|
36
|
+
# See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
|
37
37
|
AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
|
38
38
|
end
|
39
39
|
end
|
metadata
CHANGED
@@ -1,29 +1,35 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-apis-billingbudgets_v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.11.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2021-
|
11
|
+
date: 2021-10-27 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: google-apis-core
|
15
15
|
requirement: !ruby/object:Gem::Requirement
|
16
16
|
requirements:
|
17
|
-
- - "
|
17
|
+
- - ">="
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: '0.
|
19
|
+
version: '0.4'
|
20
|
+
- - "<"
|
21
|
+
- !ruby/object:Gem::Version
|
22
|
+
version: 2.a
|
20
23
|
type: :runtime
|
21
24
|
prerelease: false
|
22
25
|
version_requirements: !ruby/object:Gem::Requirement
|
23
26
|
requirements:
|
24
|
-
- - "
|
27
|
+
- - ">="
|
28
|
+
- !ruby/object:Gem::Version
|
29
|
+
version: '0.4'
|
30
|
+
- - "<"
|
25
31
|
- !ruby/object:Gem::Version
|
26
|
-
version:
|
32
|
+
version: 2.a
|
27
33
|
description: This is the simple REST client for Cloud Billing Budget API V1. Simple
|
28
34
|
REST clients are Ruby client libraries that provide access to Google services via
|
29
35
|
their HTTP REST API endpoints. These libraries are generated and updated automatically
|
@@ -51,9 +57,9 @@ licenses:
|
|
51
57
|
- Apache-2.0
|
52
58
|
metadata:
|
53
59
|
bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
|
54
|
-
changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/
|
55
|
-
documentation_uri: https://googleapis.dev/ruby/google-apis-billingbudgets_v1/v0.
|
56
|
-
source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/
|
60
|
+
changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-billingbudgets_v1/CHANGELOG.md
|
61
|
+
documentation_uri: https://googleapis.dev/ruby/google-apis-billingbudgets_v1/v0.11.0
|
62
|
+
source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-billingbudgets_v1
|
57
63
|
post_install_message:
|
58
64
|
rdoc_options: []
|
59
65
|
require_paths:
|