Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / a527de24cda7c7d62a371203158fd5f617a1c08c / . / docs / dyn / redis_v1.projects.locations.instances.html
blob: 8d2f2f67115d52c148fdbc389ae7170a6a555129 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="redis_v1.html">Google Cloud Memorystore for Redis API</a> . <a href="redis_v1.projects.html">projects</a> . <a href="redis_v1.projects.locations.html">locations</a> . <a href="redis_v1.projects.locations.instances.html">instances</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]78 <code><a href="#create">create(parent, body=None, instanceId=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]79<p class="firstline">Creates a Redis instance based on the specified tier and memory size.</p>
80<p class="toc_element">
81 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
82<p class="firstline">Deletes a specific Redis instance. Instance stops serving and data is</p>
83<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]84 <code><a href="#export">export(name, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]85<p class="firstline">Export Redis instance data into a Redis RDB format file in Cloud Storage.</p>
86<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]87 <code><a href="#failover">failover(name, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]88<p class="firstline">Initiates a failover of the master node to current replica node for a</p>
89<p class="toc_element">
90 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
91<p class="firstline">Gets the details of a specific Redis instance.</p>
92<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]93 <code><a href="#import_">import_(name, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]94<p class="firstline">Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.</p>
95<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]96 <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]97<p class="firstline">Lists all Redis instances owned by a project in either the specified</p>
98<p class="toc_element">
99 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
100<p class="firstline">Retrieves the next page of results.</p>
101<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]102 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]103<p class="firstline">Updates the metadata and configuration of a specific Redis instance.</p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]104<p class="toc_element">
105 <code><a href="#upgrade">upgrade(name, body=None, x__xgafv=None)</a></code></p>
106<p class="firstline">Upgrades Redis instance to the newer Redis version specified in the</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]107<h3>Method Details</h3>
108<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]109 <code class="details" id="create">create(parent, body=None, instanceId=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]110 <pre>Creates a Redis instance based on the specified tier and memory size.
111
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]112By default, the instance is accessible from the project&#x27;s
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]113[default network](https://cloud.google.com/vpc/docs/vpc).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]114
115The creation is executed asynchronously and callers may check the returned
116operation to track its progress. Once the operation is completed the Redis
117instance will be fully functional. Completed longrunning.Operation will
118contain the new instance object in the response field.
119
120The returned operation is automatically deleted after a few hours, so there
121is no need to call DeleteOperation.
122
123Args:
124 parent: string, Required. The resource name of the instance location using the form:
125 `projects/{project_id}/locations/{location_id}`
126where `location_id` refers to a GCP region. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]127 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]128 The object takes the form of:
129
130{ # A Google Cloud Redis instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]131 &quot;statusMessage&quot;: &quot;A String&quot;, # Output only. Additional information about the current status of this
132 # instance, if available.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]133 &quot;host&quot;: &quot;A String&quot;, # Output only. Hostname or IP address of the exposed Redis endpoint used by
134 # clients to connect to the service.
135 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the instance was created.
136 &quot;labels&quot;: { # Resource labels to represent user provided metadata
137 &quot;a_key&quot;: &quot;A String&quot;,
138 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]139 &quot;redisConfigs&quot;: { # Optional. Redis configuration parameters, according to
140 # http://redis.io/topics/config. Currently, the only supported parameters
141 # are:
142 #
143 # Redis version 3.2 and newer:
144 #
145 # * maxmemory-policy
146 # * notify-keyspace-events
147 #
148 # Redis version 4.0 and newer:
149 #
150 # * activedefrag
151 # * lfu-decay-time
152 # * lfu-log-factor
153 # * maxmemory-gb
154 #
155 # Redis version 5.0 and newer:
156 #
157 # * stream-node-max-bytes
158 # * stream-node-max-entries
159 &quot;a_key&quot;: &quot;A String&quot;,
160 },
161 &quot;port&quot;: 42, # Output only. The port number of the exposed Redis endpoint.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]162 &quot;authorizedNetwork&quot;: &quot;A String&quot;, # Optional. The full name of the Google Compute Engine
163 # [network](https://cloud.google.com/vpc/docs/vpc) to which the
164 # instance is connected. If left unspecified, the `default` network
165 # will be used.
166 &quot;currentLocationId&quot;: &quot;A String&quot;, # Output only. The current zone where the Redis endpoint is placed. For Basic
167 # Tier instances, this will always be the same as the location_id
168 # provided by the user at creation time. For Standard Tier instances,
169 # this can be either location_id or alternative_location_id and can
170 # change after a failover event.
171 &quot;connectMode&quot;: &quot;A String&quot;, # Optional. The network connect mode of the Redis instance.
172 # If not provided, the connect mode defaults to DIRECT_PEERING.
173 &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional. The CIDR range of internal addresses that are reserved for this
174 # instance. If not provided, the service will choose an unused /29 block,
175 # for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
176 # and non-overlapping with existing subnets in an authorized network.
177 &quot;persistenceIamIdentity&quot;: &quot;A String&quot;, # Output only. Cloud IAM identity used by import / export operations to
178 # transfer data to/from Cloud Storage. Format is
179 # &quot;serviceAccount:&lt;service_account_email&gt;&quot;. The value may change over time
180 # for a given instance so should be checked before each import/export
181 # operation.
182 &quot;name&quot;: &quot;A String&quot;, # Required. Unique name of the resource in this scope including project and
183 # location using the form:
184 # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
185 #
186 # Note: Redis instances are managed and addressed at regional level so
187 # location_id here refers to a GCP region; however, users may choose which
188 # specific zone (or collection of zones for cross-zone instances) an instance
189 # should be provisioned in. Refer to location_id and
190 # alternative_location_id fields for more details.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]191 &quot;redisVersion&quot;: &quot;A String&quot;, # Optional. The version of Redis software.
192 # If not provided, latest supported version will be used. Currently, the
193 # supported values are:
194 #
195 # * `REDIS_3_2` for Redis 3.2 compatibility
196 # * `REDIS_4_0` for Redis 4.0 compatibility (default)
197 # * `REDIS_5_0` for Redis 5.0 compatibility
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]198 &quot;memorySizeGb&quot;: 42, # Required. Redis memory size in GiB.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]199 &quot;alternativeLocationId&quot;: &quot;A String&quot;, # Optional. Only applicable to STANDARD_HA tier which protects the instance
200 # against zonal failures by provisioning it across two zones. If provided, it
201 # must be a different zone from the one provided in location_id.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]202 &quot;tier&quot;: &quot;A String&quot;, # Required. The service tier of the instance.
203 &quot;displayName&quot;: &quot;A String&quot;, # An arbitrary and optional user-provided name for the instance.
204 &quot;locationId&quot;: &quot;A String&quot;, # Optional. The zone where the instance will be provisioned. If not provided,
205 # the service will choose a zone for the instance. For STANDARD_HA tier,
206 # instances will be created across two zones for protection against zonal
207 # failures. If alternative_location_id is also provided, it must be
208 # different from location_id.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]209 &quot;state&quot;: &quot;A String&quot;, # Output only. The current state of this instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]210 }
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]211
212 instanceId: string, Required. The logical name of the Redis instance in the customer project
213with the following restrictions:
214
215* Must contain only lowercase letters, numbers, and hyphens.
216* Must start with a letter.
217* Must be between 1-40 characters.
218* Must end with a number or a letter.
219* Must be unique within the customer project / location
220 x__xgafv: string, V1 error format.
221 Allowed values
222 1 - v1 error format
223 2 - v2 error format
224
225Returns:
226 An object of the form:
227
228 { # This resource represents a long-running operation that is the result of a
229 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]230 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
231 # originally returns it. If you use the default HTTP mapping, the
232 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]233 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
234 # method returns no data on success, such as `Delete`, the response is
235 # `google.protobuf.Empty`. If the original method is standard
236 # `Get`/`Create`/`Update`, the response should be the resource. For other
237 # methods, the response should have the type `XxxResponse`, where `Xxx`
238 # is the original method name. For example, if the original method name
239 # is `TakeSnapshot()`, the inferred response type is
240 # `TakeSnapshotResponse`.
241 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
242 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]243 &quot;metadata&quot;: { # {
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]244 #
245 # `createTime`: The time the operation was created.
246 #
247 # `endTime`: The time the operation finished running.
248 #
249 # `target`: Server-defined resource path for the target of the operation.
250 #
251 # `verb`: Name of the verb executed by the operation.
252 #
253 # `statusDetail`: Human-readable status of the operation, if any.
254 #
255 # `cancelRequested`: Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
256 #
257 # `apiVersion`: API version used to start the operation.
258 #
259 # }
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]260 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]261 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]262 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
263 # different programming environments, including REST APIs and RPC APIs. It is
264 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
265 # three pieces of data: error code, error message, and error details.
266 #
267 # You can find out more about this error model and how to work with it in the
268 # [API Design Guide](https://cloud.google.com/apis/design/errors).
269 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
270 # user-facing error message should be localized and sent in the
271 # google.rpc.Status.details field, or localized by the client.
272 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
273 # message types for APIs to use.
274 {
275 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
276 },
277 ],
278 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
279 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]280 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]281 # If `true`, the operation is completed, and either `error` or `response` is
282 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]283 }</pre>
284</div>
285
286<div class="method">
287 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
288 <pre>Deletes a specific Redis instance. Instance stops serving and data is
289deleted.
290
291Args:
292 name: string, Required. Redis instance resource name using the form:
293 `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
294where `location_id` refers to a GCP region. (required)
295 x__xgafv: string, V1 error format.
296 Allowed values
297 1 - v1 error format
298 2 - v2 error format
299
300Returns:
301 An object of the form:
302
303 { # This resource represents a long-running operation that is the result of a
304 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]305 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
306 # originally returns it. If you use the default HTTP mapping, the
307 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]308 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
309 # method returns no data on success, such as `Delete`, the response is
310 # `google.protobuf.Empty`. If the original method is standard
311 # `Get`/`Create`/`Update`, the response should be the resource. For other
312 # methods, the response should have the type `XxxResponse`, where `Xxx`
313 # is the original method name. For example, if the original method name
314 # is `TakeSnapshot()`, the inferred response type is
315 # `TakeSnapshotResponse`.
316 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
317 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]318 &quot;metadata&quot;: { # {
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]319 #
320 # `createTime`: The time the operation was created.
321 #
322 # `endTime`: The time the operation finished running.
323 #
324 # `target`: Server-defined resource path for the target of the operation.
325 #
326 # `verb`: Name of the verb executed by the operation.
327 #
328 # `statusDetail`: Human-readable status of the operation, if any.
329 #
330 # `cancelRequested`: Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
331 #
332 # `apiVersion`: API version used to start the operation.
333 #
334 # }
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]335 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]336 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]337 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
338 # different programming environments, including REST APIs and RPC APIs. It is
339 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
340 # three pieces of data: error code, error message, and error details.
341 #
342 # You can find out more about this error model and how to work with it in the
343 # [API Design Guide](https://cloud.google.com/apis/design/errors).
344 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
345 # user-facing error message should be localized and sent in the
346 # google.rpc.Status.details field, or localized by the client.
347 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
348 # message types for APIs to use.
349 {
350 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
351 },
352 ],
353 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
354 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]355 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]356 # If `true`, the operation is completed, and either `error` or `response` is
357 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]358 }</pre>
359</div>
360
361<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]362 <code class="details" id="export">export(name, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]363 <pre>Export Redis instance data into a Redis RDB format file in Cloud Storage.
364
365Redis will continue serving during this operation.
366
367The returned operation is automatically deleted after a few hours, so
368there is no need to call DeleteOperation.
369
370Args:
371 name: string, Required. Redis instance resource name using the form:
372 `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
373where `location_id` refers to a GCP region. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]374 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]375 The object takes the form of:
376
377{ # Request for Export.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]378 &quot;outputConfig&quot;: { # The output content # Required. Specify data to be exported.
379 &quot;gcsDestination&quot;: { # The Cloud Storage location for the output content # Google Cloud Storage destination for output content.
380 &quot;uri&quot;: &quot;A String&quot;, # Required. Data destination URI (e.g.
381 # &#x27;gs://my_bucket/my_object&#x27;). Existing files will be overwritten.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]382 },
383 },
384 }
385
386 x__xgafv: string, V1 error format.
387 Allowed values
388 1 - v1 error format
389 2 - v2 error format
390
391Returns:
392 An object of the form:
393
394 { # This resource represents a long-running operation that is the result of a
395 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]396 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
397 # originally returns it. If you use the default HTTP mapping, the
398 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]399 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
400 # method returns no data on success, such as `Delete`, the response is
401 # `google.protobuf.Empty`. If the original method is standard
402 # `Get`/`Create`/`Update`, the response should be the resource. For other
403 # methods, the response should have the type `XxxResponse`, where `Xxx`
404 # is the original method name. For example, if the original method name
405 # is `TakeSnapshot()`, the inferred response type is
406 # `TakeSnapshotResponse`.
407 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
408 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]409 &quot;metadata&quot;: { # {
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]410 #
411 # `createTime`: The time the operation was created.
412 #
413 # `endTime`: The time the operation finished running.
414 #
415 # `target`: Server-defined resource path for the target of the operation.
416 #
417 # `verb`: Name of the verb executed by the operation.
418 #
419 # `statusDetail`: Human-readable status of the operation, if any.
420 #
421 # `cancelRequested`: Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
422 #
423 # `apiVersion`: API version used to start the operation.
424 #
425 # }
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]426 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]427 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]428 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
429 # different programming environments, including REST APIs and RPC APIs. It is
430 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
431 # three pieces of data: error code, error message, and error details.
432 #
433 # You can find out more about this error model and how to work with it in the
434 # [API Design Guide](https://cloud.google.com/apis/design/errors).
435 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
436 # user-facing error message should be localized and sent in the
437 # google.rpc.Status.details field, or localized by the client.
438 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
439 # message types for APIs to use.
440 {
441 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
442 },
443 ],
444 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
445 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]446 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]447 # If `true`, the operation is completed, and either `error` or `response` is
448 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]449 }</pre>
450</div>
451
452<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]453 <code class="details" id="failover">failover(name, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]454 <pre>Initiates a failover of the master node to current replica node for a
455specific STANDARD tier Cloud Memorystore for Redis instance.
456
457Args:
458 name: string, Required. Redis instance resource name using the form:
459 `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
460where `location_id` refers to a GCP region. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]461 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]462 The object takes the form of:
463
464{ # Request for Failover.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]465 &quot;dataProtectionMode&quot;: &quot;A String&quot;, # Optional. Available data protection modes that the user can choose. If it&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]466 # unspecified, data protection mode will be LIMITED_DATA_LOSS by default.
467 }
468
469 x__xgafv: string, V1 error format.
470 Allowed values
471 1 - v1 error format
472 2 - v2 error format
473
474Returns:
475 An object of the form:
476
477 { # This resource represents a long-running operation that is the result of a
478 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]479 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
480 # originally returns it. If you use the default HTTP mapping, the
481 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]482 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
483 # method returns no data on success, such as `Delete`, the response is
484 # `google.protobuf.Empty`. If the original method is standard
485 # `Get`/`Create`/`Update`, the response should be the resource. For other
486 # methods, the response should have the type `XxxResponse`, where `Xxx`
487 # is the original method name. For example, if the original method name
488 # is `TakeSnapshot()`, the inferred response type is
489 # `TakeSnapshotResponse`.
490 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
491 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]492 &quot;metadata&quot;: { # {
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]493 #
494 # `createTime`: The time the operation was created.
495 #
496 # `endTime`: The time the operation finished running.
497 #
498 # `target`: Server-defined resource path for the target of the operation.
499 #
500 # `verb`: Name of the verb executed by the operation.
501 #
502 # `statusDetail`: Human-readable status of the operation, if any.
503 #
504 # `cancelRequested`: Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
505 #
506 # `apiVersion`: API version used to start the operation.
507 #
508 # }
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]509 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]510 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]511 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
512 # different programming environments, including REST APIs and RPC APIs. It is
513 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
514 # three pieces of data: error code, error message, and error details.
515 #
516 # You can find out more about this error model and how to work with it in the
517 # [API Design Guide](https://cloud.google.com/apis/design/errors).
518 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
519 # user-facing error message should be localized and sent in the
520 # google.rpc.Status.details field, or localized by the client.
521 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
522 # message types for APIs to use.
523 {
524 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
525 },
526 ],
527 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
528 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]529 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]530 # If `true`, the operation is completed, and either `error` or `response` is
531 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]532 }</pre>
533</div>
534
535<div class="method">
536 <code class="details" id="get">get(name, x__xgafv=None)</code>
537 <pre>Gets the details of a specific Redis instance.
538
539Args:
540 name: string, Required. Redis instance resource name using the form:
541 `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
542where `location_id` refers to a GCP region. (required)
543 x__xgafv: string, V1 error format.
544 Allowed values
545 1 - v1 error format
546 2 - v2 error format
547
548Returns:
549 An object of the form:
550
551 { # A Google Cloud Redis instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]552 &quot;statusMessage&quot;: &quot;A String&quot;, # Output only. Additional information about the current status of this
553 # instance, if available.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]554 &quot;host&quot;: &quot;A String&quot;, # Output only. Hostname or IP address of the exposed Redis endpoint used by
555 # clients to connect to the service.
556 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the instance was created.
557 &quot;labels&quot;: { # Resource labels to represent user provided metadata
558 &quot;a_key&quot;: &quot;A String&quot;,
559 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]560 &quot;redisConfigs&quot;: { # Optional. Redis configuration parameters, according to
561 # http://redis.io/topics/config. Currently, the only supported parameters
562 # are:
563 #
564 # Redis version 3.2 and newer:
565 #
566 # * maxmemory-policy
567 # * notify-keyspace-events
568 #
569 # Redis version 4.0 and newer:
570 #
571 # * activedefrag
572 # * lfu-decay-time
573 # * lfu-log-factor
574 # * maxmemory-gb
575 #
576 # Redis version 5.0 and newer:
577 #
578 # * stream-node-max-bytes
579 # * stream-node-max-entries
580 &quot;a_key&quot;: &quot;A String&quot;,
581 },
582 &quot;port&quot;: 42, # Output only. The port number of the exposed Redis endpoint.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]583 &quot;authorizedNetwork&quot;: &quot;A String&quot;, # Optional. The full name of the Google Compute Engine
584 # [network](https://cloud.google.com/vpc/docs/vpc) to which the
585 # instance is connected. If left unspecified, the `default` network
586 # will be used.
587 &quot;currentLocationId&quot;: &quot;A String&quot;, # Output only. The current zone where the Redis endpoint is placed. For Basic
588 # Tier instances, this will always be the same as the location_id
589 # provided by the user at creation time. For Standard Tier instances,
590 # this can be either location_id or alternative_location_id and can
591 # change after a failover event.
592 &quot;connectMode&quot;: &quot;A String&quot;, # Optional. The network connect mode of the Redis instance.
593 # If not provided, the connect mode defaults to DIRECT_PEERING.
594 &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional. The CIDR range of internal addresses that are reserved for this
595 # instance. If not provided, the service will choose an unused /29 block,
596 # for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
597 # and non-overlapping with existing subnets in an authorized network.
598 &quot;persistenceIamIdentity&quot;: &quot;A String&quot;, # Output only. Cloud IAM identity used by import / export operations to
599 # transfer data to/from Cloud Storage. Format is
600 # &quot;serviceAccount:&lt;service_account_email&gt;&quot;. The value may change over time
601 # for a given instance so should be checked before each import/export
602 # operation.
603 &quot;name&quot;: &quot;A String&quot;, # Required. Unique name of the resource in this scope including project and
604 # location using the form:
605 # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
606 #
607 # Note: Redis instances are managed and addressed at regional level so
608 # location_id here refers to a GCP region; however, users may choose which
609 # specific zone (or collection of zones for cross-zone instances) an instance
610 # should be provisioned in. Refer to location_id and
611 # alternative_location_id fields for more details.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]612 &quot;redisVersion&quot;: &quot;A String&quot;, # Optional. The version of Redis software.
613 # If not provided, latest supported version will be used. Currently, the
614 # supported values are:
615 #
616 # * `REDIS_3_2` for Redis 3.2 compatibility
617 # * `REDIS_4_0` for Redis 4.0 compatibility (default)
618 # * `REDIS_5_0` for Redis 5.0 compatibility
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]619 &quot;memorySizeGb&quot;: 42, # Required. Redis memory size in GiB.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]620 &quot;alternativeLocationId&quot;: &quot;A String&quot;, # Optional. Only applicable to STANDARD_HA tier which protects the instance
621 # against zonal failures by provisioning it across two zones. If provided, it
622 # must be a different zone from the one provided in location_id.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]623 &quot;tier&quot;: &quot;A String&quot;, # Required. The service tier of the instance.
624 &quot;displayName&quot;: &quot;A String&quot;, # An arbitrary and optional user-provided name for the instance.
625 &quot;locationId&quot;: &quot;A String&quot;, # Optional. The zone where the instance will be provisioned. If not provided,
626 # the service will choose a zone for the instance. For STANDARD_HA tier,
627 # instances will be created across two zones for protection against zonal
628 # failures. If alternative_location_id is also provided, it must be
629 # different from location_id.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]630 &quot;state&quot;: &quot;A String&quot;, # Output only. The current state of this instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]631 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]632</div>
633
634<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]635 <code class="details" id="import_">import_(name, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]636 <pre>Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
637
638Redis may stop serving during this operation. Instance state will be
639IMPORTING for entire operation. When complete, the instance will contain
640only data from the imported file.
641
642The returned operation is automatically deleted after a few hours, so
643there is no need to call DeleteOperation.
644
645Args:
646 name: string, Required. Redis instance resource name using the form:
647 `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
648where `location_id` refers to a GCP region. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]649 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]650 The object takes the form of:
651
652{ # Request for Import.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]653 &quot;inputConfig&quot;: { # The input content # Required. Specify data to be imported.
654 &quot;gcsSource&quot;: { # The Cloud Storage location for the input content # Google Cloud Storage location where input content is located.
655 &quot;uri&quot;: &quot;A String&quot;, # Required. Source data URI. (e.g. &#x27;gs://my_bucket/my_object&#x27;).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]656 },
657 },
658 }
659
660 x__xgafv: string, V1 error format.
661 Allowed values
662 1 - v1 error format
663 2 - v2 error format
664
665Returns:
666 An object of the form:
667
668 { # This resource represents a long-running operation that is the result of a
669 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]670 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
671 # originally returns it. If you use the default HTTP mapping, the
672 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]673 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
674 # method returns no data on success, such as `Delete`, the response is
675 # `google.protobuf.Empty`. If the original method is standard
676 # `Get`/`Create`/`Update`, the response should be the resource. For other
677 # methods, the response should have the type `XxxResponse`, where `Xxx`
678 # is the original method name. For example, if the original method name
679 # is `TakeSnapshot()`, the inferred response type is
680 # `TakeSnapshotResponse`.
681 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
682 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]683 &quot;metadata&quot;: { # {
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]684 #
685 # `createTime`: The time the operation was created.
686 #
687 # `endTime`: The time the operation finished running.
688 #
689 # `target`: Server-defined resource path for the target of the operation.
690 #
691 # `verb`: Name of the verb executed by the operation.
692 #
693 # `statusDetail`: Human-readable status of the operation, if any.
694 #
695 # `cancelRequested`: Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
696 #
697 # `apiVersion`: API version used to start the operation.
698 #
699 # }
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]700 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]701 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]702 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
703 # different programming environments, including REST APIs and RPC APIs. It is
704 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
705 # three pieces of data: error code, error message, and error details.
706 #
707 # You can find out more about this error model and how to work with it in the
708 # [API Design Guide](https://cloud.google.com/apis/design/errors).
709 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
710 # user-facing error message should be localized and sent in the
711 # google.rpc.Status.details field, or localized by the client.
712 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
713 # message types for APIs to use.
714 {
715 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
716 },
717 ],
718 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
719 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]720 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]721 # If `true`, the operation is completed, and either `error` or `response` is
722 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]723 }</pre>
724</div>
725
726<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]727 <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]728 <pre>Lists all Redis instances owned by a project in either the specified
729location (region) or all locations.
730
731The location should have the following format:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]732
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]733* `projects/{project_id}/locations/{location_id}`
734
735If `location_id` is specified as `-` (wildcard), then all regions
736available to the project are queried, and the results are aggregated.
737
738Args:
739 parent: string, Required. The resource name of the instance location using the form:
740 `projects/{project_id}/locations/{location_id}`
741where `location_id` refers to a GCP region. (required)
742 pageSize: integer, The maximum number of items to return.
743
744If not specified, a default value of 1000 will be used by the service.
745Regardless of the page_size value, the response may include a partial list
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]746and a caller should only rely on response&#x27;s
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]747`next_page_token`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]748to determine if there are more instances left to be queried.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]749 pageToken: string, The `next_page_token` value returned from a previous
750ListInstances request, if any.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]751 x__xgafv: string, V1 error format.
752 Allowed values
753 1 - v1 error format
754 2 - v2 error format
755
756Returns:
757 An object of the form:
758
759 { # Response for ListInstances.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]760 &quot;unreachable&quot;: [ # Locations that could not be reached.
761 &quot;A String&quot;,
762 ],
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]763 &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no more
764 # results in the list.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]765 &quot;instances&quot;: [ # A list of Redis instances in the project in the specified location,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]766 # or across all locations.
767 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]768 # If the `location_id` in the parent field of the request is &quot;-&quot;, all regions
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]769 # available to the project are queried, and the results aggregated.
770 # If in such an aggregated query a location is unavailable, a dummy Redis
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]771 # entry is included in the response with the `name` field set to a value of
772 # the form `projects/{project_id}/locations/{location_id}/instances/`- and
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]773 # the `status` field set to ERROR and `status_message` field set to &quot;location
774 # not available for ListInstances&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]775 { # A Google Cloud Redis instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]776 &quot;statusMessage&quot;: &quot;A String&quot;, # Output only. Additional information about the current status of this
777 # instance, if available.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]778 &quot;host&quot;: &quot;A String&quot;, # Output only. Hostname or IP address of the exposed Redis endpoint used by
779 # clients to connect to the service.
780 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the instance was created.
781 &quot;labels&quot;: { # Resource labels to represent user provided metadata
782 &quot;a_key&quot;: &quot;A String&quot;,
783 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]784 &quot;redisConfigs&quot;: { # Optional. Redis configuration parameters, according to
785 # http://redis.io/topics/config. Currently, the only supported parameters
786 # are:
787 #
788 # Redis version 3.2 and newer:
789 #
790 # * maxmemory-policy
791 # * notify-keyspace-events
792 #
793 # Redis version 4.0 and newer:
794 #
795 # * activedefrag
796 # * lfu-decay-time
797 # * lfu-log-factor
798 # * maxmemory-gb
799 #
800 # Redis version 5.0 and newer:
801 #
802 # * stream-node-max-bytes
803 # * stream-node-max-entries
804 &quot;a_key&quot;: &quot;A String&quot;,
805 },
806 &quot;port&quot;: 42, # Output only. The port number of the exposed Redis endpoint.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]807 &quot;authorizedNetwork&quot;: &quot;A String&quot;, # Optional. The full name of the Google Compute Engine
808 # [network](https://cloud.google.com/vpc/docs/vpc) to which the
809 # instance is connected. If left unspecified, the `default` network
810 # will be used.
811 &quot;currentLocationId&quot;: &quot;A String&quot;, # Output only. The current zone where the Redis endpoint is placed. For Basic
812 # Tier instances, this will always be the same as the location_id
813 # provided by the user at creation time. For Standard Tier instances,
814 # this can be either location_id or alternative_location_id and can
815 # change after a failover event.
816 &quot;connectMode&quot;: &quot;A String&quot;, # Optional. The network connect mode of the Redis instance.
817 # If not provided, the connect mode defaults to DIRECT_PEERING.
818 &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional. The CIDR range of internal addresses that are reserved for this
819 # instance. If not provided, the service will choose an unused /29 block,
820 # for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
821 # and non-overlapping with existing subnets in an authorized network.
822 &quot;persistenceIamIdentity&quot;: &quot;A String&quot;, # Output only. Cloud IAM identity used by import / export operations to
823 # transfer data to/from Cloud Storage. Format is
824 # &quot;serviceAccount:&lt;service_account_email&gt;&quot;. The value may change over time
825 # for a given instance so should be checked before each import/export
826 # operation.
827 &quot;name&quot;: &quot;A String&quot;, # Required. Unique name of the resource in this scope including project and
828 # location using the form:
829 # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
830 #
831 # Note: Redis instances are managed and addressed at regional level so
832 # location_id here refers to a GCP region; however, users may choose which
833 # specific zone (or collection of zones for cross-zone instances) an instance
834 # should be provisioned in. Refer to location_id and
835 # alternative_location_id fields for more details.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]836 &quot;redisVersion&quot;: &quot;A String&quot;, # Optional. The version of Redis software.
837 # If not provided, latest supported version will be used. Currently, the
838 # supported values are:
839 #
840 # * `REDIS_3_2` for Redis 3.2 compatibility
841 # * `REDIS_4_0` for Redis 4.0 compatibility (default)
842 # * `REDIS_5_0` for Redis 5.0 compatibility
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]843 &quot;memorySizeGb&quot;: 42, # Required. Redis memory size in GiB.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]844 &quot;alternativeLocationId&quot;: &quot;A String&quot;, # Optional. Only applicable to STANDARD_HA tier which protects the instance
845 # against zonal failures by provisioning it across two zones. If provided, it
846 # must be a different zone from the one provided in location_id.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]847 &quot;tier&quot;: &quot;A String&quot;, # Required. The service tier of the instance.
848 &quot;displayName&quot;: &quot;A String&quot;, # An arbitrary and optional user-provided name for the instance.
849 &quot;locationId&quot;: &quot;A String&quot;, # Optional. The zone where the instance will be provisioned. If not provided,
850 # the service will choose a zone for the instance. For STANDARD_HA tier,
851 # instances will be created across two zones for protection against zonal
852 # failures. If alternative_location_id is also provided, it must be
853 # different from location_id.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]854 &quot;state&quot;: &quot;A String&quot;, # Output only. The current state of this instance.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]855 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]856 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]857 }</pre>
858</div>
859
860<div class="method">
861 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
862 <pre>Retrieves the next page of results.
863
864Args:
865 previous_request: The request for the previous page. (required)
866 previous_response: The response from the request for the previous page. (required)
867
868Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]869 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]870 page. Returns None if there are no more items in the collection.
871 </pre>
872</div>
873
874<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]875 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]876 <pre>Updates the metadata and configuration of a specific Redis instance.
877
878Completed longrunning.Operation will contain the new instance object
879in the response field. The returned operation is automatically deleted
880after a few hours, so there is no need to call DeleteOperation.
881
882Args:
883 name: string, Required. Unique name of the resource in this scope including project and
884location using the form:
885 `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
886
887Note: Redis instances are managed and addressed at regional level so
888location_id here refers to a GCP region; however, users may choose which
889specific zone (or collection of zones for cross-zone instances) an instance
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]890should be provisioned in. Refer to location_id and
891alternative_location_id fields for more details. (required)
892 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]893 The object takes the form of:
894
895{ # A Google Cloud Redis instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]896 &quot;statusMessage&quot;: &quot;A String&quot;, # Output only. Additional information about the current status of this
897 # instance, if available.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]898 &quot;host&quot;: &quot;A String&quot;, # Output only. Hostname or IP address of the exposed Redis endpoint used by
899 # clients to connect to the service.
900 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the instance was created.
901 &quot;labels&quot;: { # Resource labels to represent user provided metadata
902 &quot;a_key&quot;: &quot;A String&quot;,
903 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]904 &quot;redisConfigs&quot;: { # Optional. Redis configuration parameters, according to
905 # http://redis.io/topics/config. Currently, the only supported parameters
906 # are:
907 #
908 # Redis version 3.2 and newer:
909 #
910 # * maxmemory-policy
911 # * notify-keyspace-events
912 #
913 # Redis version 4.0 and newer:
914 #
915 # * activedefrag
916 # * lfu-decay-time
917 # * lfu-log-factor
918 # * maxmemory-gb
919 #
920 # Redis version 5.0 and newer:
921 #
922 # * stream-node-max-bytes
923 # * stream-node-max-entries
924 &quot;a_key&quot;: &quot;A String&quot;,
925 },
926 &quot;port&quot;: 42, # Output only. The port number of the exposed Redis endpoint.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]927 &quot;authorizedNetwork&quot;: &quot;A String&quot;, # Optional. The full name of the Google Compute Engine
928 # [network](https://cloud.google.com/vpc/docs/vpc) to which the
929 # instance is connected. If left unspecified, the `default` network
930 # will be used.
931 &quot;currentLocationId&quot;: &quot;A String&quot;, # Output only. The current zone where the Redis endpoint is placed. For Basic
932 # Tier instances, this will always be the same as the location_id
933 # provided by the user at creation time. For Standard Tier instances,
934 # this can be either location_id or alternative_location_id and can
935 # change after a failover event.
936 &quot;connectMode&quot;: &quot;A String&quot;, # Optional. The network connect mode of the Redis instance.
937 # If not provided, the connect mode defaults to DIRECT_PEERING.
938 &quot;reservedIpRange&quot;: &quot;A String&quot;, # Optional. The CIDR range of internal addresses that are reserved for this
939 # instance. If not provided, the service will choose an unused /29 block,
940 # for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
941 # and non-overlapping with existing subnets in an authorized network.
942 &quot;persistenceIamIdentity&quot;: &quot;A String&quot;, # Output only. Cloud IAM identity used by import / export operations to
943 # transfer data to/from Cloud Storage. Format is
944 # &quot;serviceAccount:&lt;service_account_email&gt;&quot;. The value may change over time
945 # for a given instance so should be checked before each import/export
946 # operation.
947 &quot;name&quot;: &quot;A String&quot;, # Required. Unique name of the resource in this scope including project and
948 # location using the form:
949 # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
950 #
951 # Note: Redis instances are managed and addressed at regional level so
952 # location_id here refers to a GCP region; however, users may choose which
953 # specific zone (or collection of zones for cross-zone instances) an instance
954 # should be provisioned in. Refer to location_id and
955 # alternative_location_id fields for more details.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]956 &quot;redisVersion&quot;: &quot;A String&quot;, # Optional. The version of Redis software.
957 # If not provided, latest supported version will be used. Currently, the
958 # supported values are:
959 #
960 # * `REDIS_3_2` for Redis 3.2 compatibility
961 # * `REDIS_4_0` for Redis 4.0 compatibility (default)
962 # * `REDIS_5_0` for Redis 5.0 compatibility
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]963 &quot;memorySizeGb&quot;: 42, # Required. Redis memory size in GiB.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]964 &quot;alternativeLocationId&quot;: &quot;A String&quot;, # Optional. Only applicable to STANDARD_HA tier which protects the instance
965 # against zonal failures by provisioning it across two zones. If provided, it
966 # must be a different zone from the one provided in location_id.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]967 &quot;tier&quot;: &quot;A String&quot;, # Required. The service tier of the instance.
968 &quot;displayName&quot;: &quot;A String&quot;, # An arbitrary and optional user-provided name for the instance.
969 &quot;locationId&quot;: &quot;A String&quot;, # Optional. The zone where the instance will be provisioned. If not provided,
970 # the service will choose a zone for the instance. For STANDARD_HA tier,
971 # instances will be created across two zones for protection against zonal
972 # failures. If alternative_location_id is also provided, it must be
973 # different from location_id.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]974 &quot;state&quot;: &quot;A String&quot;, # Output only. The current state of this instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]975 }
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]976
977 updateMask: string, Required. Mask of fields to update. At least one path must be supplied in
978this field. The elements of the repeated paths field may only include these
979fields from Instance:
980
981 * `displayName`
982 * `labels`
983 * `memorySizeGb`
984 * `redisConfig`
985 x__xgafv: string, V1 error format.
986 Allowed values
987 1 - v1 error format
988 2 - v2 error format
989
990Returns:
991 An object of the form:
992
993 { # This resource represents a long-running operation that is the result of a
994 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]995 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
996 # originally returns it. If you use the default HTTP mapping, the
997 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]998 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
999 # method returns no data on success, such as `Delete`, the response is
1000 # `google.protobuf.Empty`. If the original method is standard
1001 # `Get`/`Create`/`Update`, the response should be the resource. For other
1002 # methods, the response should have the type `XxxResponse`, where `Xxx`
1003 # is the original method name. For example, if the original method name
1004 # is `TakeSnapshot()`, the inferred response type is
1005 # `TakeSnapshotResponse`.
1006 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1007 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]1008 &quot;metadata&quot;: { # {
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1009 #
1010 # `createTime`: The time the operation was created.
1011 #
1012 # `endTime`: The time the operation finished running.
1013 #
1014 # `target`: Server-defined resource path for the target of the operation.
1015 #
1016 # `verb`: Name of the verb executed by the operation.
1017 #
1018 # `statusDetail`: Human-readable status of the operation, if any.
1019 #
1020 # `cancelRequested`: Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
1021 #
1022 # `apiVersion`: API version used to start the operation.
1023 #
1024 # }
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]1025 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1026 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]1027 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
1028 # different programming environments, including REST APIs and RPC APIs. It is
1029 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1030 # three pieces of data: error code, error message, and error details.
1031 #
1032 # You can find out more about this error model and how to work with it in the
1033 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1034 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1035 # user-facing error message should be localized and sent in the
1036 # google.rpc.Status.details field, or localized by the client.
1037 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1038 # message types for APIs to use.
1039 {
1040 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1041 },
1042 ],
1043 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1044 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]1045 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]1046 # If `true`, the operation is completed, and either `error` or `response` is
1047 # available.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]1048 }</pre>
1049</div>
1050
1051<div class="method">
1052 <code class="details" id="upgrade">upgrade(name, body=None, x__xgafv=None)</code>
1053 <pre>Upgrades Redis instance to the newer Redis version specified in the
1054request.
1055
1056Args:
1057 name: string, Required. Redis instance resource name using the form:
1058 `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
1059where `location_id` refers to a GCP region. (required)
1060 body: object, The request body.
1061 The object takes the form of:
1062
1063{ # Request for UpgradeInstance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]1064 &quot;redisVersion&quot;: &quot;A String&quot;, # Required. Specifies the target version of Redis software to upgrade to.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]1065 }
1066
1067 x__xgafv: string, V1 error format.
1068 Allowed values
1069 1 - v1 error format
1070 2 - v2 error format
1071
1072Returns:
1073 An object of the form:
1074
1075 { # This resource represents a long-running operation that is the result of a
1076 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]1077 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
1078 # originally returns it. If you use the default HTTP mapping, the
1079 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]1080 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
1081 # method returns no data on success, such as `Delete`, the response is
1082 # `google.protobuf.Empty`. If the original method is standard
1083 # `Get`/`Create`/`Update`, the response should be the resource. For other
1084 # methods, the response should have the type `XxxResponse`, where `Xxx`
1085 # is the original method name. For example, if the original method name
1086 # is `TakeSnapshot()`, the inferred response type is
1087 # `TakeSnapshotResponse`.
1088 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1089 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]1090 &quot;metadata&quot;: { # {
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]1091 #
1092 # `createTime`: The time the operation was created.
1093 #
1094 # `endTime`: The time the operation finished running.
1095 #
1096 # `target`: Server-defined resource path for the target of the operation.
1097 #
1098 # `verb`: Name of the verb executed by the operation.
1099 #
1100 # `statusDetail`: Human-readable status of the operation, if any.
1101 #
1102 # `cancelRequested`: Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
1103 #
1104 # `apiVersion`: API version used to start the operation.
1105 #
1106 # }
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]1107 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]1108 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame]1109 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
1110 # different programming environments, including REST APIs and RPC APIs. It is
1111 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1112 # three pieces of data: error code, error message, and error details.
1113 #
1114 # You can find out more about this error model and how to work with it in the
1115 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1116 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1117 # user-facing error message should be localized and sent in the
1118 # google.rpc.Status.details field, or localized by the client.
1119 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1120 # message types for APIs to use.
1121 {
1122 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1123 },
1124 ],
1125 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1126 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]1127 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]1128 # If `true`, the operation is completed, and either `error` or `response` is
1129 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1130 }</pre>
1131</div>
1132
1133</body></html>