google-cloud-redis 0.2.3 → 0.3.0

data/lib/google/cloud/redis/v1/cloud_redis_client_config.json

@@ -44,6 +44,11 @@
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
+        },
+        "FailoverInstance": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
         }
       }
     }

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

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/resource_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
@@ -36,6 +37,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :DELETING, 4
     value :REPAIRING, 5
     value :MAINTENANCE, 6
+    value :FAILING_OVER, 9
   end
   add_enum "google.cloud.redis.v1.Instance.Tier" do
     value :TIER_UNSPECIFIED, 0
@@ -50,6 +52,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.redis.v1.ListInstancesResponse" do
     repeated :instances, :message, 1, "google.cloud.redis.v1.Instance"
     optional :next_page_token, :string, 2
+    repeated :unreachable, :string, 3
   end
   add_message "google.cloud.redis.v1.GetInstanceRequest" do
     optional :name, :string, 1
@@ -66,6 +69,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.redis.v1.DeleteInstanceRequest" do
     optional :name, :string, 1
   end
+  add_message "google.cloud.redis.v1.FailoverInstanceRequest" do
+    optional :name, :string, 1
+    optional :data_protection_mode, :enum, 2, "google.cloud.redis.v1.FailoverInstanceRequest.DataProtectionMode"
+  end
+  add_enum "google.cloud.redis.v1.FailoverInstanceRequest.DataProtectionMode" do
+    value :DATA_PROTECTION_MODE_UNSPECIFIED, 0
+    value :LIMITED_DATA_LOSS, 1
+    value :FORCE_DATA_LOSS, 2
+  end
   add_message "google.cloud.redis.v1.OperationMetadata" do
     optional :create_time, :message, 1, "google.protobuf.Timestamp"
     optional :end_time, :message, 2, "google.protobuf.Timestamp"
@@ -95,6 +107,8 @@ module Google
         CreateInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.CreateInstanceRequest").msgclass
         UpdateInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.UpdateInstanceRequest").msgclass
         DeleteInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.DeleteInstanceRequest").msgclass
+        FailoverInstanceRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.FailoverInstanceRequest").msgclass
+        FailoverInstanceRequest::DataProtectionMode = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.FailoverInstanceRequest.DataProtectionMode").enummodule
         OperationMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.OperationMetadata").msgclass
         LocationMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.LocationMetadata").msgclass
         ZoneMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.redis.v1.ZoneMetadata").msgclass

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

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/cloud/redis/v1/cloud_redis.proto for package 'google.cloud.redis.v1'
 # Original file comments:
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+#
 
 
 require 'grpc'
@@ -38,7 +39,7 @@ module Google
           # * As such, Redis instances are resources of the form:
           #   `/projects/{project_id}/locations/{location_id}/instances/{instance_id}`
           #
-          # Note that location_id must be refering to a GCP `region`; for example:
+          # Note that location_id must be referring to a GCP `region`; for example:
           # * `projects/redpepper-1290/locations/us-central1/instances/my-redis`
           class Service
 
@@ -78,6 +79,9 @@ module Google
             # in the response field. The returned operation is automatically deleted
             # after a few hours, so there is no need to call DeleteOperation.
             rpc :UpdateInstance, UpdateInstanceRequest, Google::Longrunning::Operation
+            # Failover the master role to current replica node against a specific
+            # STANDARD tier redis instance.
+            rpc :FailoverInstance, FailoverInstanceRequest, Google::Longrunning::Operation
             # Deletes a specific Redis instance.  Instance stops serving and data is
             # deleted.
             rpc :DeleteInstance, DeleteInstanceRequest, Google::Longrunning::Operation

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -123,12 +123,14 @@ module Google
             # Redis instance is being deleted.
             DELETING = 4
 
-            # Redis instance is being repaired and may be unusable. Details can be
-            # found in the `status_message` field.
+            # Redis instance is being repaired and may be unusable.
             REPAIRING = 5
 
             # Maintenance is being performed on this Redis instance.
             MAINTENANCE = 6
+
+            # Redis instance is failing over (availability may be affected).
+            FAILING_OVER = 9
           end
 
           # Available service tiers to choose from
@@ -182,6 +184,9 @@ module Google
         #   @return [String]
         #     Token to retrieve the next page of results, or empty if there are no more
         #     results in the list.
+        # @!attribute [rw] unreachable
+        #   @return [Array<String>]
+        #     Locations that could not be reached.
         class ListInstancesResponse; end
 
         # Request for {Google::Cloud::Redis::V1::CloudRedis::GetInstance GetInstance}.
@@ -238,6 +243,31 @@ module Google
         #     where `location_id` refers to a GCP region
         class DeleteInstanceRequest; end
 
+        # Request for {Google::Cloud::Redis::V1::CloudRedis::FailoverInstance Failover}.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. Redis instance resource name using the form:
+        #         `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+        #     where `location_id` refers to a GCP region
+        # @!attribute [rw] data_protection_mode
+        #   @return [Google::Cloud::Redis::V1::FailoverInstanceRequest::DataProtectionMode]
+        #     Optional. Available data protection modes that the user can choose. If it's
+        #     unspecified, data protection mode will be LIMITED_DATA_LOSS by default.
+        class FailoverInstanceRequest
+          module DataProtectionMode
+            DATA_PROTECTION_MODE_UNSPECIFIED = 0
+
+            # 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
+            # threshold.
+            LIMITED_DATA_LOSS = 1
+
+            # Instance failover will be performed without data loss control.
+            FORCE_DATA_LOSS = 2
+          end
+        end
+
         # Represents the v1 metadata of the long-running operation.
         # @!attribute [rw] create_time
         #   @return [Google::Protobuf::Timestamp]

data/lib/google/cloud/redis/v1/doc/google/longrunning/operations.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -31,7 +31,7 @@ module Google
     # @!attribute [rw] done
     #   @return [true, false]
     #     If the value is `false`, it means the operation is still in progress.
-    #     If true, the operation is completed, and either `error` or `response` is
+    #     If `true`, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [Google::Rpc::Status]
@@ -47,47 +47,5 @@ module Google
     #     is `TakeSnapshot()`, the inferred response type is
     #     `TakeSnapshotResponse`.
     class Operation; end
-
-    # The request message for {Google::Longrunning::Operations::GetOperation Operations::GetOperation}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation resource.
-    class GetOperationRequest; end
-
-    # The request message for {Google::Longrunning::Operations::ListOperations Operations::ListOperations}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation collection.
-    # @!attribute [rw] filter
-    #   @return [String]
-    #     The standard list filter.
-    # @!attribute [rw] page_size
-    #   @return [Integer]
-    #     The standard list page size.
-    # @!attribute [rw] page_token
-    #   @return [String]
-    #     The standard list page token.
-    class ListOperationsRequest; end
-
-    # The response message for {Google::Longrunning::Operations::ListOperations Operations::ListOperations}.
-    # @!attribute [rw] operations
-    #   @return [Array<Google::Longrunning::Operation>]
-    #     A list of operations that matches the specified filter in the request.
-    # @!attribute [rw] next_page_token
-    #   @return [String]
-    #     The standard List next-page token.
-    class ListOperationsResponse; end
-
-    # The request message for {Google::Longrunning::Operations::CancelOperation Operations::CancelOperation}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation resource to be cancelled.
-    class CancelOperationRequest; end
-
-    # The request message for {Google::Longrunning::Operations::DeleteOperation Operations::DeleteOperation}.
-    # @!attribute [rw] name
-    #   @return [String]
-    #     The name of the operation resource to be deleted.
-    class DeleteOperationRequest; end
   end
 end

data/lib/google/cloud/redis/v1/doc/google/protobuf/any.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

data/lib/google/cloud/redis/v1/doc/google/protobuf/field_mask.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -83,57 +83,49 @@ module Google
     # describe the updated values, the API ignores the values of all
     # fields not covered by the mask.
     #
-    # If a repeated field is specified for an update operation, the existing
-    # repeated values in the target resource will be overwritten by the new values.
-    # Note that a repeated field is only allowed in the last position of a `paths`
-    # string.
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
     #
     # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then the existing sub-message in the target resource is
-    # overwritten. Given the target message:
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
     #
     #     f {
     #       b {
-    #         d : 1
-    #         x : 2
+    #         d: 1
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1]
     #     }
     #
     # And an update message:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
     #       }
+    #       c: [2]
     #     }
     #
     # then if the field mask is:
     #
-    #  paths: "f.b"
+    #  paths: ["f.b", "f.c"]
     #
     # then the result will be:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1, 2]
     #     }
     #
-    # However, if the update mask was:
-    #
-    #  paths: "f.b.d"
-    #
-    # then the result would be:
-    #
-    #     f {
-    #       b {
-    #         d : 10
-    #         x : 2
-    #       }
-    #       c : 1
-    #     }
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
     #
     # In order to reset a field's value to the default, the field must
     # be in the mask and set to the default value in the provided resource.

data/lib/google/cloud/redis/v1/doc/google/protobuf/timestamp.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,17 +15,19 @@
 
 module Google
   module Protobuf
-    # A Timestamp represents a point in time independent of any time zone
-    # or calendar, represented as seconds and fractions of seconds at
-    # nanosecond resolution in UTC Epoch time. It is encoded using the
-    # Proleptic Gregorian Calendar which extends the Gregorian calendar
-    # backwards to year one. It is encoded assuming all minutes are 60
-    # seconds long, i.e. leap seconds are "smeared" so that no leap second
-    # table is needed for interpretation. Range is from
-    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
-    # By restricting to that range, we ensure that we can convert to
-    # and from  RFC 3339 date strings.
-    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
     #
     # = Examples
     #
@@ -86,12 +88,12 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
     # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
     # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]

data/lib/google/cloud/redis/v1/doc/google/rpc/status.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,24 +15,25 @@
 
 module Google
   module Rpc
-    # The `Status` type defines a logical error model that is suitable for different
-    # programming environments, including REST APIs and RPC APIs. It is used by
-    # [gRPC](https://github.com/grpc). The error model is designed to be:
+    # The `Status` type defines a logical error model that is suitable for
+    # different programming environments, including REST APIs and RPC APIs. It is
+    # used by [gRPC](https://github.com/grpc). The error model is designed to be:
     #
     # * Simple to use and understand for most users
     # * Flexible enough to meet unexpected needs
     #
     # = Overview
     #
-    # The `Status` message contains three pieces of data: error code, error message,
-    # and error details. The error code should be an enum value of
-    # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
-    # error message should be a developer-facing English message that helps
-    # developers *understand* and *resolve* the error. If a localized user-facing
-    # error message is needed, put the localized message in the error details or
-    # localize it in the client. The optional error details may contain arbitrary
-    # information about the error. There is a predefined set of error detail types
-    # in the package `google.rpc` that can be used for common error conditions.
+    # The `Status` message contains three pieces of data: error code, error
+    # message, and error details. The error code should be an enum value of
+    # {Google::Rpc::Code}, but it may accept additional error codes
+    # if needed.  The error message should be a developer-facing English message
+    # that helps developers *understand* and *resolve* the error. If a localized
+    # user-facing error message is needed, put the localized message in the error
+    # details or localize it in the client. The optional error details may contain
+    # arbitrary information about the error. There is a predefined set of error
+    # detail types in the package `google.rpc` that can be used for common error
+    # conditions.
     #
     # = Language mapping
     #
@@ -69,12 +70,14 @@ module Google
     #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]
-    #     The status code, which should be an enum value of {Google::Rpc::Code}.
+    #     The status code, which should be an enum value of
+    #     {Google::Rpc::Code}.
     # @!attribute [rw] message
     #   @return [String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {Google::Rpc::Status#details} field, or localized by the client.
+    #     {Google::Rpc::Status#details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [Array<Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

data/lib/google/cloud/redis/v1beta1.rb

@@ -1,4 +1,4 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -25,8 +25,7 @@ module Google
       # # Ruby Client for Google Cloud Memorystore for Redis API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
       #
       # [Google Cloud Memorystore for Redis API][Product Documentation]:
-      # The Google Cloud Memorystore for Redis API is used for creating and managing
-      # Redis instances on the Google Cloud Platform.
+      # Creates and manages Redis instances on the Google Cloud Platform.
       # - [Product Documentation][]
       #
       # ## Quick Start