google-cloud-redis-v1 0.5.3 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ab0e3dfa9a192bc452dd083b29a6a80a931b7d6c74d66910c6fe09ec8ae4c2d
-  data.tar.gz: 9312119ec04c082cb4f2893431f55874d67ff38ffb50d4de19ab34ce6d47a9e9
+  metadata.gz: 595fd860e4b4ce42b1f1b6026a8fde7eca130a34f2f6957962a2f276ccb832bf
+  data.tar.gz: 4777b3e84b558879f989c60225ceb86e281bc1e18fa71ab6f5c223b960e4b959
 SHA512:
-  metadata.gz: 20a35e9b40ffd6c8d703c3ea27e4535e1595fd6d0da7fac5c31c78b7ada54b9566314408d0f3a4a64c54faac2bc37802d794b2bd3ec007c31ae150dece777a02
-  data.tar.gz: e21202e3c61adedcfe526350c822d90fb54004a68a0874eadd8d120c116f81b37c5ce667235b7ce0fbc99484801e6619eb4261fe0b91b147856a1f4113af35f8
+  metadata.gz: 9528438d9f79e3295b15a308a0c0f884211271ba6f80cfd577ad12f8c727b39427bf593e69c674d73b84ddb4234716420c173dca9db1e70c5da06574155d1a3e
+  data.tar.gz: 859fdf7ac313ac590e33175419ae5baf5d2c7cfb09141b3f9968ed9fa6775fc381fd11765373cfe962e2ad6e1157a9fd3897eba0c65620138856c07f2cdd5e64

data/lib/google/cloud/redis/v1/cloud_redis/client.rb

@@ -238,6 +238,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::ListInstancesRequest.new
+            #
+            #   # Call the list_instances method.
+            #   result = client.list_instances request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Redis::V1::Instance.
+            #     p response
+            #   end
+            #
             def list_instances request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -255,9 +276,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -309,6 +332,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::GetInstanceRequest.new
+            #
+            #   # Call the get_instance method.
+            #   result = client.get_instance request
+            #
+            #   # The returned object is of type Google::Cloud::Redis::V1::Instance.
+            #   p result
+            #
             def get_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -326,9 +364,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -401,6 +441,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::CreateInstanceRequest.new
+            #
+            #   # Call the create_instance method.
+            #   result = client.create_instance request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def create_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -418,9 +480,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -472,6 +536,7 @@ module Google
             #      *   `labels`
             #      *   `memorySizeGb`
             #      *   `redisConfig`
+            #      *   `replica_count`
             #   @param instance [::Google::Cloud::Redis::V1::Instance, ::Hash]
             #     Required. Update description.
             #     Only fields specified in update_mask are updated.
@@ -484,6 +549,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::UpdateInstanceRequest.new
+            #
+            #   # Call the update_instance method.
+            #   result = client.update_instance request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def update_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -501,9 +588,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "instance.name" => request.instance.name
-              }
+              header_params = {}
+              if request.instance&.name
+                header_params["instance.name"] = request.instance.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -558,6 +647,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::UpgradeInstanceRequest.new
+            #
+            #   # Call the upgrade_instance method.
+            #   result = client.upgrade_instance request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def upgrade_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -575,9 +686,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -638,6 +751,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::ImportInstanceRequest.new
+            #
+            #   # Call the import_instance method.
+            #   result = client.import_instance request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def import_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -655,9 +790,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -716,6 +853,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::ExportInstanceRequest.new
+            #
+            #   # Call the export_instance method.
+            #   result = client.export_instance request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def export_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -733,9 +892,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -757,7 +918,7 @@ module Google
             end
 
             ##
-            # Initiates a failover of the master node to current replica node for a
+            # Initiates a failover of the primary node to current replica node for a
             # specific STANDARD tier Cloud Memorystore for Redis instance.
             #
             # @overload failover_instance(request, options = nil)
@@ -791,6 +952,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::FailoverInstanceRequest.new
+            #
+            #   # Call the failover_instance method.
+            #   result = client.failover_instance request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def failover_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -808,9 +991,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -863,6 +1048,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/redis/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Redis::V1::CloudRedis::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Redis::V1::DeleteInstanceRequest.new
+            #
+            #   # Call the delete_instance method.
+            #   result = client.delete_instance request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def delete_instance request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -880,9 +1087,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

data/lib/google/cloud/redis/v1/cloud_redis/operations.rb

@@ -143,6 +143,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::ListOperationsRequest.new
+            #
+            #   # Call the list_operations method.
+            #   result = client.list_operations request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Longrunning::Operation.
+            #     p response
+            #   end
+            #
             def list_operations request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -160,9 +181,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -215,6 +238,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::GetOperationRequest.new
+            #
+            #   # Call the get_operation method.
+            #   result = client.get_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def get_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -232,9 +277,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -287,6 +334,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::DeleteOperationRequest.new
+            #
+            #   # Call the delete_operation method.
+            #   result = client.delete_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -304,9 +366,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -364,6 +428,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::CancelOperationRequest.new
+            #
+            #   # Call the cancel_operation method.
+            #   result = client.cancel_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def cancel_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -381,9 +460,11 @@ module Google
                 gapic_version: ::Google::Cloud::Redis::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -444,6 +525,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::WaitOperationRequest.new
+            #
+            #   # Call the wait_operation method.
+            #   result = client.wait_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def wait_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/redis/v1/cloud_redis_pb.rb

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/redis/v1/cloud_redis.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -10,8 +8,14 @@ require 'google/api/resource_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/redis/v1/cloud_redis.proto", :syntax => :proto3) do
+    add_message "google.cloud.redis.v1.NodeInfo" do
+      optional :id, :string, 1
+      optional :zone, :string, 2
+    end
     add_message "google.cloud.redis.v1.Instance" do
       optional :name, :string, 1
       optional :display_name, :string, 2
@@ -32,6 +36,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :authorized_network, :string, 20
       optional :persistence_iam_identity, :string, 21
       optional :connect_mode, :enum, 22, "google.cloud.redis.v1.Instance.ConnectMode"
+      optional :replica_count, :int32, 31
+      repeated :nodes, :message, 32, "google.cloud.redis.v1.NodeInfo"
+      optional :read_endpoint, :string, 33
+      optional :read_endpoint_port, :int32, 34
+      optional :read_replicas_mode, :enum, 35, "google.cloud.redis.v1.Instance.ReadReplicasMode"
     end
     add_enum "google.cloud.redis.v1.Instance.State" do
       value :STATE_UNSPECIFIED, 0
@@ -54,6 +63,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :DIRECT_PEERING, 1
       value :PRIVATE_SERVICE_ACCESS, 2
     end
+    add_enum "google.cloud.redis.v1.Instance.ReadReplicasMode" do
+      value :READ_REPLICAS_MODE_UNSPECIFIED, 0
+      value :READ_REPLICAS_DISABLED, 1
+      value :READ_REPLICAS_ENABLED, 2
+    end
     add_message "google.cloud.redis.v1.ListInstancesRequest" do
       optional :parent, :string, 1
       optional :page_size, :int32, 2
@@ -137,10 +151,12 @@ module Google
   module Cloud
     module Redis
       module V1
+        NodeInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.NodeInfo").msgclass
         Instance = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.Instance").msgclass
         Instance::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.Instance.State").enummodule
         Instance::Tier = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.Instance.Tier").enummodule
         Instance::ConnectMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.Instance.ConnectMode").enummodule
+        Instance::ReadReplicasMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.Instance.ReadReplicasMode").enummodule
         ListInstancesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.ListInstancesRequest").msgclass
         ListInstancesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.ListInstancesResponse").msgclass
         GetInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.GetInstanceRequest").msgclass

data/lib/google/cloud/redis/v1/cloud_redis_services_pb.rb

@@ -41,7 +41,7 @@ module Google
           # * `projects/redpepper-1290/locations/us-central1/instances/my-redis`
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
@@ -97,7 +97,7 @@ module Google
             # The returned operation is automatically deleted after a few hours, so
             # there is no need to call DeleteOperation.
             rpc :ExportInstance, ::Google::Cloud::Redis::V1::ExportInstanceRequest, ::Google::Longrunning::Operation
-            # Initiates a failover of the master node to current replica node for a
+            # Initiates a failover of the primary node to current replica node for a
             # specific STANDARD tier Cloud Memorystore for Redis instance.
             rpc :FailoverInstance, ::Google::Cloud::Redis::V1::FailoverInstanceRequest, ::Google::Longrunning::Operation
             # Deletes a specific Redis instance.  Instance stops serving and data is

data/lib/google/cloud/redis/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Redis
       module V1
-        VERSION = "0.5.3"
+        VERSION = "0.6.0"
       end
     end
   end

data/proto_docs/google/cloud/redis/v1/cloud_redis.rb

@@ -21,6 +21,18 @@ module Google
   module Cloud
     module Redis
       module V1
+        # Node specific properties.
+        # @!attribute [r] id
+        #   @return [::String]
+        #     Output only. Node identifying string. e.g. 'node-0', 'node-1'
+        # @!attribute [r] zone
+        #   @return [::String]
+        #     Output only. Location of the node.
+        class NodeInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A Google Cloud Redis instance.
         # @!attribute [rw] name
         #   @return [::String]
@@ -42,15 +54,17 @@ module Google
         # @!attribute [rw] location_id
         #   @return [::String]
         #     Optional. The zone where the instance will be provisioned. If not provided,
-        #     the service will choose a zone for the instance. For STANDARD_HA tier,
-        #     instances will be created across two zones for protection against zonal
-        #     failures. If {::Google::Cloud::Redis::V1::Instance#alternative_location_id alternative_location_id} is also provided, it must be
-        #     different from {::Google::Cloud::Redis::V1::Instance#location_id location_id}.
+        #     the service will choose a zone from the specified region for the instance.
+        #     For standard tier, additional nodes will be added across multiple zones for
+        #     protection against zonal failures. If specified, at least one node will be
+        #     provisioned in this zone.
         # @!attribute [rw] alternative_location_id
         #   @return [::String]
-        #     Optional. Only applicable to STANDARD_HA tier which protects the instance
-        #     against zonal failures by provisioning it across two zones. If provided, it
-        #     must be a different zone from the one provided in {::Google::Cloud::Redis::V1::Instance#location_id location_id}.
+        #     Optional. If specified, at least one node will be provisioned in this zone
+        #     in addition to the zone specified in location_id. Only applicable to
+        #     standard tier. If provided, it must be a different zone from the one
+        #     provided in [location_id]. Additional nodes beyond the first 2 will be
+        #     placed in zones selected by the service.
         # @!attribute [rw] redis_version
         #   @return [::String]
         #     Optional. The version of Redis software.
@@ -60,12 +74,17 @@ module Google
         #      *   `REDIS_3_2` for Redis 3.2 compatibility
         #      *   `REDIS_4_0` for Redis 4.0 compatibility (default)
         #      *   `REDIS_5_0` for Redis 5.0 compatibility
+        #      *   `REDIS_6_X` for Redis 6.x compatibility
         # @!attribute [rw] reserved_ip_range
         #   @return [::String]
-        #     Optional. The CIDR range of internal addresses that are reserved for this
-        #     instance. If not provided, the service will choose an unused /29 block,
-        #     for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
-        #     and non-overlapping with existing subnets in an authorized network.
+        #     Optional. For DIRECT_PEERING mode, the CIDR range of internal addresses
+        #     that are reserved for this instance. Range must
+        #     be unique and non-overlapping with existing subnets in an authorized
+        #     network. For PRIVATE_SERVICE_ACCESS mode, the name of one allocated IP
+        #     address ranges associated with this private service access connection.
+        #     If not provided, the service will choose an unused /29 block, for
+        #     example, 10.0.0.0/29 or 192.168.0.0/29.  For READ_REPLICAS_ENABLED
+        #     the default block size is /28.
         # @!attribute [r] host
         #   @return [::String]
         #     Output only. Hostname or IP address of the exposed Redis endpoint used by
@@ -75,11 +94,9 @@ module Google
         #     Output only. The port number of the exposed Redis endpoint.
         # @!attribute [r] current_location_id
         #   @return [::String]
-        #     Output only. The current zone where the Redis endpoint is placed. For Basic
-        #     Tier instances, this will always be the same as the {::Google::Cloud::Redis::V1::Instance#location_id location_id}
-        #     provided by the user at creation time. For Standard Tier instances,
-        #     this can be either {::Google::Cloud::Redis::V1::Instance#location_id location_id} or {::Google::Cloud::Redis::V1::Instance#alternative_location_id alternative_location_id} and can
-        #     change after a failover event.
+        #     Output only. The current zone where the Redis primary node is located. In
+        #     basic tier, this will always be the same as [location_id]. In
+        #     standard tier, this can be the zone of any node in the instance.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The time the instance was created.
@@ -135,6 +152,27 @@ module Google
         #   @return [::Google::Cloud::Redis::V1::Instance::ConnectMode]
         #     Optional. The network connect mode of the Redis instance.
         #     If not provided, the connect mode defaults to DIRECT_PEERING.
+        # @!attribute [rw] replica_count
+        #   @return [::Integer]
+        #     Optional. The number of replica nodes. Valid range for standard tier
+        #     is [1-5] and defaults to 1. Valid value for basic tier is 0 and defaults
+        #     to 0.
+        # @!attribute [r] nodes
+        #   @return [::Array<::Google::Cloud::Redis::V1::NodeInfo>]
+        #     Output only. Info per node.
+        # @!attribute [r] read_endpoint
+        #   @return [::String]
+        #     Output only. Hostname or IP address of the exposed readonly Redis
+        #     endpoint. Standard tier only. Targets all healthy replica nodes in
+        #     instance. Replication is asynchronous and replica nodes will exhibit some
+        #     lag behind the primary. Write requests must target 'host'.
+        # @!attribute [r] read_endpoint_port
+        #   @return [::Integer]
+        #     Output only. The port number of the exposed readonly redis
+        #     endpoint. Standard tier only. Write requests should target 'port'.
+        # @!attribute [rw] read_replicas_mode
+        #   @return [::Google::Cloud::Redis::V1::Instance::ReadReplicasMode]
+        #     Optional. Read replica mode.
         class Instance
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -214,6 +252,21 @@ module Google
             # Google Cloud services, including Memorystore.
             PRIVATE_SERVICE_ACCESS = 2
           end
+
+          # Read replicas mode.
+          module ReadReplicasMode
+            # If not set, Memorystore Redis backend will pick the mode based on other fields in
+            # the request.
+            READ_REPLICAS_MODE_UNSPECIFIED = 0
+
+            # If disabled, read endpoint will not be provided and the instance cannot
+            # scale up or down the number of replicas.
+            READ_REPLICAS_DISABLED = 1
+
+            # If enabled, read endpoint will be provided and the instance can scale
+            # up and down the number of replicas.
+            READ_REPLICAS_ENABLED = 2
+          end
         end
 
         # Request for {::Google::Cloud::Redis::V1::CloudRedis::Client#list_instances ListInstances}.
@@ -248,11 +301,12 @@ module Google
         #
         #     If the `location_id` in the parent field of the request is "-", all regions
         #     available to the project are queried, and the results aggregated.
-        #     If in such an aggregated query a location is unavailable, a dummy Redis
-        #     entry is included in the response with the `name` field set to a value of
-        #     the form `projects/{project_id}/locations/{location_id}/instances/`- and
-        #     the `status` field set to ERROR and `status_message` field set to "location
-        #     not available for ListInstances".
+        #     If in such an aggregated query a location is unavailable, a placeholder
+        #     Redis entry is included in the response with the `name` field set to a
+        #     value of the form
+        #     `projects/{project_id}/locations/{location_id}/instances/`- and the
+        #     `status` field set to ERROR and `status_message` field set to "location not
+        #     available for ListInstances".
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     Token to retrieve the next page of results, or empty if there are no more
@@ -311,6 +365,7 @@ module Google
         #      *   `labels`
         #      *   `memorySizeGb`
         #      *   `redisConfig`
+        #      *   `replica_count`
         # @!attribute [rw] instance
         #   @return [::Google::Cloud::Redis::V1::Instance]
         #     Required. Update description.
@@ -432,7 +487,7 @@ module Google
 
             # Instance failover will be protected with data loss control. More
             # specifically, the failover will only be performed if the current
-            # replication offset diff between master and replica is under a certain
+            # replication offset diff between primary and replica is under a certain
             # threshold.
             LIMITED_DATA_LOSS = 1
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-redis-v1
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-11 00:00:00.000000000 Z
+date: 2021-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common