google-cloud-org_policy-v2 0.4.0 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,565 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/orgpolicy/v2/orgpolicy_pb"
20
+
21
+ module Google
22
+ module Cloud
23
+ module OrgPolicy
24
+ module V2
25
+ module OrgPolicy
26
+ module Rest
27
+ ##
28
+ # REST service stub for the OrgPolicy service.
29
+ # Service stub contains baseline method implementations
30
+ # including transcoding, making the REST call, and deserialing the response.
31
+ #
32
+ class ServiceStub
33
+ def initialize endpoint:, credentials:
34
+ # These require statements are intentionally placed here to initialize
35
+ # the REST modules only when it's required.
36
+ require "gapic/rest"
37
+
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
39
+ numeric_enums: true,
40
+ raise_faraday_errors: false
41
+ end
42
+
43
+ ##
44
+ # Baseline implementation for the list_constraints REST call
45
+ #
46
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::ListConstraintsRequest]
47
+ # A request object representing the call parameters. Required.
48
+ # @param options [::Gapic::CallOptions]
49
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
50
+ #
51
+ # @yield [result, operation] Access the result along with the TransportOperation object
52
+ # @yieldparam result [::Google::Cloud::OrgPolicy::V2::ListConstraintsResponse]
53
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
54
+ #
55
+ # @return [::Google::Cloud::OrgPolicy::V2::ListConstraintsResponse]
56
+ # A result object deserialized from the server's reply
57
+ def list_constraints request_pb, options = nil
58
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
59
+
60
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_constraints_request request_pb
61
+ query_string_params = if query_string_params.any?
62
+ query_string_params.to_h { |p| p.split("=", 2) }
63
+ else
64
+ {}
65
+ end
66
+
67
+ response = @client_stub.make_http_request(
68
+ verb,
69
+ uri: uri,
70
+ body: body || "",
71
+ params: query_string_params,
72
+ options: options
73
+ )
74
+ operation = ::Gapic::Rest::TransportOperation.new response
75
+ result = ::Google::Cloud::OrgPolicy::V2::ListConstraintsResponse.decode_json response.body, ignore_unknown_fields: true
76
+
77
+ yield result, operation if block_given?
78
+ result
79
+ end
80
+
81
+ ##
82
+ # Baseline implementation for the list_policies REST call
83
+ #
84
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::ListPoliciesRequest]
85
+ # A request object representing the call parameters. Required.
86
+ # @param options [::Gapic::CallOptions]
87
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
88
+ #
89
+ # @yield [result, operation] Access the result along with the TransportOperation object
90
+ # @yieldparam result [::Google::Cloud::OrgPolicy::V2::ListPoliciesResponse]
91
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
92
+ #
93
+ # @return [::Google::Cloud::OrgPolicy::V2::ListPoliciesResponse]
94
+ # A result object deserialized from the server's reply
95
+ def list_policies request_pb, options = nil
96
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
97
+
98
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_policies_request request_pb
99
+ query_string_params = if query_string_params.any?
100
+ query_string_params.to_h { |p| p.split("=", 2) }
101
+ else
102
+ {}
103
+ end
104
+
105
+ response = @client_stub.make_http_request(
106
+ verb,
107
+ uri: uri,
108
+ body: body || "",
109
+ params: query_string_params,
110
+ options: options
111
+ )
112
+ operation = ::Gapic::Rest::TransportOperation.new response
113
+ result = ::Google::Cloud::OrgPolicy::V2::ListPoliciesResponse.decode_json response.body, ignore_unknown_fields: true
114
+
115
+ yield result, operation if block_given?
116
+ result
117
+ end
118
+
119
+ ##
120
+ # Baseline implementation for the get_policy REST call
121
+ #
122
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::GetPolicyRequest]
123
+ # A request object representing the call parameters. Required.
124
+ # @param options [::Gapic::CallOptions]
125
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
126
+ #
127
+ # @yield [result, operation] Access the result along with the TransportOperation object
128
+ # @yieldparam result [::Google::Cloud::OrgPolicy::V2::Policy]
129
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
130
+ #
131
+ # @return [::Google::Cloud::OrgPolicy::V2::Policy]
132
+ # A result object deserialized from the server's reply
133
+ def get_policy request_pb, options = nil
134
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
135
+
136
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_policy_request request_pb
137
+ query_string_params = if query_string_params.any?
138
+ query_string_params.to_h { |p| p.split("=", 2) }
139
+ else
140
+ {}
141
+ end
142
+
143
+ response = @client_stub.make_http_request(
144
+ verb,
145
+ uri: uri,
146
+ body: body || "",
147
+ params: query_string_params,
148
+ options: options
149
+ )
150
+ operation = ::Gapic::Rest::TransportOperation.new response
151
+ result = ::Google::Cloud::OrgPolicy::V2::Policy.decode_json response.body, ignore_unknown_fields: true
152
+
153
+ yield result, operation if block_given?
154
+ result
155
+ end
156
+
157
+ ##
158
+ # Baseline implementation for the get_effective_policy REST call
159
+ #
160
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::GetEffectivePolicyRequest]
161
+ # A request object representing the call parameters. Required.
162
+ # @param options [::Gapic::CallOptions]
163
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
164
+ #
165
+ # @yield [result, operation] Access the result along with the TransportOperation object
166
+ # @yieldparam result [::Google::Cloud::OrgPolicy::V2::Policy]
167
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
168
+ #
169
+ # @return [::Google::Cloud::OrgPolicy::V2::Policy]
170
+ # A result object deserialized from the server's reply
171
+ def get_effective_policy request_pb, options = nil
172
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
173
+
174
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_effective_policy_request request_pb
175
+ query_string_params = if query_string_params.any?
176
+ query_string_params.to_h { |p| p.split("=", 2) }
177
+ else
178
+ {}
179
+ end
180
+
181
+ response = @client_stub.make_http_request(
182
+ verb,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ options: options
187
+ )
188
+ operation = ::Gapic::Rest::TransportOperation.new response
189
+ result = ::Google::Cloud::OrgPolicy::V2::Policy.decode_json response.body, ignore_unknown_fields: true
190
+
191
+ yield result, operation if block_given?
192
+ result
193
+ end
194
+
195
+ ##
196
+ # Baseline implementation for the create_policy REST call
197
+ #
198
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::CreatePolicyRequest]
199
+ # A request object representing the call parameters. Required.
200
+ # @param options [::Gapic::CallOptions]
201
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
202
+ #
203
+ # @yield [result, operation] Access the result along with the TransportOperation object
204
+ # @yieldparam result [::Google::Cloud::OrgPolicy::V2::Policy]
205
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
206
+ #
207
+ # @return [::Google::Cloud::OrgPolicy::V2::Policy]
208
+ # A result object deserialized from the server's reply
209
+ def create_policy request_pb, options = nil
210
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
211
+
212
+ verb, uri, query_string_params, body = ServiceStub.transcode_create_policy_request request_pb
213
+ query_string_params = if query_string_params.any?
214
+ query_string_params.to_h { |p| p.split("=", 2) }
215
+ else
216
+ {}
217
+ end
218
+
219
+ response = @client_stub.make_http_request(
220
+ verb,
221
+ uri: uri,
222
+ body: body || "",
223
+ params: query_string_params,
224
+ options: options
225
+ )
226
+ operation = ::Gapic::Rest::TransportOperation.new response
227
+ result = ::Google::Cloud::OrgPolicy::V2::Policy.decode_json response.body, ignore_unknown_fields: true
228
+
229
+ yield result, operation if block_given?
230
+ result
231
+ end
232
+
233
+ ##
234
+ # Baseline implementation for the update_policy REST call
235
+ #
236
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::UpdatePolicyRequest]
237
+ # A request object representing the call parameters. Required.
238
+ # @param options [::Gapic::CallOptions]
239
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
240
+ #
241
+ # @yield [result, operation] Access the result along with the TransportOperation object
242
+ # @yieldparam result [::Google::Cloud::OrgPolicy::V2::Policy]
243
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
244
+ #
245
+ # @return [::Google::Cloud::OrgPolicy::V2::Policy]
246
+ # A result object deserialized from the server's reply
247
+ def update_policy request_pb, options = nil
248
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
249
+
250
+ verb, uri, query_string_params, body = ServiceStub.transcode_update_policy_request request_pb
251
+ query_string_params = if query_string_params.any?
252
+ query_string_params.to_h { |p| p.split("=", 2) }
253
+ else
254
+ {}
255
+ end
256
+
257
+ response = @client_stub.make_http_request(
258
+ verb,
259
+ uri: uri,
260
+ body: body || "",
261
+ params: query_string_params,
262
+ options: options
263
+ )
264
+ operation = ::Gapic::Rest::TransportOperation.new response
265
+ result = ::Google::Cloud::OrgPolicy::V2::Policy.decode_json response.body, ignore_unknown_fields: true
266
+
267
+ yield result, operation if block_given?
268
+ result
269
+ end
270
+
271
+ ##
272
+ # Baseline implementation for the delete_policy REST call
273
+ #
274
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::DeletePolicyRequest]
275
+ # A request object representing the call parameters. Required.
276
+ # @param options [::Gapic::CallOptions]
277
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
278
+ #
279
+ # @yield [result, operation] Access the result along with the TransportOperation object
280
+ # @yieldparam result [::Google::Protobuf::Empty]
281
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
282
+ #
283
+ # @return [::Google::Protobuf::Empty]
284
+ # A result object deserialized from the server's reply
285
+ def delete_policy request_pb, options = nil
286
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
287
+
288
+ verb, uri, query_string_params, body = ServiceStub.transcode_delete_policy_request request_pb
289
+ query_string_params = if query_string_params.any?
290
+ query_string_params.to_h { |p| p.split("=", 2) }
291
+ else
292
+ {}
293
+ end
294
+
295
+ response = @client_stub.make_http_request(
296
+ verb,
297
+ uri: uri,
298
+ body: body || "",
299
+ params: query_string_params,
300
+ options: options
301
+ )
302
+ operation = ::Gapic::Rest::TransportOperation.new response
303
+ result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
304
+
305
+ yield result, operation if block_given?
306
+ result
307
+ end
308
+
309
+ ##
310
+ # @private
311
+ #
312
+ # GRPC transcoding helper method for the list_constraints REST call
313
+ #
314
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::ListConstraintsRequest]
315
+ # A request object representing the call parameters. Required.
316
+ # @return [Array(String, [String, nil], Hash{String => String})]
317
+ # Uri, Body, Query string parameters
318
+ def self.transcode_list_constraints_request request_pb
319
+ transcoder = Gapic::Rest::GrpcTranscoder.new
320
+ .with_bindings(
321
+ uri_method: :get,
322
+ uri_template: "/v2/{parent}/constraints",
323
+ matches: [
324
+ ["parent", %r{^projects/[^/]+/?$}, false]
325
+ ]
326
+ )
327
+ .with_bindings(
328
+ uri_method: :get,
329
+ uri_template: "/v2/{parent}/constraints",
330
+ matches: [
331
+ ["parent", %r{^folders/[^/]+/?$}, false]
332
+ ]
333
+ )
334
+ .with_bindings(
335
+ uri_method: :get,
336
+ uri_template: "/v2/{parent}/constraints",
337
+ matches: [
338
+ ["parent", %r{^organizations/[^/]+/?$}, false]
339
+ ]
340
+ )
341
+ transcoder.transcode request_pb
342
+ end
343
+
344
+ ##
345
+ # @private
346
+ #
347
+ # GRPC transcoding helper method for the list_policies REST call
348
+ #
349
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::ListPoliciesRequest]
350
+ # A request object representing the call parameters. Required.
351
+ # @return [Array(String, [String, nil], Hash{String => String})]
352
+ # Uri, Body, Query string parameters
353
+ def self.transcode_list_policies_request request_pb
354
+ transcoder = Gapic::Rest::GrpcTranscoder.new
355
+ .with_bindings(
356
+ uri_method: :get,
357
+ uri_template: "/v2/{parent}/policies",
358
+ matches: [
359
+ ["parent", %r{^projects/[^/]+/?$}, false]
360
+ ]
361
+ )
362
+ .with_bindings(
363
+ uri_method: :get,
364
+ uri_template: "/v2/{parent}/policies",
365
+ matches: [
366
+ ["parent", %r{^folders/[^/]+/?$}, false]
367
+ ]
368
+ )
369
+ .with_bindings(
370
+ uri_method: :get,
371
+ uri_template: "/v2/{parent}/policies",
372
+ matches: [
373
+ ["parent", %r{^organizations/[^/]+/?$}, false]
374
+ ]
375
+ )
376
+ transcoder.transcode request_pb
377
+ end
378
+
379
+ ##
380
+ # @private
381
+ #
382
+ # GRPC transcoding helper method for the get_policy REST call
383
+ #
384
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::GetPolicyRequest]
385
+ # A request object representing the call parameters. Required.
386
+ # @return [Array(String, [String, nil], Hash{String => String})]
387
+ # Uri, Body, Query string parameters
388
+ def self.transcode_get_policy_request request_pb
389
+ transcoder = Gapic::Rest::GrpcTranscoder.new
390
+ .with_bindings(
391
+ uri_method: :get,
392
+ uri_template: "/v2/{name}",
393
+ matches: [
394
+ ["name", %r{^projects/[^/]+/policies/[^/]+/?$}, false]
395
+ ]
396
+ )
397
+ .with_bindings(
398
+ uri_method: :get,
399
+ uri_template: "/v2/{name}",
400
+ matches: [
401
+ ["name", %r{^folders/[^/]+/policies/[^/]+/?$}, false]
402
+ ]
403
+ )
404
+ .with_bindings(
405
+ uri_method: :get,
406
+ uri_template: "/v2/{name}",
407
+ matches: [
408
+ ["name", %r{^organizations/[^/]+/policies/[^/]+/?$}, false]
409
+ ]
410
+ )
411
+ transcoder.transcode request_pb
412
+ end
413
+
414
+ ##
415
+ # @private
416
+ #
417
+ # GRPC transcoding helper method for the get_effective_policy REST call
418
+ #
419
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::GetEffectivePolicyRequest]
420
+ # A request object representing the call parameters. Required.
421
+ # @return [Array(String, [String, nil], Hash{String => String})]
422
+ # Uri, Body, Query string parameters
423
+ def self.transcode_get_effective_policy_request request_pb
424
+ transcoder = Gapic::Rest::GrpcTranscoder.new
425
+ .with_bindings(
426
+ uri_method: :get,
427
+ uri_template: "/v2/{name}:getEffectivePolicy",
428
+ matches: [
429
+ ["name", %r{^projects/[^/]+/policies/[^/]+/?$}, false]
430
+ ]
431
+ )
432
+ .with_bindings(
433
+ uri_method: :get,
434
+ uri_template: "/v2/{name}:getEffectivePolicy",
435
+ matches: [
436
+ ["name", %r{^folders/[^/]+/policies/[^/]+/?$}, false]
437
+ ]
438
+ )
439
+ .with_bindings(
440
+ uri_method: :get,
441
+ uri_template: "/v2/{name}:getEffectivePolicy",
442
+ matches: [
443
+ ["name", %r{^organizations/[^/]+/policies/[^/]+/?$}, false]
444
+ ]
445
+ )
446
+ transcoder.transcode request_pb
447
+ end
448
+
449
+ ##
450
+ # @private
451
+ #
452
+ # GRPC transcoding helper method for the create_policy REST call
453
+ #
454
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::CreatePolicyRequest]
455
+ # A request object representing the call parameters. Required.
456
+ # @return [Array(String, [String, nil], Hash{String => String})]
457
+ # Uri, Body, Query string parameters
458
+ def self.transcode_create_policy_request request_pb
459
+ transcoder = Gapic::Rest::GrpcTranscoder.new
460
+ .with_bindings(
461
+ uri_method: :post,
462
+ uri_template: "/v2/{parent}/policies",
463
+ body: "policy",
464
+ matches: [
465
+ ["parent", %r{^projects/[^/]+/?$}, false]
466
+ ]
467
+ )
468
+ .with_bindings(
469
+ uri_method: :post,
470
+ uri_template: "/v2/{parent}/policies",
471
+ body: "policy",
472
+ matches: [
473
+ ["parent", %r{^folders/[^/]+/?$}, false]
474
+ ]
475
+ )
476
+ .with_bindings(
477
+ uri_method: :post,
478
+ uri_template: "/v2/{parent}/policies",
479
+ body: "policy",
480
+ matches: [
481
+ ["parent", %r{^organizations/[^/]+/?$}, false]
482
+ ]
483
+ )
484
+ transcoder.transcode request_pb
485
+ end
486
+
487
+ ##
488
+ # @private
489
+ #
490
+ # GRPC transcoding helper method for the update_policy REST call
491
+ #
492
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::UpdatePolicyRequest]
493
+ # A request object representing the call parameters. Required.
494
+ # @return [Array(String, [String, nil], Hash{String => String})]
495
+ # Uri, Body, Query string parameters
496
+ def self.transcode_update_policy_request request_pb
497
+ transcoder = Gapic::Rest::GrpcTranscoder.new
498
+ .with_bindings(
499
+ uri_method: :patch,
500
+ uri_template: "/v2/{policy.name}",
501
+ body: "policy",
502
+ matches: [
503
+ ["policy.name", %r{^projects/[^/]+/policies/[^/]+/?$}, false]
504
+ ]
505
+ )
506
+ .with_bindings(
507
+ uri_method: :patch,
508
+ uri_template: "/v2/{policy.name}",
509
+ body: "policy",
510
+ matches: [
511
+ ["policy.name", %r{^folders/[^/]+/policies/[^/]+/?$}, false]
512
+ ]
513
+ )
514
+ .with_bindings(
515
+ uri_method: :patch,
516
+ uri_template: "/v2/{policy.name}",
517
+ body: "policy",
518
+ matches: [
519
+ ["policy.name", %r{^organizations/[^/]+/policies/[^/]+/?$}, false]
520
+ ]
521
+ )
522
+ transcoder.transcode request_pb
523
+ end
524
+
525
+ ##
526
+ # @private
527
+ #
528
+ # GRPC transcoding helper method for the delete_policy REST call
529
+ #
530
+ # @param request_pb [::Google::Cloud::OrgPolicy::V2::DeletePolicyRequest]
531
+ # A request object representing the call parameters. Required.
532
+ # @return [Array(String, [String, nil], Hash{String => String})]
533
+ # Uri, Body, Query string parameters
534
+ def self.transcode_delete_policy_request request_pb
535
+ transcoder = Gapic::Rest::GrpcTranscoder.new
536
+ .with_bindings(
537
+ uri_method: :delete,
538
+ uri_template: "/v2/{name}",
539
+ matches: [
540
+ ["name", %r{^projects/[^/]+/policies/[^/]+/?$}, false]
541
+ ]
542
+ )
543
+ .with_bindings(
544
+ uri_method: :delete,
545
+ uri_template: "/v2/{name}",
546
+ matches: [
547
+ ["name", %r{^folders/[^/]+/policies/[^/]+/?$}, false]
548
+ ]
549
+ )
550
+ .with_bindings(
551
+ uri_method: :delete,
552
+ uri_template: "/v2/{name}",
553
+ matches: [
554
+ ["name", %r{^organizations/[^/]+/policies/[^/]+/?$}, false]
555
+ ]
556
+ )
557
+ transcoder.transcode request_pb
558
+ end
559
+ end
560
+ end
561
+ end
562
+ end
563
+ end
564
+ end
565
+ end
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/rest"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/org_policy/v2/version"
24
+
25
+ require "google/cloud/org_policy/v2/org_policy/credentials"
26
+ require "google/cloud/org_policy/v2/org_policy/paths"
27
+ require "google/cloud/org_policy/v2/org_policy/rest/client"
28
+
29
+ module Google
30
+ module Cloud
31
+ module OrgPolicy
32
+ module V2
33
+ ##
34
+ # An interface for managing organization policies.
35
+ #
36
+ # The Cloud Org Policy service provides a simple mechanism for organizations to
37
+ # restrict the allowed configurations across their entire Cloud Resource
38
+ # hierarchy.
39
+ #
40
+ # You can use a `policy` to configure restrictions in Cloud resources. For
41
+ # example, you can enforce a `policy` that restricts which Google
42
+ # Cloud Platform APIs can be activated in a certain part of your resource
43
+ # hierarchy, or prevents serial port access to VM instances in a particular
44
+ # folder.
45
+ #
46
+ # `Policies` are inherited down through the resource hierarchy. A `policy`
47
+ # applied to a parent resource automatically applies to all its child resources
48
+ # unless overridden with a `policy` lower in the hierarchy.
49
+ #
50
+ # A `constraint` defines an aspect of a resource's configuration that can be
51
+ # controlled by an organization's policy administrator. `Policies` are a
52
+ # collection of `constraints` that defines their allowable configuration on a
53
+ # particular resource and its child resources.
54
+ #
55
+ # To load this service and instantiate a REST client:
56
+ #
57
+ # require "google/cloud/org_policy/v2/org_policy/rest"
58
+ # client = ::Google::Cloud::OrgPolicy::V2::OrgPolicy::Rest::Client.new
59
+ #
60
+ module OrgPolicy
61
+ # Client for the REST transport
62
+ module Rest
63
+ end
64
+ end
65
+ end
66
+ end
67
+ end
68
+ end
69
+
70
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
71
+ require "google/cloud/org_policy/v2/org_policy/rest/helpers" if ::File.file? helper_path
@@ -25,6 +25,7 @@ require "google/cloud/org_policy/v2/version"
25
25
  require "google/cloud/org_policy/v2/org_policy/credentials"
26
26
  require "google/cloud/org_policy/v2/org_policy/paths"
27
27
  require "google/cloud/org_policy/v2/org_policy/client"
28
+ require "google/cloud/org_policy/v2/org_policy/rest"
28
29
 
29
30
  module Google
30
31
  module Cloud
@@ -57,6 +58,11 @@ module Google
57
58
  # require "google/cloud/org_policy/v2/org_policy"
58
59
  # client = ::Google::Cloud::OrgPolicy::V2::OrgPolicy::Client.new
59
60
  #
61
+ # @example Load this service and instantiate a REST client
62
+ #
63
+ # require "google/cloud/org_policy/v2/org_policy/rest"
64
+ # client = ::Google::Cloud::OrgPolicy::V2::OrgPolicy::Rest::Client.new
65
+ #
60
66
  module OrgPolicy
61
67
  end
62
68
  end