google-cloud-billing-budgets-v1beta1 0.6.3 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f61b90907e8f6657d0ff0fa4ca319f8891697c149953328e5a758de53a2968dd
4
- data.tar.gz: f821c2fcaaa363b15818f8b3e54245cf7c2d7b899c88a2613729d0caf752b56d
3
+ metadata.gz: e2c703a9b3964a6eda849672bd16cccf43c29888064cc599ff33831d9d8ab953
4
+ data.tar.gz: 6abfa1c4917103a562d43e432457b8663fce4c7a740b4fa6e71af02a51e74f9c
5
5
  SHA512:
6
- metadata.gz: e05e9c4062902b494ae679597d535fd73f8d82f7ef62c8eb2e8b050d397554f808d2b2e8728d2b9510d5b2fa8799efbcfd0c4f8d3ddc84f3998d04fd5a58213b
7
- data.tar.gz: 38e15bc18d8f793aaf45217d637126cb733bf0bd2172be666cf667204498e8e52bc0a2608a2130d7bbc68a0b01b5e2094941affe6d155885eda3e066442e36c9
6
+ metadata.gz: 617b214408adc356e178915adc8106bdc16e32726faac692ad1820bfcff39bd9e1f874ce0c50041aaba7e9367e9ae575fdde6a3d3fb94d4fd7f06f190d0f6c28
7
+ data.tar.gz: 83291fade39111c5918762adbd490e3f221c59ffc4d58f4208f1accf2de19dd019e27810f03c4b32323a41d93ad34b6037613819d2324b1c8b186653fad716f0
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Billing Budgets V1beta1 API
2
+ --title="Billing Budgets V1beta1 API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
data/README.md CHANGED
@@ -37,7 +37,7 @@ request = ::Google::Cloud::Billing::Budgets::V1beta1::CreateBudgetRequest.new #
37
37
  response = client.create_budget request
38
38
  ```
39
39
 
40
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-billing-budgets-v1beta1/latest)
40
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-billing-budgets-v1beta1/latest)
41
41
  for class and method documentation.
42
42
 
43
43
  See also the [Product Documentation](https://cloud.google.com/billing/docs/how-to/budget-api-overview)
@@ -69,16 +69,21 @@ module GRPC
69
69
  end
70
70
  ```
71
71
 
72
+
73
+ ## Google Cloud Samples
74
+
75
+ To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
+
72
77
  ## Supported Ruby Versions
73
78
 
74
- This library is supported on Ruby 2.5+.
79
+ This library is supported on Ruby 2.6+.
75
80
 
76
81
  Google provides official support for Ruby versions that are actively supported
77
82
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
78
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
79
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
80
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
81
- about the Ruby support schedule.
83
+ in security maintenance, and not end of life. Older versions of Ruby _may_
84
+ still work, but are unsupported and not recommended. See
85
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
86
+ support schedule.
82
87
 
83
88
  ## Which client should I use?
84
89
 
@@ -1,12 +1,13 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/billing/budgets/v1beta1/budget_model.proto
3
3
 
4
+ require 'google/protobuf'
5
+
4
6
  require 'google/api/field_behavior_pb'
5
7
  require 'google/api/resource_pb'
6
8
  require 'google/protobuf/struct_pb'
7
9
  require 'google/type/date_pb'
8
10
  require 'google/type/money_pb'
9
- require 'google/protobuf'
10
11
 
11
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
12
13
  add_file("google/cloud/billing/budgets/v1beta1/budget_model.proto", :syntax => :proto3) do
@@ -170,7 +170,7 @@ module Google
170
170
 
171
171
  ##
172
172
  # Creates a new budget. See
173
- # <a href="https://cloud.google.com/billing/quotas">Quotas and limits</a>
173
+ # [Quotas and limits](https://cloud.google.com/billing/quotas)
174
174
  # for more information on the limits of the number of budgets you can create.
175
175
  #
176
176
  # @overload create_budget(request, options = nil)
@@ -1,6 +1,8 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/billing/budgets/v1beta1/budget_service.proto
3
3
 
4
+ require 'google/protobuf'
5
+
4
6
  require 'google/api/annotations_pb'
5
7
  require 'google/api/client_pb'
6
8
  require 'google/api/field_behavior_pb'
@@ -8,7 +10,6 @@ require 'google/api/resource_pb'
8
10
  require 'google/cloud/billing/budgets/v1beta1/budget_model_pb'
9
11
  require 'google/protobuf/empty_pb'
10
12
  require 'google/protobuf/field_mask_pb'
11
- require 'google/protobuf'
12
13
 
13
14
  Google::Protobuf::DescriptorPool.generated_pool.build do
14
15
  add_file("google/cloud/billing/budgets/v1beta1/budget_service.proto", :syntax => :proto3) do
@@ -36,7 +36,7 @@ module Google
36
36
  self.service_name = 'google.cloud.billing.budgets.v1beta1.BudgetService'
37
37
 
38
38
  # Creates a new budget. See
39
- # <a href="https://cloud.google.com/billing/quotas">Quotas and limits</a>
39
+ # [Quotas and limits](https://cloud.google.com/billing/quotas)
40
40
  # for more information on the limits of the number of budgets you can create.
41
41
  rpc :CreateBudget, ::Google::Cloud::Billing::Budgets::V1beta1::CreateBudgetRequest, ::Google::Cloud::Billing::Budgets::V1beta1::Budget
42
42
  # Updates a budget and returns the updated budget.
@@ -22,7 +22,7 @@ module Google
22
22
  module Billing
23
23
  module Budgets
24
24
  module V1beta1
25
- VERSION = "0.6.3"
25
+ VERSION = "0.7.0"
26
26
  end
27
27
  end
28
28
  end
@@ -26,6 +26,8 @@ module Google
26
26
  ##
27
27
  # To load this package, including all its services, and instantiate a client:
28
28
  #
29
+ # @example
30
+ #
29
31
  # require "google/cloud/billing/budgets/v1beta1"
30
32
  # client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
31
33
  #
@@ -33,11 +33,7 @@ module Google
33
33
  # // For Kubernetes resources, the format is {api group}/{kind}.
34
34
  # option (google.api.resource) = {
35
35
  # type: "pubsub.googleapis.com/Topic"
36
- # name_descriptor: {
37
- # pattern: "projects/{project}/topics/{topic}"
38
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
39
- # parent_name_extractor: "projects/{project}"
40
- # }
36
+ # pattern: "projects/{project}/topics/{topic}"
41
37
  # };
42
38
  # }
43
39
  #
@@ -45,10 +41,7 @@ module Google
45
41
  #
46
42
  # resources:
47
43
  # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/{project}/topics/{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/{project}"
44
+ # pattern: "projects/{project}/topics/{topic}"
52
45
  #
53
46
  # Sometimes, resources have multiple patterns, typically because they can
54
47
  # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
58
51
  # message LogEntry {
59
52
  # option (google.api.resource) = {
60
53
  # type: "logging.googleapis.com/LogEntry"
61
- # name_descriptor: {
62
- # pattern: "projects/{project}/logs/{log}"
63
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
64
- # parent_name_extractor: "projects/{project}"
65
- # }
66
- # name_descriptor: {
67
- # pattern: "folders/{folder}/logs/{log}"
68
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
69
- # parent_name_extractor: "folders/{folder}"
70
- # }
71
- # name_descriptor: {
72
- # pattern: "organizations/{organization}/logs/{log}"
73
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
74
- # parent_name_extractor: "organizations/{organization}"
75
- # }
76
- # name_descriptor: {
77
- # pattern: "billingAccounts/{billing_account}/logs/{log}"
78
- # parent_type: "billing.googleapis.com/BillingAccount"
79
- # parent_name_extractor: "billingAccounts/{billing_account}"
80
- # }
54
+ # pattern: "projects/{project}/logs/{log}"
55
+ # pattern: "folders/{folder}/logs/{log}"
56
+ # pattern: "organizations/{organization}/logs/{log}"
57
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
81
58
  # };
82
59
  # }
83
60
  #
@@ -85,48 +62,10 @@ module Google
85
62
  #
86
63
  # resources:
87
64
  # - type: 'logging.googleapis.com/LogEntry'
88
- # name_descriptor:
89
- # - pattern: "projects/{project}/logs/{log}"
90
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
91
- # parent_name_extractor: "projects/{project}"
92
- # - pattern: "folders/{folder}/logs/{log}"
93
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
94
- # parent_name_extractor: "folders/{folder}"
95
- # - pattern: "organizations/{organization}/logs/{log}"
96
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
97
- # parent_name_extractor: "organizations/{organization}"
98
- # - pattern: "billingAccounts/{billing_account}/logs/{log}"
99
- # parent_type: "billing.googleapis.com/BillingAccount"
100
- # parent_name_extractor: "billingAccounts/{billing_account}"
101
- #
102
- # For flexible resources, the resource name doesn't contain parent names, but
103
- # the resource itself has parents for policy evaluation.
104
- #
105
- # Example:
106
- #
107
- # message Shelf {
108
- # option (google.api.resource) = {
109
- # type: "library.googleapis.com/Shelf"
110
- # name_descriptor: {
111
- # pattern: "shelves/{shelf}"
112
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
113
- # }
114
- # name_descriptor: {
115
- # pattern: "shelves/{shelf}"
116
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
117
- # }
118
- # };
119
- # }
120
- #
121
- # The ResourceDescriptor Yaml config will look like:
122
- #
123
- # resources:
124
- # - type: 'library.googleapis.com/Shelf'
125
- # name_descriptor:
126
- # - pattern: "shelves/{shelf}"
127
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
128
- # - pattern: "shelves/{shelf}"
129
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
65
+ # pattern: "projects/{project}/logs/{log}"
66
+ # pattern: "folders/{folder}/logs/{log}"
67
+ # pattern: "organizations/{organization}/logs/{log}"
68
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
130
69
  # @!attribute [rw] type
131
70
  # @return [::String]
132
71
  # The resource type. It must be in the format of
@@ -38,9 +38,9 @@ module Google
38
38
  # Validation: <= 60 chars.
39
39
  # @!attribute [rw] budget_filter
40
40
  # @return [::Google::Cloud::Billing::Budgets::V1beta1::Filter]
41
- # Optional. Filters that define which resources are used to compute the
42
- # actual spend against the budget amount, such as projects, services, and the
43
- # budget's time period, as well as other filters.
41
+ # Optional. Filters that define which resources are used to compute the actual spend
42
+ # against the budget amount, such as projects, services, and the budget's
43
+ # time period, as well as other filters.
44
44
  # @!attribute [rw] amount
45
45
  # @return [::Google::Cloud::Billing::Budgets::V1beta1::BudgetAmount]
46
46
  # Required. Budgeted amount.
@@ -48,10 +48,13 @@ module Google
48
48
  # @return [::Array<::Google::Cloud::Billing::Budgets::V1beta1::ThresholdRule>]
49
49
  # Optional. Rules that trigger alerts (notifications of thresholds
50
50
  # being crossed) when spend exceeds the specified percentages of the budget.
51
+ #
52
+ # Optional for `pubsubTopic` notifications.
53
+ #
54
+ # Required if using email notifications.
51
55
  # @!attribute [rw] all_updates_rule
52
56
  # @return [::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule]
53
- # Optional. Rules to apply to notifications sent based on budget spend and
54
- # thresholds.
57
+ # Optional. Rules to apply to notifications sent based on budget spend and thresholds.
55
58
  # @!attribute [rw] etag
56
59
  # @return [::String]
57
60
  # Optional. Etag to validate that the object is unchanged for a
@@ -74,35 +77,47 @@ module Google
74
77
  # @return [::Google::Cloud::Billing::Budgets::V1beta1::LastPeriodAmount]
75
78
  # Use the last period's actual spend as the budget for the present period.
76
79
  # LastPeriodAmount can only be set when the budget's time period is a
77
- # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}.
78
- # It cannot be set in combination with
80
+ # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}. It cannot be set in combination with
79
81
  # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
80
82
  class BudgetAmount
81
83
  include ::Google::Protobuf::MessageExts
82
84
  extend ::Google::Protobuf::MessageExts::ClassMethods
83
85
  end
84
86
 
85
- # Describes a budget amount targeted to the last
86
- # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}
87
+ # Describes a budget amount targeted to the last {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}
87
88
  # spend. At this time, the amount is automatically 100% of the last calendar
88
89
  # period's spend; that is, there are no other options yet.
89
90
  # Future configuration options will be described here (for example, configuring
90
91
  # a percentage of last period's spend).
91
92
  # LastPeriodAmount cannot be set for a budget configured with
92
- # a
93
- # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
93
+ # a {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
94
94
  class LastPeriodAmount
95
95
  include ::Google::Protobuf::MessageExts
96
96
  extend ::Google::Protobuf::MessageExts::ClassMethods
97
97
  end
98
98
 
99
- # ThresholdRule contains a definition of a threshold which triggers
100
- # an alert (a notification of a threshold being crossed) to be sent when
101
- # spend goes above the specified amount.
102
- # Alerts are automatically e-mailed to users with the Billing Account
103
- # Administrator role or the Billing Account User role.
104
- # The thresholds here have no effect on notifications sent to anything
105
- # configured under `Budget.all_updates_rule`.
99
+ # ThresholdRule contains the definition of a threshold. Threshold rules define
100
+ # the triggering events used to generate a budget notification email. When a
101
+ # threshold is crossed (spend exceeds the specified percentages of the
102
+ # budget), budget alert emails are sent to the email recipients you specify
103
+ # in the
104
+ # [NotificationsRule](#notificationsrule).
105
+ #
106
+ # Threshold rules also affect the fields included in the
107
+ # [JSON data
108
+ # object](https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format)
109
+ # sent to a Pub/Sub topic.
110
+ #
111
+ # Threshold rules are _required_ if using email notifications.
112
+ #
113
+ # Threshold rules are _optional_ if only setting a
114
+ # [`pubsubTopic` NotificationsRule](#NotificationsRule),
115
+ # unless you want your JSON data object to include data about the thresholds
116
+ # you set.
117
+ #
118
+ # For more information, see
119
+ # [set budget threshold rules and
120
+ # actions](https://cloud.google.com/billing/docs/how-to/budgets#budget-actions).
106
121
  # @!attribute [rw] threshold_percent
107
122
  # @return [::Float]
108
123
  # Required. Send an alert when this threshold is exceeded.
@@ -127,8 +142,7 @@ module Google
127
142
  # Use forecasted spend for the period as the basis for comparison against
128
143
  # the threshold.
129
144
  # FORECASTED_SPEND can only be set when the budget's time period is a
130
- # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}.
131
- # It cannot be set in combination with
145
+ # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}. It cannot be set in combination with
132
146
  # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
133
147
  FORECASTED_SPEND = 2
134
148
  end
@@ -138,10 +152,10 @@ module Google
138
152
  # and thresholds.
139
153
  # @!attribute [rw] pubsub_topic
140
154
  # @return [::String]
141
- # Optional. The name of the Pub/Sub topic where budget related messages will
142
- # be published, in the form `projects/{project_id}/topics/{topic_id}`.
143
- # Updates are sent at regular intervals to the topic. The topic needs to be
144
- # created before the budget is created; see
155
+ # Optional. The name of the Pub/Sub topic where budget related messages will be
156
+ # published, in the form `projects/{project_id}/topics/{topic_id}`. Updates
157
+ # are sent at regular intervals to the topic.
158
+ # The topic needs to be created before the budget is created; see
145
159
  # https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications
146
160
  # for more details.
147
161
  # Caller is expected to have
@@ -151,28 +165,25 @@ module Google
151
165
  # for more details on Pub/Sub roles and permissions.
152
166
  # @!attribute [rw] schema_version
153
167
  # @return [::String]
154
- # Optional. Required when
155
- # {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic}
156
- # is set. The schema version of the notification sent to
157
- # {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic}.
158
- # Only "1.0" is accepted. It represents the JSON schema as defined in
168
+ # Optional. Required when {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic} is set. The schema version of
169
+ # the notification sent to {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic}. Only "1.0" is
170
+ # accepted. It represents the JSON schema as defined in
159
171
  # https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format.
160
172
  # @!attribute [rw] monitoring_notification_channels
161
173
  # @return [::Array<::String>]
162
- # Optional. Targets to send notifications to when a threshold is exceeded.
163
- # This is in addition to default recipients who have billing account IAM
164
- # roles. The value is the full REST resource name of a monitoring
165
- # notification channel with the form
174
+ # Optional. Targets to send notifications to when a threshold is exceeded. This is in
175
+ # addition to default recipients who have billing account IAM roles.
176
+ # The value is the full REST resource name of a monitoring notification
177
+ # channel with the form
166
178
  # `projects/{project_id}/notificationChannels/{channel_id}`. A maximum of 5
167
179
  # channels are allowed. See
168
180
  # https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients
169
181
  # for more details.
170
182
  # @!attribute [rw] disable_default_iam_recipients
171
183
  # @return [::Boolean]
172
- # Optional. When set to true, disables default notifications sent when a
173
- # threshold is exceeded. Default notifications are sent to those with Billing
174
- # Account Administrator and Billing Account User IAM roles for the target
175
- # account.
184
+ # Optional. When set to true, disables default notifications sent when a threshold is
185
+ # exceeded. Default notifications are sent to those with Billing Account
186
+ # Administrator and Billing Account User IAM roles for the target account.
176
187
  class AllUpdatesRule
177
188
  include ::Google::Protobuf::MessageExts
178
189
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -188,16 +199,14 @@ module Google
188
199
  # Only zero or one project can be specified currently.
189
200
  # @!attribute [rw] credit_types
190
201
  # @return [::Array<::String>]
191
- # Optional. If
192
- # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment}
193
- # is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
194
- # subtracted from gross cost to determine the spend for threshold
195
- # calculations. See [a list of acceptable credit type
202
+ # Optional. If {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment} is INCLUDE_SPECIFIED_CREDITS, this is
203
+ # a list of credit types to be subtracted from gross cost to determine the
204
+ # spend for threshold calculations. See
205
+ # [a list of acceptable credit type
196
206
  # values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
197
207
  #
198
- # If
199
- # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment}
200
- # is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty.
208
+ # If {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment} is **not** INCLUDE_SPECIFIED_CREDITS,
209
+ # this field must be empty.
201
210
  # @!attribute [rw] credit_types_treatment
202
211
  # @return [::Google::Cloud::Billing::Budgets::V1beta1::Filter::CreditTypesTreatment]
203
212
  # Optional. If not set, default behavior is `INCLUDE_ALL_CREDITS`.
@@ -211,18 +220,23 @@ module Google
211
220
  # https://cloud.google.com/billing/v1/how-tos/catalog-api.
212
221
  # @!attribute [rw] subaccounts
213
222
  # @return [::Array<::String>]
214
- # Optional. A set of subaccounts of the form `billingAccounts/{account_id}`,
215
- # specifying that usage from only this set of subaccounts should be included
216
- # in the budget. If a subaccount is set to the name of the parent account,
223
+ # Optional. A set of subaccounts of the form `billingAccounts/{account_id}`, specifying
224
+ # that usage from only this set of subaccounts should be included in the
225
+ # budget. If a subaccount is set to the name of the parent account,
217
226
  # usage from the parent account will be included. If omitted, the
218
227
  # report will include usage from the parent account and all
219
228
  # subaccounts, if they exist.
220
229
  # @!attribute [rw] labels
221
230
  # @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::ListValue}]
222
- # Optional. A single label and value pair specifying that usage from only
223
- # this set of labeled resources should be included in the budget. Currently,
224
- # multiple entries or multiple values per entry are not allowed. If omitted,
225
- # the report will include all labeled and unlabeled usage.
231
+ # Optional. A single label and value pair specifying that usage from only this set of
232
+ # labeled resources should be included in the budget. If omitted, the
233
+ # report will include all labeled and unlabeled usage.
234
+ #
235
+ # An object containing a single `"key": value` pair. Example: `{ "name":
236
+ # "wrench" }`.
237
+ #
238
+ # _Currently, multiple entries or multiple values per entry are not
239
+ # allowed._
226
240
  # @!attribute [rw] calendar_period
227
241
  # @return [::Google::Cloud::Billing::Budgets::V1beta1::CalendarPeriod]
228
242
  # Optional. Specifies to track usage for recurring calendar period.
@@ -233,8 +247,8 @@ module Google
233
247
  # so on.
234
248
  # @!attribute [rw] custom_period
235
249
  # @return [::Google::Cloud::Billing::Budgets::V1beta1::CustomPeriod]
236
- # Optional. Specifies to track usage from any start date (required) to any
237
- # end date (optional). This time period is static, it does not recur.
250
+ # Optional. Specifies to track usage from any start date (required) to any end date
251
+ # (optional). This time period is static, it does not recur.
238
252
  class Filter
239
253
  include ::Google::Protobuf::MessageExts
240
254
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -278,9 +292,9 @@ module Google
278
292
  # Required. The start date must be after January 1, 2017.
279
293
  # @!attribute [rw] end_date
280
294
  # @return [::Google::Type::Date]
281
- # Optional. The end date of the time period. Budgets with elapsed end date
282
- # won't be processed. If unset, specifies to track all usage incurred since
283
- # the start_date.
295
+ # Optional. The end date of the time period. Budgets with elapsed end date won't be
296
+ # processed. If unset, specifies to track all usage
297
+ # incurred since the start_date.
284
298
  class CustomPeriod
285
299
  include ::Google::Protobuf::MessageExts
286
300
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -291,6 +305,8 @@ module Google
291
305
  # `CalendarPeriod`". All calendar times begin at 12 AM US and Canadian
292
306
  # Pacific Time (UTC-8).
293
307
  module CalendarPeriod
308
+ # Calendar period is unset. This is the default if the budget is for a
309
+ # custom time period (CustomPeriod).
294
310
  CALENDAR_PERIOD_UNSPECIFIED = 0
295
311
 
296
312
  # A month. Month starts on the first day of each month, such as January 1,
@@ -46,8 +46,8 @@ module Google
46
46
 
47
47
  # `Value` represents a dynamically typed value which can be either
48
48
  # null, a number, a string, a boolean, a recursive struct value, or a
49
- # list of values. A producer of value is expected to set one of that
50
- # variants, absence of any variant indicates an error.
49
+ # list of values. A producer of value is expected to set one of these
50
+ # variants. Absence of any variant indicates an error.
51
51
  #
52
52
  # The JSON representation for `Value` is JSON value.
53
53
  # @!attribute [rw] null_value
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-billing-budgets-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.6.3
4
+ version: 0.7.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-08 00:00:00.000000000 Z
11
+ date: 2022-07-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.7'
19
+ version: '0.10'
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: '0.7'
29
+ version: '0.10'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -50,28 +50,28 @@ dependencies:
50
50
  requirements:
51
51
  - - "~>"
52
52
  - !ruby/object:Gem::Version
53
- version: 1.25.1
53
+ version: 1.26.1
54
54
  type: :development
55
55
  prerelease: false
56
56
  version_requirements: !ruby/object:Gem::Requirement
57
57
  requirements:
58
58
  - - "~>"
59
59
  - !ruby/object:Gem::Version
60
- version: 1.25.1
60
+ version: 1.26.1
61
61
  - !ruby/object:Gem::Dependency
62
62
  name: minitest
63
63
  requirement: !ruby/object:Gem::Requirement
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: '5.14'
67
+ version: '5.16'
68
68
  type: :development
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: '5.14'
74
+ version: '5.16'
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: minitest-focus
77
77
  requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
106
106
  requirements:
107
107
  - - ">="
108
108
  - !ruby/object:Gem::Version
109
- version: '12.0'
109
+ version: '13.0'
110
110
  type: :development
111
111
  prerelease: false
112
112
  version_requirements: !ruby/object:Gem::Requirement
113
113
  requirements:
114
114
  - - ">="
115
115
  - !ruby/object:Gem::Version
116
- version: '12.0'
116
+ version: '13.0'
117
117
  - !ruby/object:Gem::Dependency
118
118
  name: redcarpet
119
119
  requirement: !ruby/object:Gem::Requirement
@@ -201,14 +201,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
201
201
  requirements:
202
202
  - - ">="
203
203
  - !ruby/object:Gem::Version
204
- version: '2.5'
204
+ version: '2.6'
205
205
  required_rubygems_version: !ruby/object:Gem::Requirement
206
206
  requirements:
207
207
  - - ">="
208
208
  - !ruby/object:Gem::Version
209
209
  version: '0'
210
210
  requirements: []
211
- rubygems_version: 3.2.17
211
+ rubygems_version: 3.3.14
212
212
  signing_key:
213
213
  specification_version: 4
214
214
  summary: API Client library for the Billing Budgets V1beta1 API