google-cloud-billing-budgets-v1 0.3.0 → 0.5.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +1 -1
- data/lib/google/cloud/billing/budgets/v1/budget_model_pb.rb +27 -61
- data/lib/google/cloud/billing/budgets/v1/budget_service/client.rb +14 -5
- data/lib/google/cloud/billing/budgets/v1/budget_service/rest/client.rb +14 -5
- data/lib/google/cloud/billing/budgets/v1/budget_service/rest/service_stub.rb +5 -5
- data/lib/google/cloud/billing/budgets/v1/budget_service_pb.rb +26 -24
- data/lib/google/cloud/billing/budgets/v1/version.rb +1 -1
- data/proto_docs/google/api/client.rb +67 -4
- data/proto_docs/google/api/field_behavior.rb +14 -0
- data/proto_docs/google/cloud/billing/budgets/v1/budget_model.rb +110 -40
- data/proto_docs/google/cloud/billing/budgets/v1/budget_service.rb +8 -0
- data/proto_docs/google/protobuf/struct.rb +1 -1
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: a4512fefdd2ce943efad9cab9d454c64b20599c539fc9ad123313c2d4566d250
|
4
|
+
data.tar.gz: 3f6b8ff259645c2128ac0a84b995e862ef417134397a0d13d6237cd6682a0c69
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 82cdeb2eaa09185644b797d58e99197504c78d1d371f10d730e95d74ac7cec6685cfc47f03ca90ea346b1f9119d2d837804ac0593a08bda64fe9081188b5536e
|
7
|
+
data.tar.gz: e0364409586073eca080fb56986b24cd4c08949ccd1a6819f6567d227674863ce376dfbf74a888cdf012aad494ae4cb9204768c0e7be0c74be6ce28c36e6675d
|
data/README.md
CHANGED
@@ -47,7 +47,7 @@ for general usage information.
|
|
47
47
|
|
48
48
|
To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
49
49
|
The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
|
50
|
-
or a [`Google::Cloud::Logging::Logger`](https://
|
50
|
+
or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
|
51
51
|
that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
52
52
|
and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
53
53
|
|
@@ -1,3 +1,4 @@
|
|
1
|
+
# frozen_string_literal: true
|
1
2
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
3
|
# source: google/cloud/billing/budgets/v1/budget_model.proto
|
3
4
|
|
@@ -9,69 +10,34 @@ require 'google/protobuf/struct_pb'
|
|
9
10
|
require 'google/type/date_pb'
|
10
11
|
require 'google/type/money_pb'
|
11
12
|
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
value :BASIS_UNSPECIFIED, 0
|
37
|
-
value :CURRENT_SPEND, 1
|
38
|
-
value :FORECASTED_SPEND, 2
|
39
|
-
end
|
40
|
-
add_message "google.cloud.billing.budgets.v1.NotificationsRule" do
|
41
|
-
optional :pubsub_topic, :string, 1
|
42
|
-
optional :schema_version, :string, 2
|
43
|
-
repeated :monitoring_notification_channels, :string, 3
|
44
|
-
optional :disable_default_iam_recipients, :bool, 4
|
45
|
-
end
|
46
|
-
add_message "google.cloud.billing.budgets.v1.Filter" do
|
47
|
-
repeated :projects, :string, 1
|
48
|
-
repeated :credit_types, :string, 7
|
49
|
-
optional :credit_types_treatment, :enum, 4, "google.cloud.billing.budgets.v1.Filter.CreditTypesTreatment"
|
50
|
-
repeated :services, :string, 3
|
51
|
-
repeated :subaccounts, :string, 5
|
52
|
-
map :labels, :string, :message, 6, "google.protobuf.ListValue"
|
53
|
-
oneof :usage_period do
|
54
|
-
optional :calendar_period, :enum, 8, "google.cloud.billing.budgets.v1.CalendarPeriod"
|
55
|
-
optional :custom_period, :message, 9, "google.cloud.billing.budgets.v1.CustomPeriod"
|
56
|
-
end
|
57
|
-
end
|
58
|
-
add_enum "google.cloud.billing.budgets.v1.Filter.CreditTypesTreatment" do
|
59
|
-
value :CREDIT_TYPES_TREATMENT_UNSPECIFIED, 0
|
60
|
-
value :INCLUDE_ALL_CREDITS, 1
|
61
|
-
value :EXCLUDE_ALL_CREDITS, 2
|
62
|
-
value :INCLUDE_SPECIFIED_CREDITS, 3
|
63
|
-
end
|
64
|
-
add_message "google.cloud.billing.budgets.v1.CustomPeriod" do
|
65
|
-
optional :start_date, :message, 1, "google.type.Date"
|
66
|
-
optional :end_date, :message, 2, "google.type.Date"
|
67
|
-
end
|
68
|
-
add_enum "google.cloud.billing.budgets.v1.CalendarPeriod" do
|
69
|
-
value :CALENDAR_PERIOD_UNSPECIFIED, 0
|
70
|
-
value :MONTH, 1
|
71
|
-
value :QUARTER, 2
|
72
|
-
value :YEAR, 3
|
13
|
+
|
14
|
+
descriptor_data = "\n2google/cloud/billing/budgets/v1/budget_model.proto\x12\x1fgoogle.cloud.billing.budgets.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x16google/type/date.proto\x1a\x17google/type/money.proto\"\xcf\x03\n\x06\x42udget\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x43\n\rbudget_filter\x18\x03 \x01(\x0b\x32\'.google.cloud.billing.budgets.v1.FilterB\x03\xe0\x41\x01\x12\x42\n\x06\x61mount\x18\x04 \x01(\x0b\x32-.google.cloud.billing.budgets.v1.BudgetAmountB\x03\xe0\x41\x02\x12L\n\x0fthreshold_rules\x18\x05 \x03(\x0b\x32..google.cloud.billing.budgets.v1.ThresholdRuleB\x03\xe0\x41\x01\x12S\n\x12notifications_rule\x18\x06 \x01(\x0b\x32\x32.google.cloud.billing.budgets.v1.NotificationsRuleB\x03\xe0\x41\x01\x12\x11\n\x04\x65tag\x18\x07 \x01(\tB\x03\xe0\x41\x01:]\xea\x41Z\n$billingbudgets.googleapis.com/Budget\x12\x32\x62illingAccounts/{billing_account}/budgets/{budget}\"\xa0\x01\n\x0c\x42udgetAmount\x12.\n\x10specified_amount\x18\x01 \x01(\x0b\x32\x12.google.type.MoneyH\x00\x12O\n\x12last_period_amount\x18\x02 \x01(\x0b\x32\x31.google.cloud.billing.budgets.v1.LastPeriodAmountH\x00\x42\x0f\n\rbudget_amount\"\x12\n\x10LastPeriodAmount\"\xc8\x01\n\rThresholdRule\x12\x1e\n\x11threshold_percent\x18\x01 \x01(\x01\x42\x03\xe0\x41\x02\x12N\n\x0bspend_basis\x18\x02 \x01(\x0e\x32\x34.google.cloud.billing.budgets.v1.ThresholdRule.BasisB\x03\xe0\x41\x01\"G\n\x05\x42\x61sis\x12\x15\n\x11\x42\x41SIS_UNSPECIFIED\x10\x00\x12\x11\n\rCURRENT_SPEND\x10\x01\x12\x14\n\x10\x46ORECASTED_SPEND\x10\x02\"\xd5\x01\n\x11NotificationsRule\x12\x19\n\x0cpubsub_topic\x18\x01 \x01(\tB\x03\xe0\x41\x01\x12\x1b\n\x0eschema_version\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12-\n monitoring_notification_channels\x18\x03 \x03(\tB\x03\xe0\x41\x01\x12+\n\x1e\x64isable_default_iam_recipients\x18\x04 \x01(\x08\x42\x03\xe0\x41\x01\x12,\n\x1f\x65nable_project_level_recipients\x18\x05 \x01(\x08\x42\x03\xe0\x41\x01\"\xc4\x05\n\x06\x46ilter\x12\x15\n\x08projects\x18\x01 \x03(\tB\x03\xe0\x41\x01\x12\x1f\n\x12resource_ancestors\x18\x02 \x03(\tB\x03\xe0\x41\x01\x12\x19\n\x0c\x63redit_types\x18\x07 \x03(\tB\x03\xe0\x41\x01\x12\x61\n\x16\x63redit_types_treatment\x18\x04 \x01(\x0e\x32<.google.cloud.billing.budgets.v1.Filter.CreditTypesTreatmentB\x03\xe0\x41\x01\x12\x15\n\x08services\x18\x03 \x03(\tB\x03\xe0\x41\x01\x12\x18\n\x0bsubaccounts\x18\x05 \x03(\tB\x03\xe0\x41\x01\x12H\n\x06labels\x18\x06 \x03(\x0b\x32\x33.google.cloud.billing.budgets.v1.Filter.LabelsEntryB\x03\xe0\x41\x01\x12O\n\x0f\x63\x61lendar_period\x18\x08 \x01(\x0e\x32/.google.cloud.billing.budgets.v1.CalendarPeriodB\x03\xe0\x41\x01H\x00\x12K\n\rcustom_period\x18\t \x01(\x0b\x32-.google.cloud.billing.budgets.v1.CustomPeriodB\x03\xe0\x41\x01H\x00\x1aI\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12)\n\x05value\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.ListValue:\x02\x38\x01\"\x8f\x01\n\x14\x43reditTypesTreatment\x12&\n\"CREDIT_TYPES_TREATMENT_UNSPECIFIED\x10\x00\x12\x17\n\x13INCLUDE_ALL_CREDITS\x10\x01\x12\x17\n\x13\x45XCLUDE_ALL_CREDITS\x10\x02\x12\x1d\n\x19INCLUDE_SPECIFIED_CREDITS\x10\x03\x42\x0e\n\x0cusage_period\"d\n\x0c\x43ustomPeriod\x12*\n\nstart_date\x18\x01 \x01(\x0b\x32\x11.google.type.DateB\x03\xe0\x41\x02\x12(\n\x08\x65nd_date\x18\x02 \x01(\x0b\x32\x11.google.type.DateB\x03\xe0\x41\x01*S\n\x0e\x43\x61lendarPeriod\x12\x1f\n\x1b\x43\x41LENDAR_PERIOD_UNSPECIFIED\x10\x00\x12\t\n\x05MONTH\x10\x01\x12\x0b\n\x07QUARTER\x10\x02\x12\x08\n\x04YEAR\x10\x03\x42x\n#com.google.cloud.billing.budgets.v1B\x10\x42udgetModelProtoP\x01Z=cloud.google.com/go/billing/budgets/apiv1/budgetspb;budgetspbb\x06proto3"
|
15
|
+
|
16
|
+
pool = Google::Protobuf::DescriptorPool.generated_pool
|
17
|
+
|
18
|
+
begin
|
19
|
+
pool.add_serialized_file(descriptor_data)
|
20
|
+
rescue TypeError => e
|
21
|
+
# Compatibility code: will be removed in the next major version.
|
22
|
+
require 'google/protobuf/descriptor_pb'
|
23
|
+
parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
|
24
|
+
parsed.clear_dependency
|
25
|
+
serialized = parsed.class.encode(parsed)
|
26
|
+
file = pool.add_serialized_file(serialized)
|
27
|
+
warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
|
28
|
+
imports = [
|
29
|
+
["google.type.Money", "google/type/money.proto"],
|
30
|
+
["google.protobuf.ListValue", "google/protobuf/struct.proto"],
|
31
|
+
["google.type.Date", "google/type/date.proto"],
|
32
|
+
]
|
33
|
+
imports.each do |type_name, expected_filename|
|
34
|
+
import_file = pool.lookup(type_name).file_descriptor
|
35
|
+
if import_file.name != expected_filename
|
36
|
+
warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
|
73
37
|
end
|
74
38
|
end
|
39
|
+
warn "Each proto file must use a consistent fully-qualified name."
|
40
|
+
warn "This will become an error in the next major version."
|
75
41
|
end
|
76
42
|
|
77
43
|
module Google
|
@@ -147,7 +147,7 @@ module Google
|
|
147
147
|
credentials = @config.credentials
|
148
148
|
# Use self-signed JWT if the endpoint is unchanged from default,
|
149
149
|
# but only if the default endpoint does not have a region prefix.
|
150
|
-
enable_self_signed_jwt = @config.endpoint ==
|
150
|
+
enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
|
151
151
|
!@config.endpoint.split(".").first.include?("-")
|
152
152
|
credentials ||= Credentials.default scope: @config.scope,
|
153
153
|
enable_self_signed_jwt: enable_self_signed_jwt
|
@@ -464,7 +464,7 @@ module Google
|
|
464
464
|
# @param options [::Gapic::CallOptions, ::Hash]
|
465
465
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
466
466
|
#
|
467
|
-
# @overload list_budgets(parent: nil, page_size: nil, page_token: nil)
|
467
|
+
# @overload list_budgets(parent: nil, scope: nil, page_size: nil, page_token: nil)
|
468
468
|
# Pass arguments to `list_budgets` via keyword arguments. Note that at
|
469
469
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
470
470
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
@@ -472,6 +472,13 @@ module Google
|
|
472
472
|
# @param parent [::String]
|
473
473
|
# Required. Name of billing account to list budgets under. Values
|
474
474
|
# are of the form `billingAccounts/{billingAccountId}`.
|
475
|
+
# @param scope [::String]
|
476
|
+
# Optional. Set the scope of the budgets to be returned, in the format of the
|
477
|
+
# resource name. The scope of a budget is the cost that it tracks, such as
|
478
|
+
# costs for a single project, or the costs for all projects in a folder. Only
|
479
|
+
# project scope (in the format of "projects/project-id" or "projects/123") is
|
480
|
+
# supported in this field. When this field is set to a project's resource
|
481
|
+
# name, the budgets returned are tracking the costs for that project.
|
475
482
|
# @param page_size [::Integer]
|
476
483
|
# Optional. The maximum number of budgets to return per page.
|
477
484
|
# The default and maximum value are 100.
|
@@ -673,9 +680,9 @@ module Google
|
|
673
680
|
# * (`String`) The path to a service account key file in JSON format
|
674
681
|
# * (`Hash`) A service account key as a Hash
|
675
682
|
# * (`Google::Auth::Credentials`) A googleauth credentials object
|
676
|
-
# (see the [googleauth docs](https://
|
683
|
+
# (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
|
677
684
|
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
678
|
-
# (see the [signet docs](https://
|
685
|
+
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
679
686
|
# * (`GRPC::Core::Channel`) a gRPC channel with included credentials
|
680
687
|
# * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
|
681
688
|
# * (`nil`) indicating no credentials
|
@@ -717,7 +724,9 @@ module Google
|
|
717
724
|
class Configuration
|
718
725
|
extend ::Gapic::Config
|
719
726
|
|
720
|
-
|
727
|
+
DEFAULT_ENDPOINT = "billingbudgets.googleapis.com"
|
728
|
+
|
729
|
+
config_attr :endpoint, DEFAULT_ENDPOINT, ::String
|
721
730
|
config_attr :credentials, nil do |value|
|
722
731
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
723
732
|
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
@@ -143,7 +143,7 @@ module Google
|
|
143
143
|
credentials = @config.credentials
|
144
144
|
# Use self-signed JWT if the endpoint is unchanged from default,
|
145
145
|
# but only if the default endpoint does not have a region prefix.
|
146
|
-
enable_self_signed_jwt = @config.endpoint ==
|
146
|
+
enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
|
147
147
|
!@config.endpoint.split(".").first.include?("-")
|
148
148
|
credentials ||= Credentials.default scope: @config.scope,
|
149
149
|
enable_self_signed_jwt: enable_self_signed_jwt
|
@@ -386,7 +386,7 @@ module Google
|
|
386
386
|
# @param options [::Gapic::CallOptions, ::Hash]
|
387
387
|
# Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
|
388
388
|
#
|
389
|
-
# @overload list_budgets(parent: nil, page_size: nil, page_token: nil)
|
389
|
+
# @overload list_budgets(parent: nil, scope: nil, page_size: nil, page_token: nil)
|
390
390
|
# Pass arguments to `list_budgets` via keyword arguments. Note that at
|
391
391
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
392
392
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
@@ -394,6 +394,13 @@ module Google
|
|
394
394
|
# @param parent [::String]
|
395
395
|
# Required. Name of billing account to list budgets under. Values
|
396
396
|
# are of the form `billingAccounts/{billingAccountId}`.
|
397
|
+
# @param scope [::String]
|
398
|
+
# Optional. Set the scope of the budgets to be returned, in the format of the
|
399
|
+
# resource name. The scope of a budget is the cost that it tracks, such as
|
400
|
+
# costs for a single project, or the costs for all projects in a folder. Only
|
401
|
+
# project scope (in the format of "projects/project-id" or "projects/123") is
|
402
|
+
# supported in this field. When this field is set to a project's resource
|
403
|
+
# name, the budgets returned are tracking the costs for that project.
|
397
404
|
# @param page_size [::Integer]
|
398
405
|
# Optional. The maximum number of budgets to return per page.
|
399
406
|
# The default and maximum value are 100.
|
@@ -545,9 +552,9 @@ module Google
|
|
545
552
|
# * (`String`) The path to a service account key file in JSON format
|
546
553
|
# * (`Hash`) A service account key as a Hash
|
547
554
|
# * (`Google::Auth::Credentials`) A googleauth credentials object
|
548
|
-
# (see the [googleauth docs](https://
|
555
|
+
# (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
|
549
556
|
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
550
|
-
# (see the [signet docs](https://
|
557
|
+
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
551
558
|
# * (`nil`) indicating no credentials
|
552
559
|
# @return [::Object]
|
553
560
|
# @!attribute [rw] scope
|
@@ -580,7 +587,9 @@ module Google
|
|
580
587
|
class Configuration
|
581
588
|
extend ::Gapic::Config
|
582
589
|
|
583
|
-
|
590
|
+
DEFAULT_ENDPOINT = "billingbudgets.googleapis.com"
|
591
|
+
|
592
|
+
config_attr :endpoint, DEFAULT_ENDPOINT, ::String
|
584
593
|
config_attr :credentials, nil do |value|
|
585
594
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
586
595
|
allowed.any? { |klass| klass === value }
|
@@ -60,7 +60,7 @@ module Google
|
|
60
60
|
|
61
61
|
verb, uri, query_string_params, body = ServiceStub.transcode_create_budget_request request_pb
|
62
62
|
query_string_params = if query_string_params.any?
|
63
|
-
query_string_params.to_h { |p| p.split
|
63
|
+
query_string_params.to_h { |p| p.split "=", 2 }
|
64
64
|
else
|
65
65
|
{}
|
66
66
|
end
|
@@ -98,7 +98,7 @@ module Google
|
|
98
98
|
|
99
99
|
verb, uri, query_string_params, body = ServiceStub.transcode_update_budget_request request_pb
|
100
100
|
query_string_params = if query_string_params.any?
|
101
|
-
query_string_params.to_h { |p| p.split
|
101
|
+
query_string_params.to_h { |p| p.split "=", 2 }
|
102
102
|
else
|
103
103
|
{}
|
104
104
|
end
|
@@ -136,7 +136,7 @@ module Google
|
|
136
136
|
|
137
137
|
verb, uri, query_string_params, body = ServiceStub.transcode_get_budget_request request_pb
|
138
138
|
query_string_params = if query_string_params.any?
|
139
|
-
query_string_params.to_h { |p| p.split
|
139
|
+
query_string_params.to_h { |p| p.split "=", 2 }
|
140
140
|
else
|
141
141
|
{}
|
142
142
|
end
|
@@ -174,7 +174,7 @@ module Google
|
|
174
174
|
|
175
175
|
verb, uri, query_string_params, body = ServiceStub.transcode_list_budgets_request request_pb
|
176
176
|
query_string_params = if query_string_params.any?
|
177
|
-
query_string_params.to_h { |p| p.split
|
177
|
+
query_string_params.to_h { |p| p.split "=", 2 }
|
178
178
|
else
|
179
179
|
{}
|
180
180
|
end
|
@@ -212,7 +212,7 @@ module Google
|
|
212
212
|
|
213
213
|
verb, uri, query_string_params, body = ServiceStub.transcode_delete_budget_request request_pb
|
214
214
|
query_string_params = if query_string_params.any?
|
215
|
-
query_string_params.to_h { |p| p.split
|
215
|
+
query_string_params.to_h { |p| p.split "=", 2 }
|
216
216
|
else
|
217
217
|
{}
|
218
218
|
end
|
@@ -1,3 +1,4 @@
|
|
1
|
+
# frozen_string_literal: true
|
1
2
|
# Generated by the protocol buffer compiler. DO NOT EDIT!
|
2
3
|
# source: google/cloud/billing/budgets/v1/budget_service.proto
|
3
4
|
|
@@ -11,32 +12,33 @@ require 'google/cloud/billing/budgets/v1/budget_model_pb'
|
|
11
12
|
require 'google/protobuf/empty_pb'
|
12
13
|
require 'google/protobuf/field_mask_pb'
|
13
14
|
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
optional :name, :string, 1
|
15
|
+
|
16
|
+
descriptor_data = "\n4google/cloud/billing/budgets/v1/budget_service.proto\x12\x1fgoogle.cloud.billing.budgets.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x32google/cloud/billing/budgets/v1/budget_model.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\"\x91\x01\n\x13\x43reateBudgetRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$billingbudgets.googleapis.com/Budget\x12<\n\x06\x62udget\x18\x02 \x01(\x0b\x32\'.google.cloud.billing.budgets.v1.BudgetB\x03\xe0\x41\x02\"\x89\x01\n\x13UpdateBudgetRequest\x12<\n\x06\x62udget\x18\x01 \x01(\x0b\x32\'.google.cloud.billing.budgets.v1.BudgetB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x01\"N\n\x10GetBudgetRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$billingbudgets.googleapis.com/Budget\"\x97\x01\n\x12ListBudgetsRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$billingbudgets.googleapis.com/Budget\x12\x12\n\x05scope\x18\x04 \x01(\tB\x03\xe0\x41\x01\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\"h\n\x13ListBudgetsResponse\x12\x38\n\x07\x62udgets\x18\x01 \x03(\x0b\x32\'.google.cloud.billing.budgets.v1.Budget\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"Q\n\x13\x44\x65leteBudgetRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$billingbudgets.googleapis.com/Budget2\xf7\x07\n\rBudgetService\x12\xb5\x01\n\x0c\x43reateBudget\x12\x34.google.cloud.billing.budgets.v1.CreateBudgetRequest\x1a\'.google.cloud.billing.budgets.v1.Budget\"F\x82\xd3\xe4\x93\x02\x30\"&/v1/{parent=billingAccounts/*}/budgets:\x06\x62udget\xda\x41\rparent,budget\x12\xc1\x01\n\x0cUpdateBudget\x12\x34.google.cloud.billing.budgets.v1.UpdateBudgetRequest\x1a\'.google.cloud.billing.budgets.v1.Budget\"R\x82\xd3\xe4\x93\x02\x37\x32-/v1/{budget.name=billingAccounts/*/budgets/*}:\x06\x62udget\xda\x41\x12\x62udget,update_mask\x12\x9e\x01\n\tGetBudget\x12\x31.google.cloud.billing.budgets.v1.GetBudgetRequest\x1a\'.google.cloud.billing.budgets.v1.Budget\"5\x82\xd3\xe4\x93\x02(\x12&/v1/{name=billingAccounts/*/budgets/*}\xda\x41\x04name\x12\xb1\x01\n\x0bListBudgets\x12\x33.google.cloud.billing.budgets.v1.ListBudgetsRequest\x1a\x34.google.cloud.billing.budgets.v1.ListBudgetsResponse\"7\x82\xd3\xe4\x93\x02(\x12&/v1/{parent=billingAccounts/*}/budgets\xda\x41\x06parent\x12\x93\x01\n\x0c\x44\x65leteBudget\x12\x34.google.cloud.billing.budgets.v1.DeleteBudgetRequest\x1a\x16.google.protobuf.Empty\"5\x82\xd3\xe4\x93\x02(*&/v1/{name=billingAccounts/*/budgets/*}\xda\x41\x04name\x1a\x7f\xca\x41\x1d\x62illingbudgets.googleapis.com\xd2\x41\\https://www.googleapis.com/auth/cloud-billing,https://www.googleapis.com/auth/cloud-platformBz\n#com.google.cloud.billing.budgets.v1B\x12\x42udgetServiceProtoP\x01Z=cloud.google.com/go/billing/budgets/apiv1/budgetspb;budgetspbb\x06proto3"
|
17
|
+
|
18
|
+
pool = Google::Protobuf::DescriptorPool.generated_pool
|
19
|
+
|
20
|
+
begin
|
21
|
+
pool.add_serialized_file(descriptor_data)
|
22
|
+
rescue TypeError => e
|
23
|
+
# Compatibility code: will be removed in the next major version.
|
24
|
+
require 'google/protobuf/descriptor_pb'
|
25
|
+
parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
|
26
|
+
parsed.clear_dependency
|
27
|
+
serialized = parsed.class.encode(parsed)
|
28
|
+
file = pool.add_serialized_file(serialized)
|
29
|
+
warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
|
30
|
+
imports = [
|
31
|
+
["google.cloud.billing.budgets.v1.Budget", "google/cloud/billing/budgets/v1/budget_model.proto"],
|
32
|
+
["google.protobuf.FieldMask", "google/protobuf/field_mask.proto"],
|
33
|
+
]
|
34
|
+
imports.each do |type_name, expected_filename|
|
35
|
+
import_file = pool.lookup(type_name).file_descriptor
|
36
|
+
if import_file.name != expected_filename
|
37
|
+
warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
|
38
38
|
end
|
39
39
|
end
|
40
|
+
warn "Each proto file must use a consistent fully-qualified name."
|
41
|
+
warn "This will become an error in the next major version."
|
40
42
|
end
|
41
43
|
|
42
44
|
module Google
|
@@ -35,7 +35,9 @@ module Google
|
|
35
35
|
# Details about how and where to publish client libraries.
|
36
36
|
# @!attribute [rw] version
|
37
37
|
# @return [::String]
|
38
|
-
# Version of the API to apply these settings to.
|
38
|
+
# Version of the API to apply these settings to. This is the full protobuf
|
39
|
+
# package for the API, ending in the version element.
|
40
|
+
# Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
|
39
41
|
# @!attribute [rw] launch_stage
|
40
42
|
# @return [::Google::Api::LaunchStage]
|
41
43
|
# Launch stage of this version of the API.
|
@@ -81,7 +83,7 @@ module Google
|
|
81
83
|
# long-running operation pattern.
|
82
84
|
# @!attribute [rw] new_issue_uri
|
83
85
|
# @return [::String]
|
84
|
-
# Link to a
|
86
|
+
# Link to a *public* URI where users can report issues. Example:
|
85
87
|
# https://issuetracker.google.com/issues/new?component=190865&template=1161103
|
86
88
|
# @!attribute [rw] documentation_uri
|
87
89
|
# @return [::String]
|
@@ -111,6 +113,10 @@ module Google
|
|
111
113
|
# Client library settings. If the same version string appears multiple
|
112
114
|
# times in this list, then the last one wins. Settings from earlier
|
113
115
|
# settings with the same version string are discarded.
|
116
|
+
# @!attribute [rw] proto_reference_documentation_uri
|
117
|
+
# @return [::String]
|
118
|
+
# Optional link to proto reference documentation. Example:
|
119
|
+
# https://cloud.google.com/pubsub/lite/docs/reference/rpc
|
114
120
|
class Publishing
|
115
121
|
include ::Google::Protobuf::MessageExts
|
116
122
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -203,9 +209,57 @@ module Google
|
|
203
209
|
# @!attribute [rw] common
|
204
210
|
# @return [::Google::Api::CommonLanguageSettings]
|
205
211
|
# Some settings.
|
212
|
+
# @!attribute [rw] renamed_services
|
213
|
+
# @return [::Google::Protobuf::Map{::String => ::String}]
|
214
|
+
# Map from original service names to renamed versions.
|
215
|
+
# This is used when the default generated types
|
216
|
+
# would cause a naming conflict. (Neither name is
|
217
|
+
# fully-qualified.)
|
218
|
+
# Example: Subscriber to SubscriberServiceApi.
|
219
|
+
# @!attribute [rw] renamed_resources
|
220
|
+
# @return [::Google::Protobuf::Map{::String => ::String}]
|
221
|
+
# Map from full resource types to the effective short name
|
222
|
+
# for the resource. This is used when otherwise resource
|
223
|
+
# named from different services would cause naming collisions.
|
224
|
+
# Example entry:
|
225
|
+
# "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
|
226
|
+
# @!attribute [rw] ignored_resources
|
227
|
+
# @return [::Array<::String>]
|
228
|
+
# List of full resource types to ignore during generation.
|
229
|
+
# This is typically used for API-specific Location resources,
|
230
|
+
# which should be handled by the generator as if they were actually
|
231
|
+
# the common Location resources.
|
232
|
+
# Example entry: "documentai.googleapis.com/Location"
|
233
|
+
# @!attribute [rw] forced_namespace_aliases
|
234
|
+
# @return [::Array<::String>]
|
235
|
+
# Namespaces which must be aliased in snippets due to
|
236
|
+
# a known (but non-generator-predictable) naming collision
|
237
|
+
# @!attribute [rw] handwritten_signatures
|
238
|
+
# @return [::Array<::String>]
|
239
|
+
# Method signatures (in the form "service.method(signature)")
|
240
|
+
# which are provided separately, so shouldn't be generated.
|
241
|
+
# Snippets *calling* these methods are still generated, however.
|
206
242
|
class DotnetSettings
|
207
243
|
include ::Google::Protobuf::MessageExts
|
208
244
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
245
|
+
|
246
|
+
# @!attribute [rw] key
|
247
|
+
# @return [::String]
|
248
|
+
# @!attribute [rw] value
|
249
|
+
# @return [::String]
|
250
|
+
class RenamedServicesEntry
|
251
|
+
include ::Google::Protobuf::MessageExts
|
252
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
253
|
+
end
|
254
|
+
|
255
|
+
# @!attribute [rw] key
|
256
|
+
# @return [::String]
|
257
|
+
# @!attribute [rw] value
|
258
|
+
# @return [::String]
|
259
|
+
class RenamedResourcesEntry
|
260
|
+
include ::Google::Protobuf::MessageExts
|
261
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
262
|
+
end
|
209
263
|
end
|
210
264
|
|
211
265
|
# Settings for Ruby client libraries.
|
@@ -240,8 +294,8 @@ module Google
|
|
240
294
|
# Example of a YAML configuration::
|
241
295
|
#
|
242
296
|
# publishing:
|
243
|
-
#
|
244
|
-
# - selector:
|
297
|
+
# method_settings:
|
298
|
+
# - selector: google.cloud.speech.v2.Speech.BatchRecognize
|
245
299
|
# long_running:
|
246
300
|
# initial_poll_delay:
|
247
301
|
# seconds: 60 # 1 minute
|
@@ -299,6 +353,15 @@ module Google
|
|
299
353
|
|
300
354
|
# Street View Org.
|
301
355
|
STREET_VIEW = 4
|
356
|
+
|
357
|
+
# Shopping Org.
|
358
|
+
SHOPPING = 5
|
359
|
+
|
360
|
+
# Geo Org.
|
361
|
+
GEO = 6
|
362
|
+
|
363
|
+
# Generative AI - https://developers.generativeai.google
|
364
|
+
GENERATIVE_AI = 7
|
302
365
|
end
|
303
366
|
|
304
367
|
# To where should client libraries be published?
|
@@ -66,6 +66,20 @@ module Google
|
|
66
66
|
# a non-empty value will be returned. The user will not be aware of what
|
67
67
|
# non-empty value to expect.
|
68
68
|
NON_EMPTY_DEFAULT = 7
|
69
|
+
|
70
|
+
# Denotes that the field in a resource (a message annotated with
|
71
|
+
# google.api.resource) is used in the resource name to uniquely identify the
|
72
|
+
# resource. For AIP-compliant APIs, this should only be applied to the
|
73
|
+
# `name` field on the resource.
|
74
|
+
#
|
75
|
+
# This behavior should not be applied to references to other resources within
|
76
|
+
# the message.
|
77
|
+
#
|
78
|
+
# The identifier field of resources often have different field behavior
|
79
|
+
# depending on the request it is embedded in (e.g. for Create methods name
|
80
|
+
# is optional and unused, while for Update methods it is required). Instead
|
81
|
+
# of method-specific annotations, only `IDENTIFIER` is required.
|
82
|
+
IDENTIFIER = 8
|
69
83
|
end
|
70
84
|
end
|
71
85
|
end
|
@@ -48,6 +48,10 @@ module Google
|
|
48
48
|
# @return [::Array<::Google::Cloud::Billing::Budgets::V1::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] notifications_rule
|
52
56
|
# @return [::Google::Cloud::Billing::Budgets::V1::NotificationsRule]
|
53
57
|
# Optional. Rules to apply to notifications sent based on budget spend and
|
@@ -56,7 +60,7 @@ module Google
|
|
56
60
|
# @return [::String]
|
57
61
|
# Optional. Etag to validate that the object is unchanged for a
|
58
62
|
# read-modify-write operation.
|
59
|
-
# An empty etag
|
63
|
+
# An empty etag causes an update to overwrite other changes.
|
60
64
|
class Budget
|
61
65
|
include ::Google::Protobuf::MessageExts
|
62
66
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -86,8 +90,6 @@ module Google
|
|
86
90
|
# {::Google::Cloud::Billing::Budgets::V1::Filter#calendar_period Filter.calendar_period}
|
87
91
|
# spend. At this time, the amount is automatically 100% of the last calendar
|
88
92
|
# period's spend; that is, there are no other options yet.
|
89
|
-
# Future configuration options will be described here (for example, configuring
|
90
|
-
# a percentage of last period's spend).
|
91
93
|
# LastPeriodAmount cannot be set for a budget configured with
|
92
94
|
# a
|
93
95
|
# {::Google::Cloud::Billing::Budgets::V1::Filter#custom_period Filter.custom_period}.
|
@@ -96,13 +98,28 @@ module Google
|
|
96
98
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
97
99
|
end
|
98
100
|
|
99
|
-
# ThresholdRule contains
|
100
|
-
#
|
101
|
-
# spend
|
102
|
-
#
|
103
|
-
#
|
104
|
-
#
|
105
|
-
#
|
101
|
+
# ThresholdRule contains the definition of a threshold. Threshold rules define
|
102
|
+
# the triggering events used to generate a budget notification email. When a
|
103
|
+
# threshold is crossed (spend exceeds the specified percentages of the
|
104
|
+
# budget), budget alert emails are sent to the email recipients you specify
|
105
|
+
# in the
|
106
|
+
# [NotificationsRule](#notificationsrule).
|
107
|
+
#
|
108
|
+
# Threshold rules also affect the fields included in the
|
109
|
+
# [JSON data
|
110
|
+
# object](https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format)
|
111
|
+
# sent to a Pub/Sub topic.
|
112
|
+
#
|
113
|
+
# Threshold rules are _required_ if using email notifications.
|
114
|
+
#
|
115
|
+
# Threshold rules are _optional_ if only setting a
|
116
|
+
# [`pubsubTopic` NotificationsRule](#NotificationsRule),
|
117
|
+
# unless you want your JSON data object to include data about the thresholds
|
118
|
+
# you set.
|
119
|
+
#
|
120
|
+
# For more information, see
|
121
|
+
# [set budget threshold rules and
|
122
|
+
# actions](https://cloud.google.com/billing/docs/how-to/budgets#budget-actions).
|
106
123
|
# @!attribute [rw] threshold_percent
|
107
124
|
# @return [::Float]
|
108
125
|
# Required. Send an alert when this threshold is exceeded.
|
@@ -138,17 +155,32 @@ module Google
|
|
138
155
|
# and thresholds.
|
139
156
|
# @!attribute [rw] pubsub_topic
|
140
157
|
# @return [::String]
|
141
|
-
# Optional. The name of the Pub/Sub topic where budget
|
142
|
-
#
|
143
|
-
#
|
144
|
-
#
|
145
|
-
#
|
146
|
-
#
|
147
|
-
#
|
148
|
-
#
|
149
|
-
#
|
150
|
-
#
|
151
|
-
#
|
158
|
+
# Optional. The name of the Pub/Sub topic where budget-related messages are
|
159
|
+
# published, in the form `projects/{project_id}/topics/{topic_id}`. Updates
|
160
|
+
# are sent to the topic at regular intervals; the timing of the updates is
|
161
|
+
# not dependent on the [threshold rules](#thresholdrule) you've set.
|
162
|
+
#
|
163
|
+
# Note that if you want your
|
164
|
+
# [Pub/Sub JSON
|
165
|
+
# object](https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format)
|
166
|
+
# to contain data for `alertThresholdExceeded`, you need at least one
|
167
|
+
# [alert threshold rule](#thresholdrule). When you set threshold rules, you
|
168
|
+
# must also enable at least one of the email notification options, either
|
169
|
+
# using the default IAM recipients or Cloud Monitoring email notification
|
170
|
+
# channels.
|
171
|
+
#
|
172
|
+
# To use Pub/Sub topics with budgets, you must do the following:
|
173
|
+
#
|
174
|
+
# 1. Create the Pub/Sub topic
|
175
|
+
# before connecting it to your budget. For guidance, see
|
176
|
+
# [Manage programmatic budget alert
|
177
|
+
# notifications](https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications).
|
178
|
+
#
|
179
|
+
# 2. Grant the API caller the `pubsub.topics.setIamPolicy` permission on
|
180
|
+
# the Pub/Sub topic. If not set, the API call fails with PERMISSION_DENIED.
|
181
|
+
# For additional details on Pub/Sub roles and permissions, see
|
182
|
+
# [Permissions required for this
|
183
|
+
# task](https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#permissions_required_for_this_task).
|
152
184
|
# @!attribute [rw] schema_version
|
153
185
|
# @return [::String]
|
154
186
|
# Optional. Required when
|
@@ -159,20 +191,43 @@ module Google
|
|
159
191
|
# https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format.
|
160
192
|
# @!attribute [rw] monitoring_notification_channels
|
161
193
|
# @return [::Array<::String>]
|
162
|
-
# Optional.
|
163
|
-
# This is in addition to
|
164
|
-
#
|
165
|
-
# notification channel with
|
166
|
-
# `projects/{project_id}/notificationChannels/{channel_id}`. A
|
167
|
-
#
|
168
|
-
#
|
169
|
-
#
|
194
|
+
# Optional. Email targets to send notifications to when a threshold is
|
195
|
+
# exceeded. This is in addition to the `DefaultIamRecipients` who receive
|
196
|
+
# alert emails based on their billing account IAM role. The value is the full
|
197
|
+
# REST resource name of a Cloud Monitoring email notification channel with
|
198
|
+
# the form `projects/{project_id}/notificationChannels/{channel_id}`. A
|
199
|
+
# maximum of 5 email notifications are allowed.
|
200
|
+
#
|
201
|
+
# To customize budget alert email recipients with monitoring notification
|
202
|
+
# channels, you _must create the monitoring notification channels before
|
203
|
+
# you link them to a budget_. For guidance on setting up notification
|
204
|
+
# channels to use with budgets, see
|
205
|
+
# [Customize budget alert email
|
206
|
+
# recipients](https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients).
|
207
|
+
#
|
208
|
+
# For Cloud Billing budget alerts, you _must use email notification
|
209
|
+
# channels_. The other types of notification channels are _not_
|
210
|
+
# supported, such as Slack, SMS, or PagerDuty. If you want to
|
211
|
+
# [send budget notifications to
|
212
|
+
# Slack](https://cloud.google.com/billing/docs/how-to/notify#send_notifications_to_slack),
|
213
|
+
# use a pubsubTopic and configure
|
214
|
+
# [programmatic
|
215
|
+
# notifications](https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications).
|
170
216
|
# @!attribute [rw] disable_default_iam_recipients
|
171
217
|
# @return [::Boolean]
|
172
218
|
# Optional. When set to true, disables default notifications sent when a
|
173
219
|
# threshold is exceeded. Default notifications are sent to those with Billing
|
174
220
|
# Account Administrator and Billing Account User IAM roles for the target
|
175
221
|
# account.
|
222
|
+
# @!attribute [rw] enable_project_level_recipients
|
223
|
+
# @return [::Boolean]
|
224
|
+
# Optional. When set to true, and when the budget has a single project
|
225
|
+
# configured, notifications will be sent to project level recipients of that
|
226
|
+
# project. This field will be ignored if the budget has multiple or no
|
227
|
+
# project configured.
|
228
|
+
#
|
229
|
+
# Currently, project level recipients are the users with `Owner` role on a
|
230
|
+
# cloud project.
|
176
231
|
class NotificationsRule
|
177
232
|
include ::Google::Protobuf::MessageExts
|
178
233
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -183,9 +238,17 @@ module Google
|
|
183
238
|
# @return [::Array<::String>]
|
184
239
|
# Optional. A set of projects of the form `projects/{project}`,
|
185
240
|
# specifying that usage from only this set of projects should be
|
186
|
-
# included in the budget. If omitted, the report
|
241
|
+
# included in the budget. If omitted, the report includes all usage for
|
187
242
|
# the billing account, regardless of which project the usage occurred on.
|
188
|
-
#
|
243
|
+
# @!attribute [rw] resource_ancestors
|
244
|
+
# @return [::Array<::String>]
|
245
|
+
# Optional. A set of folder and organization names of the form
|
246
|
+
# `folders/{folderId}` or `organizations/{organizationId}`, specifying that
|
247
|
+
# usage from only this set of folders and organizations should be included in
|
248
|
+
# the budget. If omitted, the budget includes all usage that the billing
|
249
|
+
# account pays for. If the folder or organization contains projects that are
|
250
|
+
# paid for by a different Cloud Billing account, the budget *doesn't* apply
|
251
|
+
# to those projects.
|
189
252
|
# @!attribute [rw] credit_types
|
190
253
|
# @return [::Array<::String>]
|
191
254
|
# Optional. If
|
@@ -205,7 +268,7 @@ module Google
|
|
205
268
|
# @return [::Array<::String>]
|
206
269
|
# Optional. A set of services of the form `services/{service_id}`,
|
207
270
|
# specifying that usage from only this set of services should be
|
208
|
-
# included in the budget. If omitted, the report
|
271
|
+
# included in the budget. If omitted, the report includes usage for
|
209
272
|
# all the services.
|
210
273
|
# The service names are available through the Catalog API:
|
211
274
|
# https://cloud.google.com/billing/v1/how-tos/catalog-api.
|
@@ -214,21 +277,26 @@ module Google
|
|
214
277
|
# Optional. A set of subaccounts of the form `billingAccounts/{account_id}`,
|
215
278
|
# specifying that usage from only this set of subaccounts should be included
|
216
279
|
# in the budget. If a subaccount is set to the name of the parent account,
|
217
|
-
# usage from the parent account
|
218
|
-
# the report
|
280
|
+
# usage from the parent account is included. If the field is omitted,
|
281
|
+
# the report includes usage from the parent account and all subaccounts,
|
219
282
|
# if they exist.
|
220
283
|
# @!attribute [rw] labels
|
221
284
|
# @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::ListValue}]
|
222
285
|
# Optional. A single label and value pair specifying that usage from only
|
223
|
-
# this set of labeled resources should be included in the budget.
|
224
|
-
#
|
225
|
-
#
|
286
|
+
# this set of labeled resources should be included in the budget. If omitted,
|
287
|
+
# the report includes all labeled and unlabeled usage.
|
288
|
+
#
|
289
|
+
# An object containing a single `"key": value` pair. Example: `{ "name":
|
290
|
+
# "wrench" }`.
|
291
|
+
#
|
292
|
+
# _Currently, multiple entries or multiple values per entry are not
|
293
|
+
# allowed._
|
226
294
|
# @!attribute [rw] calendar_period
|
227
295
|
# @return [::Google::Cloud::Billing::Budgets::V1::CalendarPeriod]
|
228
296
|
# Optional. Specifies to track usage for recurring calendar period.
|
229
|
-
# For example, assume that CalendarPeriod.QUARTER is set. The budget
|
230
|
-
#
|
231
|
-
# April, May, June. After that, it
|
297
|
+
# For example, assume that CalendarPeriod.QUARTER is set. The budget
|
298
|
+
# tracks usage from April 1 to June 30, when the current calendar month is
|
299
|
+
# April, May, June. After that, it tracks usage from July 1 to
|
232
300
|
# September 30 when the current calendar month is July, August, September,
|
233
301
|
# so on.
|
234
302
|
# @!attribute [rw] custom_period
|
@@ -291,6 +359,8 @@ module Google
|
|
291
359
|
# `CalendarPeriod`". All calendar times begin at 12 AM US and Canadian
|
292
360
|
# Pacific Time (UTC-8).
|
293
361
|
module CalendarPeriod
|
362
|
+
# Calendar period is unset. This is the default if the budget is for a
|
363
|
+
# custom time period (CustomPeriod).
|
294
364
|
CALENDAR_PERIOD_UNSPECIFIED = 0
|
295
365
|
|
296
366
|
# A month. Month starts on the first day of each month, such as January 1,
|
@@ -68,6 +68,14 @@ module Google
|
|
68
68
|
# @return [::String]
|
69
69
|
# Required. Name of billing account to list budgets under. Values
|
70
70
|
# are of the form `billingAccounts/{billingAccountId}`.
|
71
|
+
# @!attribute [rw] scope
|
72
|
+
# @return [::String]
|
73
|
+
# Optional. Set the scope of the budgets to be returned, in the format of the
|
74
|
+
# resource name. The scope of a budget is the cost that it tracks, such as
|
75
|
+
# costs for a single project, or the costs for all projects in a folder. Only
|
76
|
+
# project scope (in the format of "projects/project-id" or "projects/123") is
|
77
|
+
# supported in this field. When this field is set to a project's resource
|
78
|
+
# name, the budgets returned are tracking the costs for that project.
|
71
79
|
# @!attribute [rw] page_size
|
72
80
|
# @return [::Integer]
|
73
81
|
# Optional. The maximum number of budgets to return per page.
|
@@ -87,7 +87,7 @@ module Google
|
|
87
87
|
# `NullValue` is a singleton enumeration to represent the null value for the
|
88
88
|
# `Value` type union.
|
89
89
|
#
|
90
|
-
#
|
90
|
+
# The JSON representation for `NullValue` is JSON `null`.
|
91
91
|
module NullValue
|
92
92
|
# Null value.
|
93
93
|
NULL_VALUE = 0
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-billing-budgets-v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.5.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: 2023-
|
11
|
+
date: 2023-09-04 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.
|
19
|
+
version: 0.19.1
|
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.
|
29
|
+
version: 0.19.1
|
30
30
|
- - "<"
|
31
31
|
- !ruby/object:Gem::Version
|
32
32
|
version: 2.a
|
@@ -215,7 +215,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
215
215
|
- !ruby/object:Gem::Version
|
216
216
|
version: '0'
|
217
217
|
requirements: []
|
218
|
-
rubygems_version: 3.4.
|
218
|
+
rubygems_version: 3.4.19
|
219
219
|
signing_key:
|
220
220
|
specification_version: 4
|
221
221
|
summary: The Cloud Billing Budget API stores Cloud Billing budgets, which define a
|