google-cloud-memcache-v1beta2 0.2.3 → 0.3.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: 99bae616045ea07c1ca5d3bd0efa0fe3f76254574999707553eeea47433793b6
4
- data.tar.gz: a8b915aac5be7cb46772e36c514326b6ec1a37c663103a47977bab3e1146a840
3
+ metadata.gz: 7f7c1a4548994435833ddff589eafad2407e258138cf0ff498c33144d7783f48
4
+ data.tar.gz: 95699bc2aa00bfcea2df006ae62c9ad40af6982a2e5a185e183a1d190f7cabce
5
5
  SHA512:
6
- metadata.gz: 35c030376951238c76c336d6020a6895c0b7f025190f8b95bd05b1b09da060168da3a2900b85ed8a839b29b43f44fe639352876bb757048e3313b2d9f1c399ff
7
- data.tar.gz: 0252cf66b9e614cb2da87f37438da172c41d61b2c90064b88d2242b7e969d14fe51264b6022eb8be791fb7e902b2caffd9676179abdd78c1504e6eb87c29feea
6
+ metadata.gz: 97ca9b60937d0f4f32424f3de796abd30a52a21dbb8b9db3ae85fdfbf154ecab16b0f4aa7515f00be91e4e333238009a8a860dd1459587558141651617a1cc1b
7
+ data.tar.gz: 1a677ba1d6df6d5c2acf42adb5a72425b8f4dab729650ee6ac44d49b6d9ac6a1dce3bb12fccfa1fb887f29c8fbd997ff9bc340b07390fc961322860a25227573
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Google Cloud Memorystore for Memcached API
2
+ --title="Google Cloud Memorystore for Memcached API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
data/README.md CHANGED
@@ -37,7 +37,7 @@ request = ::Google::Cloud::Memcache::V1beta2::ListInstancesRequest.new # (reques
37
37
  response = client.list_instances request
38
38
  ```
39
39
 
40
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-memcache-v1beta2/latest)
40
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-memcache-v1beta2/latest)
41
41
  for class and method documentation.
42
42
 
43
43
  See also the [Product Documentation](https://cloud.google.com/memorystore/docs/memcached/)
@@ -69,16 +69,21 @@ module GRPC
69
69
  end
70
70
  ```
71
71
 
72
+
73
+ ## Google Cloud Samples
74
+
75
+ To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
+
72
77
  ## Supported Ruby Versions
73
78
 
74
- This library is supported on Ruby 2.5+.
79
+ This library is supported on Ruby 2.6+.
75
80
 
76
81
  Google provides official support for Ruby versions that are actively supported
77
82
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
78
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
79
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
80
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
81
- about the Ruby support schedule.
83
+ in security maintenance, and not end of life. Older versions of Ruby _may_
84
+ still work, but are unsupported and not recommended. See
85
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
86
+ support schedule.
82
87
 
83
88
  ## Which client should I use?
84
89
 
@@ -165,6 +165,7 @@ module Google
165
165
 
166
166
  @operations_client = Operations.new do |config|
167
167
  config.credentials = credentials
168
+ config.quota_project = @quota_project_id
168
169
  config.endpoint = @config.endpoint
169
170
  end
170
171
 
@@ -232,6 +233,27 @@ module Google
232
233
  #
233
234
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
234
235
  #
236
+ # @example Basic example
237
+ # require "google/cloud/memcache/v1beta2"
238
+ #
239
+ # # Create a client object. The client can be reused for multiple calls.
240
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
241
+ #
242
+ # # Create a request. To set request fields, pass in keyword arguments.
243
+ # request = Google::Cloud::Memcache::V1beta2::ListInstancesRequest.new
244
+ #
245
+ # # Call the list_instances method.
246
+ # result = client.list_instances request
247
+ #
248
+ # # The returned object is of type Gapic::PagedEnumerable. You can
249
+ # # iterate over all elements by calling #each, and the enumerable
250
+ # # will lazily make API calls to fetch subsequent pages. Other
251
+ # # methods are also available for managing paging directly.
252
+ # result.each do |response|
253
+ # # Each element is of type ::Google::Cloud::Memcache::V1beta2::Instance.
254
+ # p response
255
+ # end
256
+ #
235
257
  def list_instances request, options = nil
236
258
  raise ::ArgumentError, "request must be provided" if request.nil?
237
259
 
@@ -249,9 +271,11 @@ module Google
249
271
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
250
272
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
251
273
 
252
- header_params = {
253
- "parent" => request.parent
254
- }
274
+ header_params = {}
275
+ if request.parent
276
+ header_params["parent"] = request.parent
277
+ end
278
+
255
279
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
256
280
  metadata[:"x-goog-request-params"] ||= request_params_header
257
281
 
@@ -303,6 +327,21 @@ module Google
303
327
  #
304
328
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
305
329
  #
330
+ # @example Basic example
331
+ # require "google/cloud/memcache/v1beta2"
332
+ #
333
+ # # Create a client object. The client can be reused for multiple calls.
334
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
335
+ #
336
+ # # Create a request. To set request fields, pass in keyword arguments.
337
+ # request = Google::Cloud::Memcache::V1beta2::GetInstanceRequest.new
338
+ #
339
+ # # Call the get_instance method.
340
+ # result = client.get_instance request
341
+ #
342
+ # # The returned object is of type Google::Cloud::Memcache::V1beta2::Instance.
343
+ # p result
344
+ #
306
345
  def get_instance request, options = nil
307
346
  raise ::ArgumentError, "request must be provided" if request.nil?
308
347
 
@@ -320,9 +359,11 @@ module Google
320
359
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
321
360
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
322
361
 
323
- header_params = {
324
- "name" => request.name
325
- }
362
+ header_params = {}
363
+ if request.name
364
+ header_params["name"] = request.name
365
+ end
366
+
326
367
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
327
368
  metadata[:"x-goog-request-params"] ||= request_params_header
328
369
 
@@ -386,6 +427,28 @@ module Google
386
427
  #
387
428
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
388
429
  #
430
+ # @example Basic example
431
+ # require "google/cloud/memcache/v1beta2"
432
+ #
433
+ # # Create a client object. The client can be reused for multiple calls.
434
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
435
+ #
436
+ # # Create a request. To set request fields, pass in keyword arguments.
437
+ # request = Google::Cloud::Memcache::V1beta2::CreateInstanceRequest.new
438
+ #
439
+ # # Call the create_instance method.
440
+ # result = client.create_instance request
441
+ #
442
+ # # The returned object is of type Gapic::Operation. You can use this
443
+ # # object to check the status of an operation, cancel it, or wait
444
+ # # for results. Here is how to block until completion:
445
+ # result.wait_until_done! timeout: 60
446
+ # if result.response?
447
+ # p result.response
448
+ # else
449
+ # puts "Error!"
450
+ # end
451
+ #
389
452
  def create_instance request, options = nil
390
453
  raise ::ArgumentError, "request must be provided" if request.nil?
391
454
 
@@ -403,9 +466,11 @@ module Google
403
466
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
404
467
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
405
468
 
406
- header_params = {
407
- "parent" => request.parent
408
- }
469
+ header_params = {}
470
+ if request.parent
471
+ header_params["parent"] = request.parent
472
+ end
473
+
409
474
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
410
475
  metadata[:"x-goog-request-params"] ||= request_params_header
411
476
 
@@ -459,6 +524,28 @@ module Google
459
524
  #
460
525
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
461
526
  #
527
+ # @example Basic example
528
+ # require "google/cloud/memcache/v1beta2"
529
+ #
530
+ # # Create a client object. The client can be reused for multiple calls.
531
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
532
+ #
533
+ # # Create a request. To set request fields, pass in keyword arguments.
534
+ # request = Google::Cloud::Memcache::V1beta2::UpdateInstanceRequest.new
535
+ #
536
+ # # Call the update_instance method.
537
+ # result = client.update_instance request
538
+ #
539
+ # # The returned object is of type Gapic::Operation. You can use this
540
+ # # object to check the status of an operation, cancel it, or wait
541
+ # # for results. Here is how to block until completion:
542
+ # result.wait_until_done! timeout: 60
543
+ # if result.response?
544
+ # p result.response
545
+ # else
546
+ # puts "Error!"
547
+ # end
548
+ #
462
549
  def update_instance request, options = nil
463
550
  raise ::ArgumentError, "request must be provided" if request.nil?
464
551
 
@@ -476,9 +563,11 @@ module Google
476
563
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
477
564
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
478
565
 
479
- header_params = {
480
- "resource.name" => request.resource.name
481
- }
566
+ header_params = {}
567
+ if request.resource&.name
568
+ header_params["resource.name"] = request.resource.name
569
+ end
570
+
482
571
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
483
572
  metadata[:"x-goog-request-params"] ||= request_params_header
484
573
 
@@ -536,6 +625,28 @@ module Google
536
625
  #
537
626
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
538
627
  #
628
+ # @example Basic example
629
+ # require "google/cloud/memcache/v1beta2"
630
+ #
631
+ # # Create a client object. The client can be reused for multiple calls.
632
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
633
+ #
634
+ # # Create a request. To set request fields, pass in keyword arguments.
635
+ # request = Google::Cloud::Memcache::V1beta2::UpdateParametersRequest.new
636
+ #
637
+ # # Call the update_parameters method.
638
+ # result = client.update_parameters request
639
+ #
640
+ # # The returned object is of type Gapic::Operation. You can use this
641
+ # # object to check the status of an operation, cancel it, or wait
642
+ # # for results. Here is how to block until completion:
643
+ # result.wait_until_done! timeout: 60
644
+ # if result.response?
645
+ # p result.response
646
+ # else
647
+ # puts "Error!"
648
+ # end
649
+ #
539
650
  def update_parameters request, options = nil
540
651
  raise ::ArgumentError, "request must be provided" if request.nil?
541
652
 
@@ -553,9 +664,11 @@ module Google
553
664
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
554
665
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
555
666
 
556
- header_params = {
557
- "name" => request.name
558
- }
667
+ header_params = {}
668
+ if request.name
669
+ header_params["name"] = request.name
670
+ end
671
+
559
672
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
560
673
  metadata[:"x-goog-request-params"] ||= request_params_header
561
674
 
@@ -607,6 +720,28 @@ module Google
607
720
  #
608
721
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
609
722
  #
723
+ # @example Basic example
724
+ # require "google/cloud/memcache/v1beta2"
725
+ #
726
+ # # Create a client object. The client can be reused for multiple calls.
727
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
728
+ #
729
+ # # Create a request. To set request fields, pass in keyword arguments.
730
+ # request = Google::Cloud::Memcache::V1beta2::DeleteInstanceRequest.new
731
+ #
732
+ # # Call the delete_instance method.
733
+ # result = client.delete_instance request
734
+ #
735
+ # # The returned object is of type Gapic::Operation. You can use this
736
+ # # object to check the status of an operation, cancel it, or wait
737
+ # # for results. Here is how to block until completion:
738
+ # result.wait_until_done! timeout: 60
739
+ # if result.response?
740
+ # p result.response
741
+ # else
742
+ # puts "Error!"
743
+ # end
744
+ #
610
745
  def delete_instance request, options = nil
611
746
  raise ::ArgumentError, "request must be provided" if request.nil?
612
747
 
@@ -624,9 +759,11 @@ module Google
624
759
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
625
760
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
626
761
 
627
- header_params = {
628
- "name" => request.name
629
- }
762
+ header_params = {}
763
+ if request.name
764
+ header_params["name"] = request.name
765
+ end
766
+
630
767
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
631
768
  metadata[:"x-goog-request-params"] ||= request_params_header
632
769
 
@@ -684,6 +821,28 @@ module Google
684
821
  #
685
822
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
686
823
  #
824
+ # @example Basic example
825
+ # require "google/cloud/memcache/v1beta2"
826
+ #
827
+ # # Create a client object. The client can be reused for multiple calls.
828
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
829
+ #
830
+ # # Create a request. To set request fields, pass in keyword arguments.
831
+ # request = Google::Cloud::Memcache::V1beta2::ApplyParametersRequest.new
832
+ #
833
+ # # Call the apply_parameters method.
834
+ # result = client.apply_parameters request
835
+ #
836
+ # # The returned object is of type Gapic::Operation. You can use this
837
+ # # object to check the status of an operation, cancel it, or wait
838
+ # # for results. Here is how to block until completion:
839
+ # result.wait_until_done! timeout: 60
840
+ # if result.response?
841
+ # p result.response
842
+ # else
843
+ # puts "Error!"
844
+ # end
845
+ #
687
846
  def apply_parameters request, options = nil
688
847
  raise ::ArgumentError, "request must be provided" if request.nil?
689
848
 
@@ -701,9 +860,11 @@ module Google
701
860
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
702
861
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
703
862
 
704
- header_params = {
705
- "name" => request.name
706
- }
863
+ header_params = {}
864
+ if request.name
865
+ header_params["name"] = request.name
866
+ end
867
+
707
868
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
708
869
  metadata[:"x-goog-request-params"] ||= request_params_header
709
870
 
@@ -761,6 +922,28 @@ module Google
761
922
  #
762
923
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
763
924
  #
925
+ # @example Basic example
926
+ # require "google/cloud/memcache/v1beta2"
927
+ #
928
+ # # Create a client object. The client can be reused for multiple calls.
929
+ # client = Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
930
+ #
931
+ # # Create a request. To set request fields, pass in keyword arguments.
932
+ # request = Google::Cloud::Memcache::V1beta2::ApplySoftwareUpdateRequest.new
933
+ #
934
+ # # Call the apply_software_update method.
935
+ # result = client.apply_software_update request
936
+ #
937
+ # # The returned object is of type Gapic::Operation. You can use this
938
+ # # object to check the status of an operation, cancel it, or wait
939
+ # # for results. Here is how to block until completion:
940
+ # result.wait_until_done! timeout: 60
941
+ # if result.response?
942
+ # p result.response
943
+ # else
944
+ # puts "Error!"
945
+ # end
946
+ #
764
947
  def apply_software_update request, options = nil
765
948
  raise ::ArgumentError, "request must be provided" if request.nil?
766
949
 
@@ -778,9 +961,11 @@ module Google
778
961
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
779
962
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
780
963
 
781
- header_params = {
782
- "instance" => request.instance
783
- }
964
+ header_params = {}
965
+ if request.instance
966
+ header_params["instance"] = request.instance
967
+ end
968
+
784
969
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
785
970
  metadata[:"x-goog-request-params"] ||= request_params_header
786
971
 
@@ -95,6 +95,9 @@ module Google
95
95
  channel_args: @config.channel_args,
96
96
  interceptors: @config.interceptors
97
97
  )
98
+
99
+ # Used by an LRO wrapper for some methods of this service
100
+ @operations_client = self
98
101
  end
99
102
 
100
103
  # Service calls
@@ -143,6 +146,27 @@ module Google
143
146
  #
144
147
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
145
148
  #
149
+ # @example Basic example
150
+ # require "google/longrunning"
151
+ #
152
+ # # Create a client object. The client can be reused for multiple calls.
153
+ # client = Google::Longrunning::Operations::Client.new
154
+ #
155
+ # # Create a request. To set request fields, pass in keyword arguments.
156
+ # request = Google::Longrunning::ListOperationsRequest.new
157
+ #
158
+ # # Call the list_operations method.
159
+ # result = client.list_operations request
160
+ #
161
+ # # The returned object is of type Gapic::PagedEnumerable. You can
162
+ # # iterate over all elements by calling #each, and the enumerable
163
+ # # will lazily make API calls to fetch subsequent pages. Other
164
+ # # methods are also available for managing paging directly.
165
+ # result.each do |response|
166
+ # # Each element is of type ::Google::Longrunning::Operation.
167
+ # p response
168
+ # end
169
+ #
146
170
  def list_operations request, options = nil
147
171
  raise ::ArgumentError, "request must be provided" if request.nil?
148
172
 
@@ -160,9 +184,11 @@ module Google
160
184
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
161
185
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
162
186
 
163
- header_params = {
164
- "name" => request.name
165
- }
187
+ header_params = {}
188
+ if request.name
189
+ header_params["name"] = request.name
190
+ end
191
+
166
192
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
167
193
  metadata[:"x-goog-request-params"] ||= request_params_header
168
194
 
@@ -215,6 +241,28 @@ module Google
215
241
  #
216
242
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
217
243
  #
244
+ # @example Basic example
245
+ # require "google/longrunning"
246
+ #
247
+ # # Create a client object. The client can be reused for multiple calls.
248
+ # client = Google::Longrunning::Operations::Client.new
249
+ #
250
+ # # Create a request. To set request fields, pass in keyword arguments.
251
+ # request = Google::Longrunning::GetOperationRequest.new
252
+ #
253
+ # # Call the get_operation method.
254
+ # result = client.get_operation request
255
+ #
256
+ # # The returned object is of type Gapic::Operation. You can use this
257
+ # # object to check the status of an operation, cancel it, or wait
258
+ # # for results. Here is how to block until completion:
259
+ # result.wait_until_done! timeout: 60
260
+ # if result.response?
261
+ # p result.response
262
+ # else
263
+ # puts "Error!"
264
+ # end
265
+ #
218
266
  def get_operation request, options = nil
219
267
  raise ::ArgumentError, "request must be provided" if request.nil?
220
268
 
@@ -232,9 +280,11 @@ module Google
232
280
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
233
281
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
234
282
 
235
- header_params = {
236
- "name" => request.name
237
- }
283
+ header_params = {}
284
+ if request.name
285
+ header_params["name"] = request.name
286
+ end
287
+
238
288
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
239
289
  metadata[:"x-goog-request-params"] ||= request_params_header
240
290
 
@@ -287,6 +337,21 @@ module Google
287
337
  #
288
338
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
289
339
  #
340
+ # @example Basic example
341
+ # require "google/longrunning"
342
+ #
343
+ # # Create a client object. The client can be reused for multiple calls.
344
+ # client = Google::Longrunning::Operations::Client.new
345
+ #
346
+ # # Create a request. To set request fields, pass in keyword arguments.
347
+ # request = Google::Longrunning::DeleteOperationRequest.new
348
+ #
349
+ # # Call the delete_operation method.
350
+ # result = client.delete_operation request
351
+ #
352
+ # # The returned object is of type Google::Protobuf::Empty.
353
+ # p result
354
+ #
290
355
  def delete_operation request, options = nil
291
356
  raise ::ArgumentError, "request must be provided" if request.nil?
292
357
 
@@ -304,9 +369,11 @@ module Google
304
369
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
305
370
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
306
371
 
307
- header_params = {
308
- "name" => request.name
309
- }
372
+ header_params = {}
373
+ if request.name
374
+ header_params["name"] = request.name
375
+ end
376
+
310
377
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
311
378
  metadata[:"x-goog-request-params"] ||= request_params_header
312
379
 
@@ -364,6 +431,21 @@ module Google
364
431
  #
365
432
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
366
433
  #
434
+ # @example Basic example
435
+ # require "google/longrunning"
436
+ #
437
+ # # Create a client object. The client can be reused for multiple calls.
438
+ # client = Google::Longrunning::Operations::Client.new
439
+ #
440
+ # # Create a request. To set request fields, pass in keyword arguments.
441
+ # request = Google::Longrunning::CancelOperationRequest.new
442
+ #
443
+ # # Call the cancel_operation method.
444
+ # result = client.cancel_operation request
445
+ #
446
+ # # The returned object is of type Google::Protobuf::Empty.
447
+ # p result
448
+ #
367
449
  def cancel_operation request, options = nil
368
450
  raise ::ArgumentError, "request must be provided" if request.nil?
369
451
 
@@ -381,9 +463,11 @@ module Google
381
463
  gapic_version: ::Google::Cloud::Memcache::V1beta2::VERSION
382
464
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
383
465
 
384
- header_params = {
385
- "name" => request.name
386
- }
466
+ header_params = {}
467
+ if request.name
468
+ header_params["name"] = request.name
469
+ end
470
+
387
471
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
388
472
  metadata[:"x-goog-request-params"] ||= request_params_header
389
473
 
@@ -444,6 +528,28 @@ module Google
444
528
  #
445
529
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
446
530
  #
531
+ # @example Basic example
532
+ # require "google/longrunning"
533
+ #
534
+ # # Create a client object. The client can be reused for multiple calls.
535
+ # client = Google::Longrunning::Operations::Client.new
536
+ #
537
+ # # Create a request. To set request fields, pass in keyword arguments.
538
+ # request = Google::Longrunning::WaitOperationRequest.new
539
+ #
540
+ # # Call the wait_operation method.
541
+ # result = client.wait_operation request
542
+ #
543
+ # # The returned object is of type Gapic::Operation. You can use this
544
+ # # object to check the status of an operation, cancel it, or wait
545
+ # # for results. Here is how to block until completion:
546
+ # result.wait_until_done! timeout: 60
547
+ # if result.response?
548
+ # p result.response
549
+ # else
550
+ # puts "Error!"
551
+ # end
552
+ #
447
553
  def wait_operation request, options = nil
448
554
  raise ::ArgumentError, "request must be provided" if request.nil?
449
555
 
@@ -10,6 +10,7 @@ require 'google/api/resource_pb'
10
10
  require 'google/longrunning/operations_pb'
11
11
  require 'google/protobuf/field_mask_pb'
12
12
  require 'google/protobuf/timestamp_pb'
13
+
13
14
  Google::Protobuf::DescriptorPool.generated_pool.build do
14
15
  add_file("google/cloud/memcache/v1beta2/cloud_memcache.proto", :syntax => :proto3) do
15
16
  add_message "google.cloud.memcache.v1beta2.Instance" do
@@ -41,7 +41,7 @@ module Google
41
41
  # * `projects/my-memcached-project/locations/us-central1/instances/my-memcached`
42
42
  class Service
43
43
 
44
- include GRPC::GenericService
44
+ include ::GRPC::GenericService
45
45
 
46
46
  self.marshal_class_method = :encode
47
47
  self.unmarshal_class_method = :decode
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Memcache
23
23
  module V1beta2
24
- VERSION = "0.2.3"
24
+ VERSION = "0.3.0"
25
25
  end
26
26
  end
27
27
  end
@@ -25,6 +25,8 @@ module Google
25
25
  ##
26
26
  # To load this package, including all its services, and instantiate a client:
27
27
  #
28
+ # @example
29
+ #
28
30
  # require "google/cloud/memcache/v1beta2"
29
31
  # client = ::Google::Cloud::Memcache::V1beta2::CloudMemcache::Client.new
30
32
  #
@@ -33,11 +33,7 @@ module Google
33
33
  # // For Kubernetes resources, the format is {api group}/{kind}.
34
34
  # option (google.api.resource) = {
35
35
  # type: "pubsub.googleapis.com/Topic"
36
- # name_descriptor: {
37
- # pattern: "projects/{project}/topics/{topic}"
38
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
39
- # parent_name_extractor: "projects/{project}"
40
- # }
36
+ # pattern: "projects/{project}/topics/{topic}"
41
37
  # };
42
38
  # }
43
39
  #
@@ -45,10 +41,7 @@ module Google
45
41
  #
46
42
  # resources:
47
43
  # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/{project}/topics/{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/{project}"
44
+ # pattern: "projects/{project}/topics/{topic}"
52
45
  #
53
46
  # Sometimes, resources have multiple patterns, typically because they can
54
47
  # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
58
51
  # message LogEntry {
59
52
  # option (google.api.resource) = {
60
53
  # type: "logging.googleapis.com/LogEntry"
61
- # name_descriptor: {
62
- # pattern: "projects/{project}/logs/{log}"
63
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
64
- # parent_name_extractor: "projects/{project}"
65
- # }
66
- # name_descriptor: {
67
- # pattern: "folders/{folder}/logs/{log}"
68
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
69
- # parent_name_extractor: "folders/{folder}"
70
- # }
71
- # name_descriptor: {
72
- # pattern: "organizations/{organization}/logs/{log}"
73
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
74
- # parent_name_extractor: "organizations/{organization}"
75
- # }
76
- # name_descriptor: {
77
- # pattern: "billingAccounts/{billing_account}/logs/{log}"
78
- # parent_type: "billing.googleapis.com/BillingAccount"
79
- # parent_name_extractor: "billingAccounts/{billing_account}"
80
- # }
54
+ # pattern: "projects/{project}/logs/{log}"
55
+ # pattern: "folders/{folder}/logs/{log}"
56
+ # pattern: "organizations/{organization}/logs/{log}"
57
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
81
58
  # };
82
59
  # }
83
60
  #
@@ -85,48 +62,10 @@ module Google
85
62
  #
86
63
  # resources:
87
64
  # - type: 'logging.googleapis.com/LogEntry'
88
- # name_descriptor:
89
- # - pattern: "projects/{project}/logs/{log}"
90
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
91
- # parent_name_extractor: "projects/{project}"
92
- # - pattern: "folders/{folder}/logs/{log}"
93
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
94
- # parent_name_extractor: "folders/{folder}"
95
- # - pattern: "organizations/{organization}/logs/{log}"
96
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
97
- # parent_name_extractor: "organizations/{organization}"
98
- # - pattern: "billingAccounts/{billing_account}/logs/{log}"
99
- # parent_type: "billing.googleapis.com/BillingAccount"
100
- # parent_name_extractor: "billingAccounts/{billing_account}"
101
- #
102
- # For flexible resources, the resource name doesn't contain parent names, but
103
- # the resource itself has parents for policy evaluation.
104
- #
105
- # Example:
106
- #
107
- # message Shelf {
108
- # option (google.api.resource) = {
109
- # type: "library.googleapis.com/Shelf"
110
- # name_descriptor: {
111
- # pattern: "shelves/{shelf}"
112
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
113
- # }
114
- # name_descriptor: {
115
- # pattern: "shelves/{shelf}"
116
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
117
- # }
118
- # };
119
- # }
120
- #
121
- # The ResourceDescriptor Yaml config will look like:
122
- #
123
- # resources:
124
- # - type: 'library.googleapis.com/Shelf'
125
- # name_descriptor:
126
- # - pattern: "shelves/{shelf}"
127
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
128
- # - pattern: "shelves/{shelf}"
129
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
65
+ # pattern: "projects/{project}/logs/{log}"
66
+ # pattern: "folders/{folder}/logs/{log}"
67
+ # pattern: "organizations/{organization}/logs/{log}"
68
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
130
69
  # @!attribute [rw] type
131
70
  # @return [::String]
132
71
  # The resource type. It must be in the format of
@@ -44,7 +44,7 @@ module Google
44
44
  # foo = any.unpack(Foo.class);
45
45
  # }
46
46
  #
47
- # Example 3: Pack and unpack a message in Python.
47
+ # Example 3: Pack and unpack a message in Python.
48
48
  #
49
49
  # foo = Foo(...)
50
50
  # any = Any()
@@ -54,7 +54,7 @@ module Google
54
54
  # any.Unpack(foo)
55
55
  # ...
56
56
  #
57
- # Example 4: Pack and unpack a message in Go
57
+ # Example 4: Pack and unpack a message in Go
58
58
  #
59
59
  # foo := &pb.Foo{...}
60
60
  # any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
75
75
  #
76
76
  #
77
77
  # JSON
78
- # ====
78
+ #
79
79
  # The JSON representation of an `Any` value uses the regular
80
80
  # representation of the deserialized, embedded message, with an
81
81
  # additional field `@type` which contains the type URL. Example:
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-memcache-v1beta2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.3
4
+ version: 0.3.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: 2021-08-11 00:00:00.000000000 Z
11
+ date: 2022-07-05 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.7'
19
+ version: '0.10'
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.7'
29
+ version: '0.10'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -50,28 +50,28 @@ dependencies:
50
50
  requirements:
51
51
  - - "~>"
52
52
  - !ruby/object:Gem::Version
53
- version: 1.25.1
53
+ version: 1.26.1
54
54
  type: :development
55
55
  prerelease: false
56
56
  version_requirements: !ruby/object:Gem::Requirement
57
57
  requirements:
58
58
  - - "~>"
59
59
  - !ruby/object:Gem::Version
60
- version: 1.25.1
60
+ version: 1.26.1
61
61
  - !ruby/object:Gem::Dependency
62
62
  name: minitest
63
63
  requirement: !ruby/object:Gem::Requirement
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: '5.14'
67
+ version: '5.16'
68
68
  type: :development
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: '5.14'
74
+ version: '5.16'
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: minitest-focus
77
77
  requirement: !ruby/object:Gem::Requirement
@@ -106,14 +106,14 @@ dependencies:
106
106
  requirements:
107
107
  - - ">="
108
108
  - !ruby/object:Gem::Version
109
- version: '12.0'
109
+ version: '13.0'
110
110
  type: :development
111
111
  prerelease: false
112
112
  version_requirements: !ruby/object:Gem::Requirement
113
113
  requirements:
114
114
  - - ">="
115
115
  - !ruby/object:Gem::Version
116
- version: '12.0'
116
+ version: '13.0'
117
117
  - !ruby/object:Gem::Dependency
118
118
  name: redcarpet
119
119
  requirement: !ruby/object:Gem::Requirement
@@ -202,14 +202,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
202
202
  requirements:
203
203
  - - ">="
204
204
  - !ruby/object:Gem::Version
205
- version: '2.5'
205
+ version: '2.6'
206
206
  required_rubygems_version: !ruby/object:Gem::Requirement
207
207
  requirements:
208
208
  - - ">="
209
209
  - !ruby/object:Gem::Version
210
210
  version: '0'
211
211
  requirements: []
212
- rubygems_version: 3.2.17
212
+ rubygems_version: 3.3.14
213
213
  signing_key:
214
214
  specification_version: 4
215
215
  summary: API Client library for the Google Cloud Memorystore for Memcached API