google-cloud-resource_manager-v3 0.6.2 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +72 -101
- data/lib/google/cloud/resource_manager/v3/folders/client.rb +42 -9
- data/lib/google/cloud/resource_manager/v3/folders/operations.rb +38 -7
- data/lib/google/cloud/resource_manager/v3/folders/rest/client.rb +253 -7
- data/lib/google/cloud/resource_manager/v3/folders/rest/operations.rb +108 -8
- data/lib/google/cloud/resource_manager/v3/folders/rest/service_stub.rb +14 -2
- data/lib/google/cloud/resource_manager/v3/organizations/client.rb +41 -9
- data/lib/google/cloud/resource_manager/v3/organizations/rest/client.rb +117 -7
- data/lib/google/cloud/resource_manager/v3/organizations/rest/service_stub.rb +14 -2
- data/lib/google/cloud/resource_manager/v3/projects/client.rb +42 -9
- data/lib/google/cloud/resource_manager/v3/projects/operations.rb +38 -7
- data/lib/google/cloud/resource_manager/v3/projects/rest/client.rb +253 -7
- data/lib/google/cloud/resource_manager/v3/projects/rest/operations.rb +108 -8
- data/lib/google/cloud/resource_manager/v3/projects/rest/service_stub.rb +14 -2
- data/lib/google/cloud/resource_manager/v3/tag_bindings/client.rb +42 -9
- data/lib/google/cloud/resource_manager/v3/tag_bindings/operations.rb +38 -7
- data/lib/google/cloud/resource_manager/v3/tag_bindings/rest/client.rb +120 -7
- data/lib/google/cloud/resource_manager/v3/tag_bindings/rest/operations.rb +108 -8
- data/lib/google/cloud/resource_manager/v3/tag_bindings/rest/service_stub.rb +14 -2
- data/lib/google/cloud/resource_manager/v3/tag_holds/client.rb +42 -9
- data/lib/google/cloud/resource_manager/v3/tag_holds/operations.rb +38 -7
- data/lib/google/cloud/resource_manager/v3/tag_holds/rest/client.rb +100 -7
- data/lib/google/cloud/resource_manager/v3/tag_holds/rest/operations.rb +108 -8
- data/lib/google/cloud/resource_manager/v3/tag_holds/rest/service_stub.rb +14 -2
- data/lib/google/cloud/resource_manager/v3/tag_keys/client.rb +42 -9
- data/lib/google/cloud/resource_manager/v3/tag_keys/operations.rb +38 -7
- data/lib/google/cloud/resource_manager/v3/tag_keys/rest/client.rb +203 -7
- data/lib/google/cloud/resource_manager/v3/tag_keys/rest/operations.rb +108 -8
- data/lib/google/cloud/resource_manager/v3/tag_keys/rest/service_stub.rb +14 -2
- data/lib/google/cloud/resource_manager/v3/tag_values/client.rb +42 -9
- data/lib/google/cloud/resource_manager/v3/tag_values/operations.rb +38 -7
- data/lib/google/cloud/resource_manager/v3/tag_values/rest/client.rb +203 -7
- data/lib/google/cloud/resource_manager/v3/tag_values/rest/operations.rb +108 -8
- data/lib/google/cloud/resource_manager/v3/tag_values/rest/service_stub.rb +14 -2
- data/lib/google/cloud/resource_manager/v3/version.rb +1 -1
- data/proto_docs/google/api/client.rb +14 -0
- data/proto_docs/google/api/field_behavior.rb +14 -0
- metadata +5 -5
@@ -32,6 +32,9 @@ module Google
|
|
32
32
|
# Allow users to create and manage tag values.
|
33
33
|
#
|
34
34
|
class Client
|
35
|
+
# @private
|
36
|
+
DEFAULT_ENDPOINT_TEMPLATE = "cloudresourcemanager.$UNIVERSE_DOMAIN$"
|
37
|
+
|
35
38
|
include Paths
|
36
39
|
|
37
40
|
# @private
|
@@ -115,6 +118,15 @@ module Google
|
|
115
118
|
@config
|
116
119
|
end
|
117
120
|
|
121
|
+
##
|
122
|
+
# The effective universe domain
|
123
|
+
#
|
124
|
+
# @return [String]
|
125
|
+
#
|
126
|
+
def universe_domain
|
127
|
+
@tag_values_stub.universe_domain
|
128
|
+
end
|
129
|
+
|
118
130
|
##
|
119
131
|
# Create a new TagValues REST client object.
|
120
132
|
#
|
@@ -142,8 +154,9 @@ module Google
|
|
142
154
|
credentials = @config.credentials
|
143
155
|
# Use self-signed JWT if the endpoint is unchanged from default,
|
144
156
|
# but only if the default endpoint does not have a region prefix.
|
145
|
-
enable_self_signed_jwt = @config.endpoint
|
146
|
-
|
157
|
+
enable_self_signed_jwt = @config.endpoint.nil? ||
|
158
|
+
(@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
|
159
|
+
!@config.endpoint.split(".").first.include?("-"))
|
147
160
|
credentials ||= Credentials.default scope: @config.scope,
|
148
161
|
enable_self_signed_jwt: enable_self_signed_jwt
|
149
162
|
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
@@ -157,9 +170,15 @@ module Google
|
|
157
170
|
config.credentials = credentials
|
158
171
|
config.quota_project = @quota_project_id
|
159
172
|
config.endpoint = @config.endpoint
|
173
|
+
config.universe_domain = @config.universe_domain
|
160
174
|
end
|
161
175
|
|
162
|
-
@tag_values_stub = ::Google::Cloud::ResourceManager::V3::TagValues::Rest::ServiceStub.new
|
176
|
+
@tag_values_stub = ::Google::Cloud::ResourceManager::V3::TagValues::Rest::ServiceStub.new(
|
177
|
+
endpoint: @config.endpoint,
|
178
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
179
|
+
universe_domain: @config.universe_domain,
|
180
|
+
credentials: credentials
|
181
|
+
)
|
163
182
|
end
|
164
183
|
|
165
184
|
##
|
@@ -205,6 +224,26 @@ module Google
|
|
205
224
|
# @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ResourceManager::V3::TagValue>]
|
206
225
|
#
|
207
226
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
227
|
+
#
|
228
|
+
# @example Basic example
|
229
|
+
# require "google/cloud/resource_manager/v3"
|
230
|
+
#
|
231
|
+
# # Create a client object. The client can be reused for multiple calls.
|
232
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
233
|
+
#
|
234
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
235
|
+
# request = Google::Cloud::ResourceManager::V3::ListTagValuesRequest.new
|
236
|
+
#
|
237
|
+
# # Call the list_tag_values method.
|
238
|
+
# result = client.list_tag_values request
|
239
|
+
#
|
240
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
241
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
242
|
+
# result.each do |item|
|
243
|
+
# # Each element is of type ::Google::Cloud::ResourceManager::V3::TagValue.
|
244
|
+
# p item
|
245
|
+
# end
|
246
|
+
#
|
208
247
|
def list_tag_values request, options = nil
|
209
248
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
210
249
|
|
@@ -270,6 +309,22 @@ module Google
|
|
270
309
|
# @return [::Google::Cloud::ResourceManager::V3::TagValue]
|
271
310
|
#
|
272
311
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
312
|
+
#
|
313
|
+
# @example Basic example
|
314
|
+
# require "google/cloud/resource_manager/v3"
|
315
|
+
#
|
316
|
+
# # Create a client object. The client can be reused for multiple calls.
|
317
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
318
|
+
#
|
319
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
320
|
+
# request = Google::Cloud::ResourceManager::V3::GetTagValueRequest.new
|
321
|
+
#
|
322
|
+
# # Call the get_tag_value method.
|
323
|
+
# result = client.get_tag_value request
|
324
|
+
#
|
325
|
+
# # The returned object is of type Google::Cloud::ResourceManager::V3::TagValue.
|
326
|
+
# p result
|
327
|
+
#
|
273
328
|
def get_tag_value request, options = nil
|
274
329
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
275
330
|
|
@@ -342,6 +397,22 @@ module Google
|
|
342
397
|
# @return [::Google::Cloud::ResourceManager::V3::TagValue]
|
343
398
|
#
|
344
399
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
400
|
+
#
|
401
|
+
# @example Basic example
|
402
|
+
# require "google/cloud/resource_manager/v3"
|
403
|
+
#
|
404
|
+
# # Create a client object. The client can be reused for multiple calls.
|
405
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
406
|
+
#
|
407
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
408
|
+
# request = Google::Cloud::ResourceManager::V3::GetNamespacedTagValueRequest.new
|
409
|
+
#
|
410
|
+
# # Call the get_namespaced_tag_value method.
|
411
|
+
# result = client.get_namespaced_tag_value request
|
412
|
+
#
|
413
|
+
# # The returned object is of type Google::Cloud::ResourceManager::V3::TagValue.
|
414
|
+
# p result
|
415
|
+
#
|
345
416
|
def get_namespaced_tag_value request, options = nil
|
346
417
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
347
418
|
|
@@ -411,6 +482,29 @@ module Google
|
|
411
482
|
# @return [::Gapic::Operation]
|
412
483
|
#
|
413
484
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
485
|
+
#
|
486
|
+
# @example Basic example
|
487
|
+
# require "google/cloud/resource_manager/v3"
|
488
|
+
#
|
489
|
+
# # Create a client object. The client can be reused for multiple calls.
|
490
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
491
|
+
#
|
492
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
493
|
+
# request = Google::Cloud::ResourceManager::V3::CreateTagValueRequest.new
|
494
|
+
#
|
495
|
+
# # Call the create_tag_value method.
|
496
|
+
# result = client.create_tag_value request
|
497
|
+
#
|
498
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
499
|
+
# # check the status of an operation, cancel it, or wait for results.
|
500
|
+
# # Here is how to wait for a response.
|
501
|
+
# result.wait_until_done! timeout: 60
|
502
|
+
# if result.response?
|
503
|
+
# p result.response
|
504
|
+
# else
|
505
|
+
# puts "No response received."
|
506
|
+
# end
|
507
|
+
#
|
414
508
|
def create_tag_value request, options = nil
|
415
509
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
416
510
|
|
@@ -482,6 +576,29 @@ module Google
|
|
482
576
|
# @return [::Gapic::Operation]
|
483
577
|
#
|
484
578
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
579
|
+
#
|
580
|
+
# @example Basic example
|
581
|
+
# require "google/cloud/resource_manager/v3"
|
582
|
+
#
|
583
|
+
# # Create a client object. The client can be reused for multiple calls.
|
584
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
585
|
+
#
|
586
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
587
|
+
# request = Google::Cloud::ResourceManager::V3::UpdateTagValueRequest.new
|
588
|
+
#
|
589
|
+
# # Call the update_tag_value method.
|
590
|
+
# result = client.update_tag_value request
|
591
|
+
#
|
592
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
593
|
+
# # check the status of an operation, cancel it, or wait for results.
|
594
|
+
# # Here is how to wait for a response.
|
595
|
+
# result.wait_until_done! timeout: 60
|
596
|
+
# if result.response?
|
597
|
+
# p result.response
|
598
|
+
# else
|
599
|
+
# puts "No response received."
|
600
|
+
# end
|
601
|
+
#
|
485
602
|
def update_tag_value request, options = nil
|
486
603
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
487
604
|
|
@@ -553,6 +670,29 @@ module Google
|
|
553
670
|
# @return [::Gapic::Operation]
|
554
671
|
#
|
555
672
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
673
|
+
#
|
674
|
+
# @example Basic example
|
675
|
+
# require "google/cloud/resource_manager/v3"
|
676
|
+
#
|
677
|
+
# # Create a client object. The client can be reused for multiple calls.
|
678
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
679
|
+
#
|
680
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
681
|
+
# request = Google::Cloud::ResourceManager::V3::DeleteTagValueRequest.new
|
682
|
+
#
|
683
|
+
# # Call the delete_tag_value method.
|
684
|
+
# result = client.delete_tag_value request
|
685
|
+
#
|
686
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
687
|
+
# # check the status of an operation, cancel it, or wait for results.
|
688
|
+
# # Here is how to wait for a response.
|
689
|
+
# result.wait_until_done! timeout: 60
|
690
|
+
# if result.response?
|
691
|
+
# p result.response
|
692
|
+
# else
|
693
|
+
# puts "No response received."
|
694
|
+
# end
|
695
|
+
#
|
556
696
|
def delete_tag_value request, options = nil
|
557
697
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
558
698
|
|
@@ -625,6 +765,22 @@ module Google
|
|
625
765
|
# @return [::Google::Iam::V1::Policy]
|
626
766
|
#
|
627
767
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
768
|
+
#
|
769
|
+
# @example Basic example
|
770
|
+
# require "google/cloud/resource_manager/v3"
|
771
|
+
#
|
772
|
+
# # Create a client object. The client can be reused for multiple calls.
|
773
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
774
|
+
#
|
775
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
776
|
+
# request = Google::Iam::V1::GetIamPolicyRequest.new
|
777
|
+
#
|
778
|
+
# # Call the get_iam_policy method.
|
779
|
+
# result = client.get_iam_policy request
|
780
|
+
#
|
781
|
+
# # The returned object is of type Google::Iam::V1::Policy.
|
782
|
+
# p result
|
783
|
+
#
|
628
784
|
def get_iam_policy request, options = nil
|
629
785
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
630
786
|
|
@@ -703,6 +859,22 @@ module Google
|
|
703
859
|
# @return [::Google::Iam::V1::Policy]
|
704
860
|
#
|
705
861
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
862
|
+
#
|
863
|
+
# @example Basic example
|
864
|
+
# require "google/cloud/resource_manager/v3"
|
865
|
+
#
|
866
|
+
# # Create a client object. The client can be reused for multiple calls.
|
867
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
868
|
+
#
|
869
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
870
|
+
# request = Google::Iam::V1::SetIamPolicyRequest.new
|
871
|
+
#
|
872
|
+
# # Call the set_iam_policy method.
|
873
|
+
# result = client.set_iam_policy request
|
874
|
+
#
|
875
|
+
# # The returned object is of type Google::Iam::V1::Policy.
|
876
|
+
# p result
|
877
|
+
#
|
706
878
|
def set_iam_policy request, options = nil
|
707
879
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
708
880
|
|
@@ -775,6 +947,22 @@ module Google
|
|
775
947
|
# @return [::Google::Iam::V1::TestIamPermissionsResponse]
|
776
948
|
#
|
777
949
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
950
|
+
#
|
951
|
+
# @example Basic example
|
952
|
+
# require "google/cloud/resource_manager/v3"
|
953
|
+
#
|
954
|
+
# # Create a client object. The client can be reused for multiple calls.
|
955
|
+
# client = Google::Cloud::ResourceManager::V3::TagValues::Rest::Client.new
|
956
|
+
#
|
957
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
958
|
+
# request = Google::Iam::V1::TestIamPermissionsRequest.new
|
959
|
+
#
|
960
|
+
# # Call the test_iam_permissions method.
|
961
|
+
# result = client.test_iam_permissions request
|
962
|
+
#
|
963
|
+
# # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
|
964
|
+
# p result
|
965
|
+
#
|
778
966
|
def test_iam_permissions request, options = nil
|
779
967
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
780
968
|
|
@@ -840,9 +1028,9 @@ module Google
|
|
840
1028
|
# end
|
841
1029
|
#
|
842
1030
|
# @!attribute [rw] endpoint
|
843
|
-
#
|
844
|
-
#
|
845
|
-
# @return [::String]
|
1031
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
1032
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
1033
|
+
# @return [::String,nil]
|
846
1034
|
# @!attribute [rw] credentials
|
847
1035
|
# Credentials to send with calls. You may provide any of the following types:
|
848
1036
|
# * (`String`) The path to a service account key file in JSON format
|
@@ -879,13 +1067,20 @@ module Google
|
|
879
1067
|
# @!attribute [rw] quota_project
|
880
1068
|
# A separate project against which to charge quota.
|
881
1069
|
# @return [::String]
|
1070
|
+
# @!attribute [rw] universe_domain
|
1071
|
+
# The universe domain within which to make requests. This determines the
|
1072
|
+
# default endpoint URL. The default value of nil uses the environment
|
1073
|
+
# universe (usually the default "googleapis.com" universe).
|
1074
|
+
# @return [::String,nil]
|
882
1075
|
#
|
883
1076
|
class Configuration
|
884
1077
|
extend ::Gapic::Config
|
885
1078
|
|
1079
|
+
# @private
|
1080
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
886
1081
|
DEFAULT_ENDPOINT = "cloudresourcemanager.googleapis.com"
|
887
1082
|
|
888
|
-
config_attr :endpoint,
|
1083
|
+
config_attr :endpoint, nil, ::String, nil
|
889
1084
|
config_attr :credentials, nil do |value|
|
890
1085
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
891
1086
|
allowed.any? { |klass| klass === value }
|
@@ -897,6 +1092,7 @@ module Google
|
|
897
1092
|
config_attr :metadata, nil, ::Hash, nil
|
898
1093
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
899
1094
|
config_attr :quota_project, nil, ::String, nil
|
1095
|
+
config_attr :universe_domain, nil, ::String, nil
|
900
1096
|
|
901
1097
|
# @private
|
902
1098
|
def initialize parent_config = nil
|
@@ -26,6 +26,9 @@ module Google
|
|
26
26
|
module Rest
|
27
27
|
# Service that implements Longrunning Operations API.
|
28
28
|
class Operations
|
29
|
+
# @private
|
30
|
+
DEFAULT_ENDPOINT_TEMPLATE = "cloudresourcemanager.$UNIVERSE_DOMAIN$"
|
31
|
+
|
29
32
|
# @private
|
30
33
|
attr_reader :operations_stub
|
31
34
|
|
@@ -60,6 +63,15 @@ module Google
|
|
60
63
|
@config
|
61
64
|
end
|
62
65
|
|
66
|
+
##
|
67
|
+
# The effective universe domain
|
68
|
+
#
|
69
|
+
# @return [String]
|
70
|
+
#
|
71
|
+
def universe_domain
|
72
|
+
@operations_stub.universe_domain
|
73
|
+
end
|
74
|
+
|
63
75
|
##
|
64
76
|
# Create a new Operations client object.
|
65
77
|
#
|
@@ -84,8 +96,10 @@ module Google
|
|
84
96
|
@quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
|
85
97
|
|
86
98
|
@operations_stub = OperationsServiceStub.new(
|
87
|
-
endpoint:
|
88
|
-
|
99
|
+
endpoint: @config.endpoint,
|
100
|
+
endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
|
101
|
+
universe_domain: @config.universe_domain,
|
102
|
+
credentials: credentials
|
89
103
|
)
|
90
104
|
|
91
105
|
# Used by an LRO wrapper for some methods of this service
|
@@ -136,6 +150,26 @@ module Google
|
|
136
150
|
# @return [::Gapic::Operation]
|
137
151
|
#
|
138
152
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
153
|
+
#
|
154
|
+
# @example Basic example
|
155
|
+
# require "google/longrunning"
|
156
|
+
#
|
157
|
+
# # Create a client object. The client can be reused for multiple calls.
|
158
|
+
# client = Google::Longrunning::Operations::Rest::Client.new
|
159
|
+
#
|
160
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
161
|
+
# request = Google::Longrunning::ListOperationsRequest.new
|
162
|
+
#
|
163
|
+
# # Call the list_operations method.
|
164
|
+
# result = client.list_operations request
|
165
|
+
#
|
166
|
+
# # The returned object is of type Gapic::PagedEnumerable. You can iterate
|
167
|
+
# # over elements, and API calls will be issued to fetch pages as needed.
|
168
|
+
# result.each do |item|
|
169
|
+
# # Each element is of type ::Google::Longrunning::Operation.
|
170
|
+
# p item
|
171
|
+
# end
|
172
|
+
#
|
139
173
|
def list_operations request, options = nil
|
140
174
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
141
175
|
|
@@ -201,6 +235,29 @@ module Google
|
|
201
235
|
# @return [::Gapic::Operation]
|
202
236
|
#
|
203
237
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
238
|
+
#
|
239
|
+
# @example Basic example
|
240
|
+
# require "google/longrunning"
|
241
|
+
#
|
242
|
+
# # Create a client object. The client can be reused for multiple calls.
|
243
|
+
# client = Google::Longrunning::Operations::Rest::Client.new
|
244
|
+
#
|
245
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
246
|
+
# request = Google::Longrunning::GetOperationRequest.new
|
247
|
+
#
|
248
|
+
# # Call the get_operation method.
|
249
|
+
# result = client.get_operation request
|
250
|
+
#
|
251
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
252
|
+
# # check the status of an operation, cancel it, or wait for results.
|
253
|
+
# # Here is how to wait for a response.
|
254
|
+
# result.wait_until_done! timeout: 60
|
255
|
+
# if result.response?
|
256
|
+
# p result.response
|
257
|
+
# else
|
258
|
+
# puts "No response received."
|
259
|
+
# end
|
260
|
+
#
|
204
261
|
def get_operation request, options = nil
|
205
262
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
206
263
|
|
@@ -267,6 +324,22 @@ module Google
|
|
267
324
|
# @return [::Google::Protobuf::Empty]
|
268
325
|
#
|
269
326
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
327
|
+
#
|
328
|
+
# @example Basic example
|
329
|
+
# require "google/longrunning"
|
330
|
+
#
|
331
|
+
# # Create a client object. The client can be reused for multiple calls.
|
332
|
+
# client = Google::Longrunning::Operations::Rest::Client.new
|
333
|
+
#
|
334
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
335
|
+
# request = Google::Longrunning::DeleteOperationRequest.new
|
336
|
+
#
|
337
|
+
# # Call the delete_operation method.
|
338
|
+
# result = client.delete_operation request
|
339
|
+
#
|
340
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
341
|
+
# p result
|
342
|
+
#
|
270
343
|
def delete_operation request, options = nil
|
271
344
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
272
345
|
|
@@ -338,6 +411,22 @@ module Google
|
|
338
411
|
# @return [::Google::Protobuf::Empty]
|
339
412
|
#
|
340
413
|
# @raise [::Google::Cloud::Error] if the REST call is aborted.
|
414
|
+
#
|
415
|
+
# @example Basic example
|
416
|
+
# require "google/longrunning"
|
417
|
+
#
|
418
|
+
# # Create a client object. The client can be reused for multiple calls.
|
419
|
+
# client = Google::Longrunning::Operations::Rest::Client.new
|
420
|
+
#
|
421
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
422
|
+
# request = Google::Longrunning::CancelOperationRequest.new
|
423
|
+
#
|
424
|
+
# # Call the cancel_operation method.
|
425
|
+
# result = client.cancel_operation request
|
426
|
+
#
|
427
|
+
# # The returned object is of type Google::Protobuf::Empty.
|
428
|
+
# p result
|
429
|
+
#
|
341
430
|
def cancel_operation request, options = nil
|
342
431
|
raise ::ArgumentError, "request must be provided" if request.nil?
|
343
432
|
|
@@ -403,9 +492,9 @@ module Google
|
|
403
492
|
# end
|
404
493
|
#
|
405
494
|
# @!attribute [rw] endpoint
|
406
|
-
#
|
407
|
-
#
|
408
|
-
# @return [::String]
|
495
|
+
# A custom service endpoint, as a hostname or hostname:port. The default is
|
496
|
+
# nil, indicating to use the default endpoint in the current universe domain.
|
497
|
+
# @return [::String,nil]
|
409
498
|
# @!attribute [rw] credentials
|
410
499
|
# Credentials to send with calls. You may provide any of the following types:
|
411
500
|
# * (`String`) The path to a service account key file in JSON format
|
@@ -442,13 +531,20 @@ module Google
|
|
442
531
|
# @!attribute [rw] quota_project
|
443
532
|
# A separate project against which to charge quota.
|
444
533
|
# @return [::String]
|
534
|
+
# @!attribute [rw] universe_domain
|
535
|
+
# The universe domain within which to make requests. This determines the
|
536
|
+
# default endpoint URL. The default value of nil uses the environment
|
537
|
+
# universe (usually the default "googleapis.com" universe).
|
538
|
+
# @return [::String,nil]
|
445
539
|
#
|
446
540
|
class Configuration
|
447
541
|
extend ::Gapic::Config
|
448
542
|
|
543
|
+
# @private
|
544
|
+
# The endpoint specific to the default "googleapis.com" universe. Deprecated.
|
449
545
|
DEFAULT_ENDPOINT = "cloudresourcemanager.googleapis.com"
|
450
546
|
|
451
|
-
config_attr :endpoint,
|
547
|
+
config_attr :endpoint, nil, ::String, nil
|
452
548
|
config_attr :credentials, nil do |value|
|
453
549
|
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
454
550
|
allowed.any? { |klass| klass === value }
|
@@ -460,6 +556,7 @@ module Google
|
|
460
556
|
config_attr :metadata, nil, ::Hash, nil
|
461
557
|
config_attr :retry_policy, nil, ::Hash, ::Proc, nil
|
462
558
|
config_attr :quota_project, nil, ::String, nil
|
559
|
+
config_attr :universe_domain, nil, ::String, nil
|
463
560
|
|
464
561
|
# @private
|
465
562
|
def initialize parent_config = nil
|
@@ -542,12 +639,15 @@ module Google
|
|
542
639
|
# Service stub contains baseline method implementations
|
543
640
|
# including transcoding, making the REST call, and deserialing the response.
|
544
641
|
class OperationsServiceStub
|
545
|
-
def initialize endpoint:, credentials:
|
642
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
|
546
643
|
# These require statements are intentionally placed here to initialize
|
547
644
|
# the REST modules only when it's required.
|
548
645
|
require "gapic/rest"
|
549
646
|
|
550
|
-
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
647
|
+
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
648
|
+
endpoint_template: endpoint_template,
|
649
|
+
universe_domain: universe_domain,
|
650
|
+
credentials: credentials
|
551
651
|
end
|
552
652
|
|
553
653
|
##
|
@@ -30,16 +30,28 @@ module Google
|
|
30
30
|
# including transcoding, making the REST call, and deserialing the response.
|
31
31
|
#
|
32
32
|
class ServiceStub
|
33
|
-
def initialize endpoint:, credentials:
|
33
|
+
def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
|
34
34
|
# These require statements are intentionally placed here to initialize
|
35
35
|
# the REST modules only when it's required.
|
36
36
|
require "gapic/rest"
|
37
37
|
|
38
|
-
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
38
|
+
@client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
|
39
|
+
endpoint_template: endpoint_template,
|
40
|
+
universe_domain: universe_domain,
|
41
|
+
credentials: credentials,
|
39
42
|
numeric_enums: true,
|
40
43
|
raise_faraday_errors: false
|
41
44
|
end
|
42
45
|
|
46
|
+
##
|
47
|
+
# The effective universe domain
|
48
|
+
#
|
49
|
+
# @return [String]
|
50
|
+
#
|
51
|
+
def universe_domain
|
52
|
+
@client_stub.universe_domain
|
53
|
+
end
|
54
|
+
|
43
55
|
##
|
44
56
|
# Baseline implementation for the list_tag_values REST call
|
45
57
|
#
|
@@ -21,6 +21,7 @@ module Google
|
|
21
21
|
module Api
|
22
22
|
# Required information for every language.
|
23
23
|
# @!attribute [rw] reference_docs_uri
|
24
|
+
# @deprecated This field is deprecated and may be removed in the next major version update.
|
24
25
|
# @return [::String]
|
25
26
|
# Link to automatically generated reference documentation. Example:
|
26
27
|
# https://cloud.google.com/nodejs/docs/reference/asset/latest
|
@@ -304,6 +305,19 @@ module Google
|
|
304
305
|
# seconds: 360 # 6 minutes
|
305
306
|
# total_poll_timeout:
|
306
307
|
# seconds: 54000 # 90 minutes
|
308
|
+
# @!attribute [rw] auto_populated_fields
|
309
|
+
# @return [::Array<::String>]
|
310
|
+
# List of top-level fields of the request message, that should be
|
311
|
+
# automatically populated by the client libraries based on their
|
312
|
+
# (google.api.field_info).format. Currently supported format: UUID4.
|
313
|
+
#
|
314
|
+
# Example of a YAML configuration:
|
315
|
+
#
|
316
|
+
# publishing:
|
317
|
+
# method_settings:
|
318
|
+
# - selector: google.example.v1.ExampleService.CreateExample
|
319
|
+
# auto_populated_fields:
|
320
|
+
# - request_id
|
307
321
|
class MethodSettings
|
308
322
|
include ::Google::Protobuf::MessageExts
|
309
323
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -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
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-resource_manager-v3
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.8.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:
|
11
|
+
date: 2024-01-11 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.21.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.21.1
|
30
30
|
- - "<"
|
31
31
|
- !ruby/object:Gem::Version
|
32
32
|
version: 2.a
|
@@ -308,7 +308,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
308
308
|
- !ruby/object:Gem::Version
|
309
309
|
version: '0'
|
310
310
|
requirements: []
|
311
|
-
rubygems_version: 3.
|
311
|
+
rubygems_version: 3.5.3
|
312
312
|
signing_key:
|
313
313
|
specification_version: 4
|
314
314
|
summary: Creates, reads, and updates metadata for Google Cloud Platform resource containers.
|