google-cloud-org_policy-v2 0.4.0 → 0.5.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.
@@ -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