google-cloud-memcache-v1beta2 0.2.3 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
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