google-cloud-redis-v1 0.5.1 → 0.6.1

Sign up to get free protection for your applications and to get access to all the features.
@@ -21,6 +21,18 @@ module Google
21
21
  module Cloud
22
22
  module Redis
23
23
  module V1
24
+ # Node specific properties.
25
+ # @!attribute [r] id
26
+ # @return [::String]
27
+ # Output only. Node identifying string. e.g. 'node-0', 'node-1'
28
+ # @!attribute [r] zone
29
+ # @return [::String]
30
+ # Output only. Location of the node.
31
+ class NodeInfo
32
+ include ::Google::Protobuf::MessageExts
33
+ extend ::Google::Protobuf::MessageExts::ClassMethods
34
+ end
35
+
24
36
  # A Google Cloud Redis instance.
25
37
  # @!attribute [rw] name
26
38
  # @return [::String]
@@ -42,15 +54,17 @@ module Google
42
54
  # @!attribute [rw] location_id
43
55
  # @return [::String]
44
56
  # Optional. The zone where the instance will be provisioned. If not provided,
45
- # the service will choose a zone for the instance. For STANDARD_HA tier,
46
- # instances will be created across two zones for protection against zonal
47
- # failures. If {::Google::Cloud::Redis::V1::Instance#alternative_location_id alternative_location_id} is also provided, it must be
48
- # different from {::Google::Cloud::Redis::V1::Instance#location_id location_id}.
57
+ # the service will choose a zone from the specified region for the instance.
58
+ # For standard tier, additional nodes will be added across multiple zones for
59
+ # protection against zonal failures. If specified, at least one node will be
60
+ # provisioned in this zone.
49
61
  # @!attribute [rw] alternative_location_id
50
62
  # @return [::String]
51
- # Optional. Only applicable to STANDARD_HA tier which protects the instance
52
- # against zonal failures by provisioning it across two zones. If provided, it
53
- # must be a different zone from the one provided in {::Google::Cloud::Redis::V1::Instance#location_id location_id}.
63
+ # Optional. If specified, at least one node will be provisioned in this zone
64
+ # in addition to the zone specified in location_id. Only applicable to
65
+ # standard tier. If provided, it must be a different zone from the one
66
+ # provided in [location_id]. Additional nodes beyond the first 2 will be
67
+ # placed in zones selected by the service.
54
68
  # @!attribute [rw] redis_version
55
69
  # @return [::String]
56
70
  # Optional. The version of Redis software.
@@ -60,12 +74,17 @@ module Google
60
74
  # * `REDIS_3_2` for Redis 3.2 compatibility
61
75
  # * `REDIS_4_0` for Redis 4.0 compatibility (default)
62
76
  # * `REDIS_5_0` for Redis 5.0 compatibility
77
+ # * `REDIS_6_X` for Redis 6.x compatibility
63
78
  # @!attribute [rw] reserved_ip_range
64
79
  # @return [::String]
65
- # Optional. The CIDR range of internal addresses that are reserved for this
66
- # instance. If not provided, the service will choose an unused /29 block,
67
- # for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
68
- # and non-overlapping with existing subnets in an authorized network.
80
+ # Optional. For DIRECT_PEERING mode, the CIDR range of internal addresses
81
+ # that are reserved for this instance. Range must
82
+ # be unique and non-overlapping with existing subnets in an authorized
83
+ # network. For PRIVATE_SERVICE_ACCESS mode, the name of one allocated IP
84
+ # address ranges associated with this private service access connection.
85
+ # If not provided, the service will choose an unused /29 block, for
86
+ # example, 10.0.0.0/29 or 192.168.0.0/29. For READ_REPLICAS_ENABLED
87
+ # the default block size is /28.
69
88
  # @!attribute [r] host
70
89
  # @return [::String]
71
90
  # Output only. Hostname or IP address of the exposed Redis endpoint used by
@@ -75,11 +94,9 @@ module Google
75
94
  # Output only. The port number of the exposed Redis endpoint.
76
95
  # @!attribute [r] current_location_id
77
96
  # @return [::String]
78
- # Output only. The current zone where the Redis endpoint is placed. For Basic
79
- # Tier instances, this will always be the same as the {::Google::Cloud::Redis::V1::Instance#location_id location_id}
80
- # provided by the user at creation time. For Standard Tier instances,
81
- # 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
82
- # change after a failover event.
97
+ # Output only. The current zone where the Redis primary node is located. In
98
+ # basic tier, this will always be the same as [location_id]. In
99
+ # standard tier, this can be the zone of any node in the instance.
83
100
  # @!attribute [r] create_time
84
101
  # @return [::Google::Protobuf::Timestamp]
85
102
  # Output only. The time the instance was created.
@@ -135,6 +152,27 @@ module Google
135
152
  # @return [::Google::Cloud::Redis::V1::Instance::ConnectMode]
136
153
  # Optional. The network connect mode of the Redis instance.
137
154
  # If not provided, the connect mode defaults to DIRECT_PEERING.
155
+ # @!attribute [rw] replica_count
156
+ # @return [::Integer]
157
+ # Optional. The number of replica nodes. Valid range for standard tier
158
+ # is [1-5] and defaults to 1. Valid value for basic tier is 0 and defaults
159
+ # to 0.
160
+ # @!attribute [r] nodes
161
+ # @return [::Array<::Google::Cloud::Redis::V1::NodeInfo>]
162
+ # Output only. Info per node.
163
+ # @!attribute [r] read_endpoint
164
+ # @return [::String]
165
+ # Output only. Hostname or IP address of the exposed readonly Redis
166
+ # endpoint. Standard tier only. Targets all healthy replica nodes in
167
+ # instance. Replication is asynchronous and replica nodes will exhibit some
168
+ # lag behind the primary. Write requests must target 'host'.
169
+ # @!attribute [r] read_endpoint_port
170
+ # @return [::Integer]
171
+ # Output only. The port number of the exposed readonly redis
172
+ # endpoint. Standard tier only. Write requests should target 'port'.
173
+ # @!attribute [rw] read_replicas_mode
174
+ # @return [::Google::Cloud::Redis::V1::Instance::ReadReplicasMode]
175
+ # Optional. Read replica mode.
138
176
  class Instance
139
177
  include ::Google::Protobuf::MessageExts
140
178
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -214,6 +252,21 @@ module Google
214
252
  # Google Cloud services, including Memorystore.
215
253
  PRIVATE_SERVICE_ACCESS = 2
216
254
  end
255
+
256
+ # Read replicas mode.
257
+ module ReadReplicasMode
258
+ # If not set, Memorystore Redis backend will pick the mode based on other fields in
259
+ # the request.
260
+ READ_REPLICAS_MODE_UNSPECIFIED = 0
261
+
262
+ # If disabled, read endpoint will not be provided and the instance cannot
263
+ # scale up or down the number of replicas.
264
+ READ_REPLICAS_DISABLED = 1
265
+
266
+ # If enabled, read endpoint will be provided and the instance can scale
267
+ # up and down the number of replicas.
268
+ READ_REPLICAS_ENABLED = 2
269
+ end
217
270
  end
218
271
 
219
272
  # Request for {::Google::Cloud::Redis::V1::CloudRedis::Client#list_instances ListInstances}.
@@ -248,11 +301,12 @@ module Google
248
301
  #
249
302
  # If the `location_id` in the parent field of the request is "-", all regions
250
303
  # available to the project are queried, and the results aggregated.
251
- # If in such an aggregated query a location is unavailable, a dummy Redis
252
- # entry is included in the response with the `name` field set to a value of
253
- # the form `projects/{project_id}/locations/{location_id}/instances/`- and
254
- # the `status` field set to ERROR and `status_message` field set to "location
255
- # not available for ListInstances".
304
+ # If in such an aggregated query a location is unavailable, a placeholder
305
+ # Redis entry is included in the response with the `name` field set to a
306
+ # value of the form
307
+ # `projects/{project_id}/locations/{location_id}/instances/`- and the
308
+ # `status` field set to ERROR and `status_message` field set to "location not
309
+ # available for ListInstances".
256
310
  # @!attribute [rw] next_page_token
257
311
  # @return [::String]
258
312
  # Token to retrieve the next page of results, or empty if there are no more
@@ -311,6 +365,7 @@ module Google
311
365
  # * `labels`
312
366
  # * `memorySizeGb`
313
367
  # * `redisConfig`
368
+ # * `replica_count`
314
369
  # @!attribute [rw] instance
315
370
  # @return [::Google::Cloud::Redis::V1::Instance]
316
371
  # Required. Update description.
@@ -432,7 +487,7 @@ module Google
432
487
 
433
488
  # Instance failover will be protected with data loss control. More
434
489
  # specifically, the failover will only be performed if the current
435
- # replication offset diff between master and replica is under a certain
490
+ # replication offset diff between primary and replica is under a certain
436
491
  # threshold.
437
492
  LIMITED_DATA_LOSS = 1
438
493
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-redis-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.5.1
4
+ version: 0.6.1
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-06-17 00:00:00.000000000 Z
11
+ date: 2022-01-11 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.5'
19
+ version: '0.7'
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.5'
29
+ version: '0.7'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -209,7 +209,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
209
209
  - !ruby/object:Gem::Version
210
210
  version: '0'
211
211
  requirements: []
212
- rubygems_version: 3.2.17
212
+ rubygems_version: 3.3.4
213
213
  signing_key:
214
214
  specification_version: 4
215
215
  summary: API Client library for the Google Cloud Memorystore for Redis V1 API