google-cloud-os_config-v1alpha 0.5.0 → 0.7.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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9c295a20e69bc3d643e6b86d4cffc5e85871bbf626932c545dc45a82a415ba16
4
- data.tar.gz: c97319603d7c8d9357237a654f69f903d91afb663998d15ec02e553a42e8c578
3
+ metadata.gz: 580a69d08f49e600cbb665015764f7cd8bd0aae1335f74afbc0dd1c69917d7ab
4
+ data.tar.gz: 5b096cdee08c96502d56e7eb0cfb1f4bb111596c29fd6567859022df14229887
5
5
  SHA512:
6
- metadata.gz: fbf3e79aff7aa38556be4d3005434696211fcc7e0b971890f95fa6e62ef881adcddaebe922d69bff6152c049a3473b63e2335cc170b518fc813d5477779c5b8e
7
- data.tar.gz: 24c92a9f52f63b2f9ec1e52f79f11bb81aee86e57b2a38181fcd5d0c553f53f678aa117b91e7aa670b6fd67e59585a19c2b6992b0283dd31a05b6ddca13f9bdb
6
+ metadata.gz: 14f25ab42ba6ae9c5c80d74406d0996d7e5217a3aec316007d547df140e6a15192310b2c17a58246b5415a01588918dcb2110afadebec6bb1917af6ad079cead
7
+ data.tar.gz: 5f893370a9eb6f11a28b4dba61dd6b2a7a82ef22906d91a23559aa64109b8d089f272beff498a38fc3967bbae06d1661824dffc54bcd1943236ae305ff2bed1c
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://googleapis.dev/ruby/google-cloud-logging/latest)
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
 
@@ -131,7 +131,7 @@ module Google
131
131
  credentials = @config.credentials
132
132
  # Use self-signed JWT if the endpoint is unchanged from default,
133
133
  # but only if the default endpoint does not have a region prefix.
134
- enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
134
+ enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
135
135
  !@config.endpoint.split(".").first.include?("-")
136
136
  credentials ||= Credentials.default scope: @config.scope,
137
137
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -152,7 +152,8 @@ module Google
152
152
  credentials: credentials,
153
153
  endpoint: @config.endpoint,
154
154
  channel_args: @config.channel_args,
155
- interceptors: @config.interceptors
155
+ interceptors: @config.interceptors,
156
+ channel_pool_config: @config.channel_pool
156
157
  )
157
158
  end
158
159
 
@@ -1624,9 +1625,9 @@ module Google
1624
1625
  # * (`String`) The path to a service account key file in JSON format
1625
1626
  # * (`Hash`) A service account key as a Hash
1626
1627
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1627
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1628
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1628
1629
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1629
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1630
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1630
1631
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1631
1632
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1632
1633
  # * (`nil`) indicating no credentials
@@ -1668,7 +1669,9 @@ module Google
1668
1669
  class Configuration
1669
1670
  extend ::Gapic::Config
1670
1671
 
1671
- config_attr :endpoint, "osconfig.googleapis.com", ::String
1672
+ DEFAULT_ENDPOINT = "osconfig.googleapis.com"
1673
+
1674
+ config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1672
1675
  config_attr :credentials, nil do |value|
1673
1676
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1674
1677
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -1703,6 +1706,14 @@ module Google
1703
1706
  end
1704
1707
  end
1705
1708
 
1709
+ ##
1710
+ # Configuration for the channel pool
1711
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
1712
+ #
1713
+ def channel_pool
1714
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
1715
+ end
1716
+
1706
1717
  ##
1707
1718
  # Configuration RPC class for the OsConfigZonalService API.
1708
1719
  #
@@ -93,7 +93,8 @@ module Google
93
93
  credentials: credentials,
94
94
  endpoint: @config.endpoint,
95
95
  channel_args: @config.channel_args,
96
- interceptors: @config.interceptors
96
+ interceptors: @config.interceptors,
97
+ channel_pool_config: @config.channel_pool
97
98
  )
98
99
 
99
100
  # Used by an LRO wrapper for some methods of this service
@@ -620,9 +621,9 @@ module Google
620
621
  # * (`String`) The path to a service account key file in JSON format
621
622
  # * (`Hash`) A service account key as a Hash
622
623
  # * (`Google::Auth::Credentials`) A googleauth credentials object
623
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
624
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
624
625
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
625
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
626
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
626
627
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
627
628
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
628
629
  # * (`nil`) indicating no credentials
@@ -664,7 +665,9 @@ module Google
664
665
  class Configuration
665
666
  extend ::Gapic::Config
666
667
 
667
- config_attr :endpoint, "osconfig.googleapis.com", ::String
668
+ DEFAULT_ENDPOINT = "osconfig.googleapis.com"
669
+
670
+ config_attr :endpoint, DEFAULT_ENDPOINT, ::String
668
671
  config_attr :credentials, nil do |value|
669
672
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
670
673
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -699,6 +702,14 @@ module Google
699
702
  end
700
703
  end
701
704
 
705
+ ##
706
+ # Configuration for the channel pool
707
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
708
+ #
709
+ def channel_pool
710
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
711
+ end
712
+
702
713
  ##
703
714
  # Configuration RPC class for the Operations API.
704
715
  #
@@ -127,7 +127,7 @@ module Google
127
127
  credentials = @config.credentials
128
128
  # Use self-signed JWT if the endpoint is unchanged from default,
129
129
  # but only if the default endpoint does not have a region prefix.
130
- enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
130
+ enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
131
131
  !@config.endpoint.split(".").first.include?("-")
132
132
  credentials ||= Credentials.default scope: @config.scope,
133
133
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -203,6 +203,29 @@ module Google
203
203
  # @return [::Gapic::Operation]
204
204
  #
205
205
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
206
+ #
207
+ # @example Basic example
208
+ # require "google/cloud/os_config/v1alpha"
209
+ #
210
+ # # Create a client object. The client can be reused for multiple calls.
211
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
212
+ #
213
+ # # Create a request. To set request fields, pass in keyword arguments.
214
+ # request = Google::Cloud::OsConfig::V1alpha::CreateOSPolicyAssignmentRequest.new
215
+ #
216
+ # # Call the create_os_policy_assignment method.
217
+ # result = client.create_os_policy_assignment request
218
+ #
219
+ # # The returned object is of type Gapic::Operation. You can use it to
220
+ # # check the status of an operation, cancel it, or wait for results.
221
+ # # Here is how to wait for a response.
222
+ # result.wait_until_done! timeout: 60
223
+ # if result.response?
224
+ # p result.response
225
+ # else
226
+ # puts "No response received."
227
+ # end
228
+ #
206
229
  def create_os_policy_assignment request, options = nil
207
230
  raise ::ArgumentError, "request must be provided" if request.nil?
208
231
 
@@ -276,6 +299,29 @@ module Google
276
299
  # @return [::Gapic::Operation]
277
300
  #
278
301
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
302
+ #
303
+ # @example Basic example
304
+ # require "google/cloud/os_config/v1alpha"
305
+ #
306
+ # # Create a client object. The client can be reused for multiple calls.
307
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
308
+ #
309
+ # # Create a request. To set request fields, pass in keyword arguments.
310
+ # request = Google::Cloud::OsConfig::V1alpha::UpdateOSPolicyAssignmentRequest.new
311
+ #
312
+ # # Call the update_os_policy_assignment method.
313
+ # result = client.update_os_policy_assignment request
314
+ #
315
+ # # The returned object is of type Gapic::Operation. You can use it to
316
+ # # check the status of an operation, cancel it, or wait for results.
317
+ # # Here is how to wait for a response.
318
+ # result.wait_until_done! timeout: 60
319
+ # if result.response?
320
+ # p result.response
321
+ # else
322
+ # puts "No response received."
323
+ # end
324
+ #
279
325
  def update_os_policy_assignment request, options = nil
280
326
  raise ::ArgumentError, "request must be provided" if request.nil?
281
327
 
@@ -346,6 +392,22 @@ module Google
346
392
  # @return [::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignment]
347
393
  #
348
394
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
395
+ #
396
+ # @example Basic example
397
+ # require "google/cloud/os_config/v1alpha"
398
+ #
399
+ # # Create a client object. The client can be reused for multiple calls.
400
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
401
+ #
402
+ # # Create a request. To set request fields, pass in keyword arguments.
403
+ # request = Google::Cloud::OsConfig::V1alpha::GetOSPolicyAssignmentRequest.new
404
+ #
405
+ # # Call the get_os_policy_assignment method.
406
+ # result = client.get_os_policy_assignment request
407
+ #
408
+ # # The returned object is of type Google::Cloud::OsConfig::V1alpha::OSPolicyAssignment.
409
+ # p result
410
+ #
349
411
  def get_os_policy_assignment request, options = nil
350
412
  raise ::ArgumentError, "request must be provided" if request.nil?
351
413
 
@@ -416,6 +478,26 @@ module Google
416
478
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignment>]
417
479
  #
418
480
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
481
+ #
482
+ # @example Basic example
483
+ # require "google/cloud/os_config/v1alpha"
484
+ #
485
+ # # Create a client object. The client can be reused for multiple calls.
486
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
487
+ #
488
+ # # Create a request. To set request fields, pass in keyword arguments.
489
+ # request = Google::Cloud::OsConfig::V1alpha::ListOSPolicyAssignmentsRequest.new
490
+ #
491
+ # # Call the list_os_policy_assignments method.
492
+ # result = client.list_os_policy_assignments request
493
+ #
494
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
495
+ # # over elements, and API calls will be issued to fetch pages as needed.
496
+ # result.each do |item|
497
+ # # Each element is of type ::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignment.
498
+ # p item
499
+ # end
500
+ #
419
501
  def list_os_policy_assignments request, options = nil
420
502
  raise ::ArgumentError, "request must be provided" if request.nil?
421
503
 
@@ -485,6 +567,26 @@ module Google
485
567
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignment>]
486
568
  #
487
569
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
570
+ #
571
+ # @example Basic example
572
+ # require "google/cloud/os_config/v1alpha"
573
+ #
574
+ # # Create a client object. The client can be reused for multiple calls.
575
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
576
+ #
577
+ # # Create a request. To set request fields, pass in keyword arguments.
578
+ # request = Google::Cloud::OsConfig::V1alpha::ListOSPolicyAssignmentRevisionsRequest.new
579
+ #
580
+ # # Call the list_os_policy_assignment_revisions method.
581
+ # result = client.list_os_policy_assignment_revisions request
582
+ #
583
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
584
+ # # over elements, and API calls will be issued to fetch pages as needed.
585
+ # result.each do |item|
586
+ # # Each element is of type ::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignment.
587
+ # p item
588
+ # end
589
+ #
488
590
  def list_os_policy_assignment_revisions request, options = nil
489
591
  raise ::ArgumentError, "request must be provided" if request.nil?
490
592
 
@@ -559,6 +661,29 @@ module Google
559
661
  # @return [::Gapic::Operation]
560
662
  #
561
663
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
664
+ #
665
+ # @example Basic example
666
+ # require "google/cloud/os_config/v1alpha"
667
+ #
668
+ # # Create a client object. The client can be reused for multiple calls.
669
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
670
+ #
671
+ # # Create a request. To set request fields, pass in keyword arguments.
672
+ # request = Google::Cloud::OsConfig::V1alpha::DeleteOSPolicyAssignmentRequest.new
673
+ #
674
+ # # Call the delete_os_policy_assignment method.
675
+ # result = client.delete_os_policy_assignment request
676
+ #
677
+ # # The returned object is of type Gapic::Operation. You can use it to
678
+ # # check the status of an operation, cancel it, or wait for results.
679
+ # # Here is how to wait for a response.
680
+ # result.wait_until_done! timeout: 60
681
+ # if result.response?
682
+ # p result.response
683
+ # else
684
+ # puts "No response received."
685
+ # end
686
+ #
562
687
  def delete_os_policy_assignment request, options = nil
563
688
  raise ::ArgumentError, "request must be provided" if request.nil?
564
689
 
@@ -631,6 +756,22 @@ module Google
631
756
  # @return [::Google::Cloud::OsConfig::V1alpha::InstanceOSPoliciesCompliance]
632
757
  #
633
758
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
759
+ #
760
+ # @example Basic example
761
+ # require "google/cloud/os_config/v1alpha"
762
+ #
763
+ # # Create a client object. The client can be reused for multiple calls.
764
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
765
+ #
766
+ # # Create a request. To set request fields, pass in keyword arguments.
767
+ # request = Google::Cloud::OsConfig::V1alpha::GetInstanceOSPoliciesComplianceRequest.new
768
+ #
769
+ # # Call the get_instance_os_policies_compliance method.
770
+ # result = client.get_instance_os_policies_compliance request
771
+ #
772
+ # # The returned object is of type Google::Cloud::OsConfig::V1alpha::InstanceOSPoliciesCompliance.
773
+ # p result
774
+ #
634
775
  def get_instance_os_policies_compliance request, options = nil
635
776
  raise ::ArgumentError, "request must be provided" if request.nil?
636
777
 
@@ -708,6 +849,26 @@ module Google
708
849
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1alpha::InstanceOSPoliciesCompliance>]
709
850
  #
710
851
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
852
+ #
853
+ # @example Basic example
854
+ # require "google/cloud/os_config/v1alpha"
855
+ #
856
+ # # Create a client object. The client can be reused for multiple calls.
857
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
858
+ #
859
+ # # Create a request. To set request fields, pass in keyword arguments.
860
+ # request = Google::Cloud::OsConfig::V1alpha::ListInstanceOSPoliciesCompliancesRequest.new
861
+ #
862
+ # # Call the list_instance_os_policies_compliances method.
863
+ # result = client.list_instance_os_policies_compliances request
864
+ #
865
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
866
+ # # over elements, and API calls will be issued to fetch pages as needed.
867
+ # result.each do |item|
868
+ # # Each element is of type ::Google::Cloud::OsConfig::V1alpha::InstanceOSPoliciesCompliance.
869
+ # p item
870
+ # end
871
+ #
711
872
  def list_instance_os_policies_compliances request, options = nil
712
873
  raise ::ArgumentError, "request must be provided" if request.nil?
713
874
 
@@ -780,6 +941,22 @@ module Google
780
941
  # @return [::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignmentReport]
781
942
  #
782
943
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
944
+ #
945
+ # @example Basic example
946
+ # require "google/cloud/os_config/v1alpha"
947
+ #
948
+ # # Create a client object. The client can be reused for multiple calls.
949
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
950
+ #
951
+ # # Create a request. To set request fields, pass in keyword arguments.
952
+ # request = Google::Cloud::OsConfig::V1alpha::GetOSPolicyAssignmentReportRequest.new
953
+ #
954
+ # # Call the get_os_policy_assignment_report method.
955
+ # result = client.get_os_policy_assignment_report request
956
+ #
957
+ # # The returned object is of type Google::Cloud::OsConfig::V1alpha::OSPolicyAssignmentReport.
958
+ # p result
959
+ #
783
960
  def get_os_policy_assignment_report request, options = nil
784
961
  raise ::ArgumentError, "request must be provided" if request.nil?
785
962
 
@@ -872,6 +1049,26 @@ module Google
872
1049
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignmentReport>]
873
1050
  #
874
1051
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1052
+ #
1053
+ # @example Basic example
1054
+ # require "google/cloud/os_config/v1alpha"
1055
+ #
1056
+ # # Create a client object. The client can be reused for multiple calls.
1057
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
1058
+ #
1059
+ # # Create a request. To set request fields, pass in keyword arguments.
1060
+ # request = Google::Cloud::OsConfig::V1alpha::ListOSPolicyAssignmentReportsRequest.new
1061
+ #
1062
+ # # Call the list_os_policy_assignment_reports method.
1063
+ # result = client.list_os_policy_assignment_reports request
1064
+ #
1065
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1066
+ # # over elements, and API calls will be issued to fetch pages as needed.
1067
+ # result.each do |item|
1068
+ # # Each element is of type ::Google::Cloud::OsConfig::V1alpha::OSPolicyAssignmentReport.
1069
+ # p item
1070
+ # end
1071
+ #
875
1072
  def list_os_policy_assignment_reports request, options = nil
876
1073
  raise ::ArgumentError, "request must be provided" if request.nil?
877
1074
 
@@ -946,6 +1143,22 @@ module Google
946
1143
  # @return [::Google::Cloud::OsConfig::V1alpha::Inventory]
947
1144
  #
948
1145
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1146
+ #
1147
+ # @example Basic example
1148
+ # require "google/cloud/os_config/v1alpha"
1149
+ #
1150
+ # # Create a client object. The client can be reused for multiple calls.
1151
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
1152
+ #
1153
+ # # Create a request. To set request fields, pass in keyword arguments.
1154
+ # request = Google::Cloud::OsConfig::V1alpha::GetInventoryRequest.new
1155
+ #
1156
+ # # Call the get_inventory method.
1157
+ # result = client.get_inventory request
1158
+ #
1159
+ # # The returned object is of type Google::Cloud::OsConfig::V1alpha::Inventory.
1160
+ # p result
1161
+ #
949
1162
  def get_inventory request, options = nil
950
1163
  raise ::ArgumentError, "request must be provided" if request.nil?
951
1164
 
@@ -1024,6 +1237,26 @@ module Google
1024
1237
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1alpha::Inventory>]
1025
1238
  #
1026
1239
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1240
+ #
1241
+ # @example Basic example
1242
+ # require "google/cloud/os_config/v1alpha"
1243
+ #
1244
+ # # Create a client object. The client can be reused for multiple calls.
1245
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
1246
+ #
1247
+ # # Create a request. To set request fields, pass in keyword arguments.
1248
+ # request = Google::Cloud::OsConfig::V1alpha::ListInventoriesRequest.new
1249
+ #
1250
+ # # Call the list_inventories method.
1251
+ # result = client.list_inventories request
1252
+ #
1253
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1254
+ # # over elements, and API calls will be issued to fetch pages as needed.
1255
+ # result.each do |item|
1256
+ # # Each element is of type ::Google::Cloud::OsConfig::V1alpha::Inventory.
1257
+ # p item
1258
+ # end
1259
+ #
1027
1260
  def list_inventories request, options = nil
1028
1261
  raise ::ArgumentError, "request must be provided" if request.nil?
1029
1262
 
@@ -1095,6 +1328,22 @@ module Google
1095
1328
  # @return [::Google::Cloud::OsConfig::V1alpha::VulnerabilityReport]
1096
1329
  #
1097
1330
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1331
+ #
1332
+ # @example Basic example
1333
+ # require "google/cloud/os_config/v1alpha"
1334
+ #
1335
+ # # Create a client object. The client can be reused for multiple calls.
1336
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
1337
+ #
1338
+ # # Create a request. To set request fields, pass in keyword arguments.
1339
+ # request = Google::Cloud::OsConfig::V1alpha::GetVulnerabilityReportRequest.new
1340
+ #
1341
+ # # Call the get_vulnerability_report method.
1342
+ # result = client.get_vulnerability_report request
1343
+ #
1344
+ # # The returned object is of type Google::Cloud::OsConfig::V1alpha::VulnerabilityReport.
1345
+ # p result
1346
+ #
1098
1347
  def get_vulnerability_report request, options = nil
1099
1348
  raise ::ArgumentError, "request must be provided" if request.nil?
1100
1349
 
@@ -1170,6 +1419,26 @@ module Google
1170
1419
  # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OsConfig::V1alpha::VulnerabilityReport>]
1171
1420
  #
1172
1421
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
1422
+ #
1423
+ # @example Basic example
1424
+ # require "google/cloud/os_config/v1alpha"
1425
+ #
1426
+ # # Create a client object. The client can be reused for multiple calls.
1427
+ # client = Google::Cloud::OsConfig::V1alpha::OsConfigZonalService::Rest::Client.new
1428
+ #
1429
+ # # Create a request. To set request fields, pass in keyword arguments.
1430
+ # request = Google::Cloud::OsConfig::V1alpha::ListVulnerabilityReportsRequest.new
1431
+ #
1432
+ # # Call the list_vulnerability_reports method.
1433
+ # result = client.list_vulnerability_reports request
1434
+ #
1435
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1436
+ # # over elements, and API calls will be issued to fetch pages as needed.
1437
+ # result.each do |item|
1438
+ # # Each element is of type ::Google::Cloud::OsConfig::V1alpha::VulnerabilityReport.
1439
+ # p item
1440
+ # end
1441
+ #
1173
1442
  def list_vulnerability_reports request, options = nil
1174
1443
  raise ::ArgumentError, "request must be provided" if request.nil?
1175
1444
 
@@ -1244,9 +1513,9 @@ module Google
1244
1513
  # * (`String`) The path to a service account key file in JSON format
1245
1514
  # * (`Hash`) A service account key as a Hash
1246
1515
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1247
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1516
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1248
1517
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1249
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1518
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1250
1519
  # * (`nil`) indicating no credentials
1251
1520
  # @return [::Object]
1252
1521
  # @!attribute [rw] scope
@@ -1279,7 +1548,9 @@ module Google
1279
1548
  class Configuration
1280
1549
  extend ::Gapic::Config
1281
1550
 
1282
- config_attr :endpoint, "osconfig.googleapis.com", ::String
1551
+ DEFAULT_ENDPOINT = "osconfig.googleapis.com"
1552
+
1553
+ config_attr :endpoint, DEFAULT_ENDPOINT, ::String
1283
1554
  config_attr :credentials, nil do |value|
1284
1555
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1285
1556
  allowed.any? { |klass| klass === value }