google-cloud-alloy_db-v1beta 0.9.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -88,23 +88,23 @@ module Google
88
88
  # @!attribute [rw] request_id
89
89
  # @return [::String]
90
90
  # Optional. An optional request ID to identify requests. Specify a unique
91
- # request ID so that if you must retry your request, the server will know to
92
- # ignore the request if it has already been completed. The server will
93
- # guarantee that for at least 60 minutes since the first request.
91
+ # request ID so that if you must retry your request, the server ignores the
92
+ # request if it has already been completed. The server guarantees that for at
93
+ # least 60 minutes since the first request.
94
94
  #
95
95
  # For example, consider a situation where you make an initial request and
96
96
  # the request times out. If you make the request again with the same request
97
- # ID, the server can check if original operation with the same request ID
98
- # was received, and if so, will ignore the second request. This prevents
97
+ # ID, the server can check if the original operation with the same request ID
98
+ # was received, and if so, ignores the second request. This prevents
99
99
  # clients from accidentally creating duplicate commitments.
100
100
  #
101
101
  # The request ID must be a valid UUID with the exception that zero UUID is
102
102
  # not supported (00000000-0000-0000-0000-000000000000).
103
103
  # @!attribute [rw] validate_only
104
104
  # @return [::Boolean]
105
- # Optional. If set, performs request validation (e.g. permission checks and
106
- # any other type of validation), but do not actually execute the create
107
- # request.
105
+ # Optional. If set, performs request validation, for example, permission
106
+ # checks and any other type of validation, but does not actually execute the
107
+ # create request.
108
108
  class CreateSecondaryClusterRequest
109
109
  include ::Google::Protobuf::MessageExts
110
110
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -124,23 +124,23 @@ module Google
124
124
  # @!attribute [rw] request_id
125
125
  # @return [::String]
126
126
  # Optional. An optional request ID to identify requests. Specify a unique
127
- # request ID so that if you must retry your request, the server will know to
128
- # ignore the request if it has already been completed. The server will
129
- # guarantee that for at least 60 minutes since the first request.
127
+ # request ID so that if you must retry your request, the server ignores the
128
+ # request if it has already been completed. The server guarantees that for at
129
+ # least 60 minutes since the first request.
130
130
  #
131
131
  # For example, consider a situation where you make an initial request and
132
132
  # the request times out. If you make the request again with the same request
133
- # ID, the server can check if original operation with the same request ID
134
- # was received, and if so, will ignore the second request. This prevents
133
+ # ID, the server can check if the original operation with the same request ID
134
+ # was received, and if so, ignores the second request. This prevents
135
135
  # clients from accidentally creating duplicate commitments.
136
136
  #
137
137
  # The request ID must be a valid UUID with the exception that zero UUID is
138
138
  # not supported (00000000-0000-0000-0000-000000000000).
139
139
  # @!attribute [rw] validate_only
140
140
  # @return [::Boolean]
141
- # Optional. If set, performs request validation (e.g. permission checks and
142
- # any other type of validation), but do not actually execute the create
143
- # request.
141
+ # Optional. If set, performs request validation, for example, permission
142
+ # checks and any other type of validation, but does not actually execute the
143
+ # create request.
144
144
  class CreateClusterRequest
145
145
  include ::Google::Protobuf::MessageExts
146
146
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -160,23 +160,23 @@ module Google
160
160
  # @!attribute [rw] request_id
161
161
  # @return [::String]
162
162
  # Optional. An optional request ID to identify requests. Specify a unique
163
- # request ID so that if you must retry your request, the server will know to
164
- # ignore the request if it has already been completed. The server will
165
- # guarantee that for at least 60 minutes since the first request.
163
+ # request ID so that if you must retry your request, the server ignores the
164
+ # request if it has already been completed. The server guarantees that for at
165
+ # least 60 minutes since the first request.
166
166
  #
167
167
  # For example, consider a situation where you make an initial request and
168
168
  # the request times out. If you make the request again with the same request
169
- # ID, the server can check if original operation with the same request ID
170
- # was received, and if so, will ignore the second request. This prevents
169
+ # ID, the server can check if the original operation with the same request ID
170
+ # was received, and if so, ignores the second request. This prevents
171
171
  # clients from accidentally creating duplicate commitments.
172
172
  #
173
173
  # The request ID must be a valid UUID with the exception that zero UUID is
174
174
  # not supported (00000000-0000-0000-0000-000000000000).
175
175
  # @!attribute [rw] validate_only
176
176
  # @return [::Boolean]
177
- # Optional. If set, performs request validation (e.g. permission checks and
178
- # any other type of validation), but do not actually execute the update
179
- # request.
177
+ # Optional. If set, performs request validation, for example, permission
178
+ # checks and any other type of validation, but does not actually execute the
179
+ # create request.
180
180
  # @!attribute [rw] allow_missing
181
181
  # @return [::Boolean]
182
182
  # Optional. If set to true, update succeeds even if cluster is not found. In
@@ -186,6 +186,172 @@ module Google
186
186
  extend ::Google::Protobuf::MessageExts::ClassMethods
187
187
  end
188
188
 
189
+ # Upgrades a cluster.
190
+ # @!attribute [rw] name
191
+ # @return [::String]
192
+ # Required. The resource name of the cluster.
193
+ # @!attribute [rw] version
194
+ # @return [::Google::Cloud::AlloyDB::V1beta::DatabaseVersion]
195
+ # Required. The version the cluster is going to be upgraded to.
196
+ # @!attribute [rw] request_id
197
+ # @return [::String]
198
+ # Optional. An optional request ID to identify requests. Specify a unique
199
+ # request ID so that if you must retry your request, the server ignores the
200
+ # request if it has already been completed. The server guarantees that for at
201
+ # least 60 minutes since the first request.
202
+ #
203
+ # For example, consider a situation where you make an initial request and
204
+ # the request times out. If you make the request again with the same request
205
+ # ID, the server can check if the original operation with the same request ID
206
+ # was received, and if so, ignores the second request. This prevents
207
+ # clients from accidentally creating duplicate commitments.
208
+ #
209
+ # The request ID must be a valid UUID with the exception that zero UUID is
210
+ # not supported (00000000-0000-0000-0000-000000000000).
211
+ # @!attribute [rw] validate_only
212
+ # @return [::Boolean]
213
+ # Optional. If set, performs request validation, for example, permission
214
+ # checks and any other type of validation, but does not actually execute the
215
+ # create request.
216
+ # @!attribute [rw] etag
217
+ # @return [::String]
218
+ # Optional. The current etag of the Cluster.
219
+ # If an etag is provided and does not match the current etag of the Cluster,
220
+ # upgrade will be blocked and an ABORTED error will be returned.
221
+ class UpgradeClusterRequest
222
+ include ::Google::Protobuf::MessageExts
223
+ extend ::Google::Protobuf::MessageExts::ClassMethods
224
+ end
225
+
226
+ # UpgradeClusterResponse contains the response for upgrade cluster operation.
227
+ # @!attribute [rw] status
228
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Status]
229
+ # Status of upgrade operation.
230
+ # @!attribute [rw] message
231
+ # @return [::String]
232
+ # A user friendly message summarising the upgrade operation details and the
233
+ # next steps for the user if there is any.
234
+ # @!attribute [rw] cluster_upgrade_details
235
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::ClusterUpgradeDetails>]
236
+ # Array of upgrade details for the current cluster and all the secondary
237
+ # clusters associated with this cluster.
238
+ class UpgradeClusterResponse
239
+ include ::Google::Protobuf::MessageExts
240
+ extend ::Google::Protobuf::MessageExts::ClassMethods
241
+
242
+ # Stage information for different stages in the upgrade process.
243
+ # @!attribute [rw] stage
244
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Stage]
245
+ # The stage.
246
+ # @!attribute [rw] status
247
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Status]
248
+ # Status of the stage.
249
+ # @!attribute [rw] logs_url
250
+ # @return [::String]
251
+ # logs_url is the URL for the logs associated with a stage if that stage
252
+ # has logs. Right now, only three stages have logs: ALLOYDB_PRECHECK,
253
+ # PG_UPGRADE_CHECK, PRIMARY_INSTANCE_UPGRADE.
254
+ class StageInfo
255
+ include ::Google::Protobuf::MessageExts
256
+ extend ::Google::Protobuf::MessageExts::ClassMethods
257
+ end
258
+
259
+ # Details regarding the upgrade of instaces associated with a cluster.
260
+ # @!attribute [rw] name
261
+ # @return [::String]
262
+ # Normalized name of the instance.
263
+ # @!attribute [rw] upgrade_status
264
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Status]
265
+ # Upgrade status of the instance.
266
+ # @!attribute [rw] instance_type
267
+ # @return [::Google::Cloud::AlloyDB::V1beta::Instance::InstanceType]
268
+ # Instance type.
269
+ class InstanceUpgradeDetails
270
+ include ::Google::Protobuf::MessageExts
271
+ extend ::Google::Protobuf::MessageExts::ClassMethods
272
+ end
273
+
274
+ # Upgrade details of a cluster. This cluster can be primary or secondary.
275
+ # @!attribute [rw] name
276
+ # @return [::String]
277
+ # Normalized name of the cluster
278
+ # @!attribute [rw] upgrade_status
279
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Status]
280
+ # Upgrade status of the cluster.
281
+ # @!attribute [rw] cluster_type
282
+ # @return [::Google::Cloud::AlloyDB::V1beta::Cluster::ClusterType]
283
+ # Cluster type which can either be primary or secondary.
284
+ # @!attribute [rw] database_version
285
+ # @return [::Google::Cloud::AlloyDB::V1beta::DatabaseVersion]
286
+ # Database version of the cluster after the upgrade operation. This will be
287
+ # the target version if the upgrade was successful otherwise it remains the
288
+ # same as that before the upgrade operation.
289
+ # @!attribute [rw] stage_info
290
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::StageInfo>]
291
+ # Array containing stage info associated with this cluster.
292
+ # @!attribute [rw] instance_upgrade_details
293
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::InstanceUpgradeDetails>]
294
+ # Upgrade details of the instances directly associated with this cluster.
295
+ class ClusterUpgradeDetails
296
+ include ::Google::Protobuf::MessageExts
297
+ extend ::Google::Protobuf::MessageExts::ClassMethods
298
+ end
299
+
300
+ # Status of upgrade operation.
301
+ module Status
302
+ # Unspecified status.
303
+ STATUS_UNSPECIFIED = 0
304
+
305
+ # Not started.
306
+ NOT_STARTED = 4
307
+
308
+ # In progress.
309
+ IN_PROGRESS = 5
310
+
311
+ # Operation succeeded.
312
+ SUCCESS = 1
313
+
314
+ # Operation failed.
315
+ FAILED = 2
316
+
317
+ # Operation partially succeeded.
318
+ PARTIAL_SUCCESS = 3
319
+
320
+ # Cancel is in progress.
321
+ CANCEL_IN_PROGRESS = 6
322
+
323
+ # Cancellation complete.
324
+ CANCELLED = 7
325
+ end
326
+
327
+ # Stage in the upgrade.
328
+ module Stage
329
+ # Unspecified stage.
330
+ STAGE_UNSPECIFIED = 0
331
+
332
+ # Pre-upgrade custom checks, not covered by pg_upgrade.
333
+ ALLOYDB_PRECHECK = 1
334
+
335
+ # Pre-upgrade pg_upgrade checks.
336
+ PG_UPGRADE_CHECK = 2
337
+
338
+ # Clone the original cluster.
339
+ PREPARE_FOR_UPGRADE = 5
340
+
341
+ # Upgrade the primary instance(downtime).
342
+ PRIMARY_INSTANCE_UPGRADE = 3
343
+
344
+ # This stage is read pool upgrade.
345
+ READ_POOL_INSTANCES_UPGRADE = 4
346
+
347
+ # Rollback in case of critical failures.
348
+ ROLLBACK = 6
349
+
350
+ # Cleanup.
351
+ CLEANUP = 7
352
+ end
353
+ end
354
+
189
355
  # Message for deleting a Cluster
190
356
  # @!attribute [rw] name
191
357
  # @return [::String]
@@ -194,14 +360,14 @@ module Google
194
360
  # @!attribute [rw] request_id
195
361
  # @return [::String]
196
362
  # Optional. An optional request ID to identify requests. Specify a unique
197
- # request ID so that if you must retry your request, the server will know to
198
- # ignore the request if it has already been completed. The server will
199
- # guarantee that for at least 60 minutes after the first request.
363
+ # request ID so that if you must retry your request, the server ignores the
364
+ # request if it has already been completed. The server guarantees that for at
365
+ # least 60 minutes since the first request.
200
366
  #
201
367
  # For example, consider a situation where you make an initial request and
202
368
  # the request times out. If you make the request again with the same request
203
- # ID, the server can check if original operation with the same request ID
204
- # was received, and if so, will ignore the second request. This prevents
369
+ # ID, the server can check if the original operation with the same request ID
370
+ # was received, and if so, ignores the second request. This prevents
205
371
  # clients from accidentally creating duplicate commitments.
206
372
  #
207
373
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -213,8 +379,9 @@ module Google
213
379
  # deletion will be blocked and an ABORTED error will be returned.
214
380
  # @!attribute [rw] validate_only
215
381
  # @return [::Boolean]
216
- # Optional. If set, performs request validation (e.g. permission checks and
217
- # any other type of validation), but do not actually execute the delete.
382
+ # Optional. If set, performs request validation, for example, permission
383
+ # checks and any other type of validation, but does not actually execute the
384
+ # create request.
218
385
  # @!attribute [rw] force
219
386
  # @return [::Boolean]
220
387
  # Optional. Whether to cascade delete child instances for given cluster.
@@ -223,6 +390,36 @@ module Google
223
390
  extend ::Google::Protobuf::MessageExts::ClassMethods
224
391
  end
225
392
 
393
+ # Message for switching over to a cluster
394
+ # @!attribute [rw] name
395
+ # @return [::String]
396
+ # Required. The name of the resource. For the required format, see the
397
+ # comment on the Cluster.name field
398
+ # @!attribute [rw] request_id
399
+ # @return [::String]
400
+ # Optional. An optional request ID to identify requests. Specify a unique
401
+ # request ID so that if you must retry your request, the server ignores the
402
+ # request if it has already been completed. The server guarantees that for at
403
+ # least 60 minutes since the first request.
404
+ #
405
+ # For example, consider a situation where you make an initial request and
406
+ # the request times out. If you make the request again with the same request
407
+ # ID, the server can check if the original operation with the same request ID
408
+ # was received, and if so, ignores the second request. This prevents
409
+ # clients from accidentally creating duplicate commitments.
410
+ #
411
+ # The request ID must be a valid UUID with the exception that zero UUID is
412
+ # not supported (00000000-0000-0000-0000-000000000000).
413
+ # @!attribute [rw] validate_only
414
+ # @return [::Boolean]
415
+ # Optional. If set, performs request validation, for example, permission
416
+ # checks and any other type of validation, but does not actually execute the
417
+ # create request.
418
+ class SwitchoverClusterRequest
419
+ include ::Google::Protobuf::MessageExts
420
+ extend ::Google::Protobuf::MessageExts::ClassMethods
421
+ end
422
+
226
423
  # Message for promoting a Cluster
227
424
  # @!attribute [rw] name
228
425
  # @return [::String]
@@ -231,9 +428,9 @@ module Google
231
428
  # @!attribute [rw] request_id
232
429
  # @return [::String]
233
430
  # Optional. An optional request ID to identify requests. Specify a unique
234
- # request ID so that if you must retry your request, the server will know to
235
- # ignore the request if it has already been completed. The server will
236
- # guarantee that for at least 60 minutes after the first request.
431
+ # request ID so that if you must retry your request, the server ignores the
432
+ # request if it has already been completed. The server guarantees that for at
433
+ # least 60 minutes since the first request.
237
434
  #
238
435
  # For example, consider a situation where you make an initial request and
239
436
  # the request times out. If you make the request again with the same request
@@ -250,8 +447,9 @@ module Google
250
447
  # deletion will be blocked and an ABORTED error will be returned.
251
448
  # @!attribute [rw] validate_only
252
449
  # @return [::Boolean]
253
- # Optional. If set, performs request validation (e.g. permission checks and
254
- # any other type of validation), but do not actually execute the delete.
450
+ # Optional. If set, performs request validation, for example, permission
451
+ # checks and any other type of validation, but does not actually execute the
452
+ # create request.
255
453
  class PromoteClusterRequest
256
454
  include ::Google::Protobuf::MessageExts
257
455
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -279,23 +477,23 @@ module Google
279
477
  # @!attribute [rw] request_id
280
478
  # @return [::String]
281
479
  # Optional. An optional request ID to identify requests. Specify a unique
282
- # request ID so that if you must retry your request, the server will know to
283
- # ignore the request if it has already been completed. The server will
284
- # guarantee that for at least 60 minutes since the first request.
480
+ # request ID so that if you must retry your request, the server ignores the
481
+ # request if it has already been completed. The server guarantees that for at
482
+ # least 60 minutes since the first request.
285
483
  #
286
484
  # For example, consider a situation where you make an initial request and
287
485
  # the request times out. If you make the request again with the same request
288
- # ID, the server can check if original operation with the same request ID
289
- # was received, and if so, will ignore the second request. This prevents
486
+ # ID, the server can check if the original operation with the same request ID
487
+ # was received, and if so, ignores the second request. This prevents
290
488
  # clients from accidentally creating duplicate commitments.
291
489
  #
292
490
  # The request ID must be a valid UUID with the exception that zero UUID is
293
491
  # not supported (00000000-0000-0000-0000-000000000000).
294
492
  # @!attribute [rw] validate_only
295
493
  # @return [::Boolean]
296
- # Optional. If set, performs request validation (e.g. permission checks and
297
- # any other type of validation), but do not actually execute the import
298
- # request.
494
+ # Optional. If set, performs request validation, for example, permission
495
+ # checks and any other type of validation, but does not actually execute the
496
+ # create request.
299
497
  class RestoreClusterRequest
300
498
  include ::Google::Protobuf::MessageExts
301
499
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -370,23 +568,23 @@ module Google
370
568
  # @!attribute [rw] request_id
371
569
  # @return [::String]
372
570
  # Optional. An optional request ID to identify requests. Specify a unique
373
- # request ID so that if you must retry your request, the server will know to
374
- # ignore the request if it has already been completed. The server will
375
- # guarantee that for at least 60 minutes since the first request.
571
+ # request ID so that if you must retry your request, the server ignores the
572
+ # request if it has already been completed. The server guarantees that for at
573
+ # least 60 minutes since the first request.
376
574
  #
377
575
  # For example, consider a situation where you make an initial request and
378
576
  # the request times out. If you make the request again with the same request
379
- # ID, the server can check if original operation with the same request ID
380
- # was received, and if so, will ignore the second request. This prevents
577
+ # ID, the server can check if the original operation with the same request ID
578
+ # was received, and if so, ignores the second request. This prevents
381
579
  # clients from accidentally creating duplicate commitments.
382
580
  #
383
581
  # The request ID must be a valid UUID with the exception that zero UUID is
384
582
  # not supported (00000000-0000-0000-0000-000000000000).
385
583
  # @!attribute [rw] validate_only
386
584
  # @return [::Boolean]
387
- # Optional. If set, performs request validation (e.g. permission checks and
388
- # any other type of validation), but do not actually execute the create
389
- # request.
585
+ # Optional. If set, performs request validation, for example, permission
586
+ # checks and any other type of validation, but does not actually execute the
587
+ # create request.
390
588
  class CreateInstanceRequest
391
589
  include ::Google::Protobuf::MessageExts
392
590
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -406,23 +604,23 @@ module Google
406
604
  # @!attribute [rw] request_id
407
605
  # @return [::String]
408
606
  # Optional. An optional request ID to identify requests. Specify a unique
409
- # request ID so that if you must retry your request, the server will know to
410
- # ignore the request if it has already been completed. The server will
411
- # guarantee that for at least 60 minutes since the first request.
607
+ # request ID so that if you must retry your request, the server ignores the
608
+ # request if it has already been completed. The server guarantees that for at
609
+ # least 60 minutes since the first request.
412
610
  #
413
611
  # For example, consider a situation where you make an initial request and
414
612
  # the request times out. If you make the request again with the same request
415
- # ID, the server can check if original operation with the same request ID
416
- # was received, and if so, will ignore the second request. This prevents
613
+ # ID, the server can check if the original operation with the same request ID
614
+ # was received, and if so, ignores the second request. This prevents
417
615
  # clients from accidentally creating duplicate commitments.
418
616
  #
419
617
  # The request ID must be a valid UUID with the exception that zero UUID is
420
618
  # not supported (00000000-0000-0000-0000-000000000000).
421
619
  # @!attribute [rw] validate_only
422
620
  # @return [::Boolean]
423
- # Optional. If set, performs request validation (e.g. permission checks and
424
- # any other type of validation), but do not actually execute the create
425
- # request.
621
+ # Optional. If set, performs request validation, for example, permission
622
+ # checks and any other type of validation, but does not actually execute the
623
+ # create request.
426
624
  class CreateSecondaryInstanceRequest
427
625
  include ::Google::Protobuf::MessageExts
428
626
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -448,14 +646,14 @@ module Google
448
646
  # @!attribute [rw] request_id
449
647
  # @return [::String]
450
648
  # Optional. An optional request ID to identify requests. Specify a unique
451
- # request ID so that if you must retry your request, the server will know to
452
- # ignore the request if it has already been completed. The server will
453
- # guarantee that for at least 60 minutes since the first request.
649
+ # request ID so that if you must retry your request, the server ignores the
650
+ # request if it has already been completed. The server guarantees that for at
651
+ # least 60 minutes since the first request.
454
652
  #
455
653
  # For example, consider a situation where you make an initial request and
456
654
  # the request times out. If you make the request again with the same request
457
- # ID, the server can check if original operation with the same request ID
458
- # was received, and if so, will ignore the second request. This prevents
655
+ # ID, the server can check if the original operation with the same request ID
656
+ # was received, and if so, ignores the second request. This prevents
459
657
  # clients from accidentally creating duplicate commitments.
460
658
  #
461
659
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -551,7 +749,7 @@ module Google
551
749
  STATE_UNSPECIFIED = 0
552
750
 
553
751
  # Instance is pending creation and has not yet been picked up for
554
- # processsing in the backend.
752
+ # processing in the backend.
555
753
  PENDING_CREATE = 1
556
754
 
557
755
  # The instance is active and running.
@@ -587,23 +785,23 @@ module Google
587
785
  # @!attribute [rw] request_id
588
786
  # @return [::String]
589
787
  # Optional. An optional request ID to identify requests. Specify a unique
590
- # request ID so that if you must retry your request, the server will know to
591
- # ignore the request if it has already been completed. The server will
592
- # guarantee that for at least 60 minutes since the first request.
788
+ # request ID so that if you must retry your request, the server ignores the
789
+ # request if it has already been completed. The server guarantees that for at
790
+ # least 60 minutes since the first request.
593
791
  #
594
792
  # For example, consider a situation where you make an initial request and
595
793
  # the request times out. If you make the request again with the same request
596
- # ID, the server can check if original operation with the same request ID
597
- # was received, and if so, will ignore the second request. This prevents
794
+ # ID, the server can check if the original operation with the same request ID
795
+ # was received, and if so, ignores the second request. This prevents
598
796
  # clients from accidentally creating duplicate commitments.
599
797
  #
600
798
  # The request ID must be a valid UUID with the exception that zero UUID is
601
799
  # not supported (00000000-0000-0000-0000-000000000000).
602
800
  # @!attribute [rw] validate_only
603
801
  # @return [::Boolean]
604
- # Optional. If set, performs request validation (e.g. permission checks and
605
- # any other type of validation), but do not actually execute the update
606
- # request.
802
+ # Optional. If set, performs request validation, for example, permission
803
+ # checks and any other type of validation, but does not actually execute the
804
+ # create request.
607
805
  # @!attribute [rw] allow_missing
608
806
  # @return [::Boolean]
609
807
  # Optional. If set to true, update succeeds even if instance is not found. In
@@ -621,14 +819,14 @@ module Google
621
819
  # @!attribute [rw] request_id
622
820
  # @return [::String]
623
821
  # Optional. An optional request ID to identify requests. Specify a unique
624
- # request ID so that if you must retry your request, the server will know to
625
- # ignore the request if it has already been completed. The server will
626
- # guarantee that for at least 60 minutes after the first request.
822
+ # request ID so that if you must retry your request, the server ignores the
823
+ # request if it has already been completed. The server guarantees that for at
824
+ # least 60 minutes since the first request.
627
825
  #
628
826
  # For example, consider a situation where you make an initial request and
629
827
  # the request times out. If you make the request again with the same request
630
- # ID, the server can check if original operation with the same request ID
631
- # was received, and if so, will ignore the second request. This prevents
828
+ # ID, the server can check if the original operation with the same request ID
829
+ # was received, and if so, ignores the second request. This prevents
632
830
  # clients from accidentally creating duplicate commitments.
633
831
  #
634
832
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -640,8 +838,9 @@ module Google
640
838
  # deletion will be blocked and an ABORTED error will be returned.
641
839
  # @!attribute [rw] validate_only
642
840
  # @return [::Boolean]
643
- # Optional. If set, performs request validation (e.g. permission checks and
644
- # any other type of validation), but do not actually execute the delete.
841
+ # Optional. If set, performs request validation, for example, permission
842
+ # checks and any other type of validation, but does not actually execute the
843
+ # create request.
645
844
  class DeleteInstanceRequest
646
845
  include ::Google::Protobuf::MessageExts
647
846
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -655,22 +854,23 @@ module Google
655
854
  # @!attribute [rw] request_id
656
855
  # @return [::String]
657
856
  # Optional. An optional request ID to identify requests. Specify a unique
658
- # request ID so that if you must retry your request, the server will know to
659
- # ignore the request if it has already been completed. The server will
660
- # guarantee that for at least 60 minutes after the first request.
857
+ # request ID so that if you must retry your request, the server ignores the
858
+ # request if it has already been completed. The server guarantees that for at
859
+ # least 60 minutes since the first request.
661
860
  #
662
861
  # For example, consider a situation where you make an initial request and
663
862
  # the request times out. If you make the request again with the same request
664
- # ID, the server can check if original operation with the same request ID
665
- # was received, and if so, will ignore the second request. This prevents
863
+ # ID, the server can check if the original operation with the same request ID
864
+ # was received, and if so, ignores the second request. This prevents
666
865
  # clients from accidentally creating duplicate commitments.
667
866
  #
668
867
  # The request ID must be a valid UUID with the exception that zero UUID is
669
868
  # not supported (00000000-0000-0000-0000-000000000000).
670
869
  # @!attribute [rw] validate_only
671
870
  # @return [::Boolean]
672
- # Optional. If set, performs request validation (e.g. permission checks and
673
- # any other type of validation), but do not actually execute the failover.
871
+ # Optional. If set, performs request validation, for example, permission
872
+ # checks and any other type of validation, but does not actually execute the
873
+ # create request.
674
874
  class FailoverInstanceRequest
675
875
  include ::Google::Protobuf::MessageExts
676
876
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -687,23 +887,23 @@ module Google
687
887
  # @!attribute [rw] request_id
688
888
  # @return [::String]
689
889
  # Optional. An optional request ID to identify requests. Specify a unique
690
- # request ID so that if you must retry your request, the server will know to
691
- # ignore the request if it has already been completed. The server will
692
- # guarantee that for at least 60 minutes after the first request.
890
+ # request ID so that if you must retry your request, the server ignores the
891
+ # request if it has already been completed. The server guarantees that for at
892
+ # least 60 minutes since the first request.
693
893
  #
694
894
  # For example, consider a situation where you make an initial request and
695
895
  # the request times out. If you make the request again with the same request
696
- # ID, the server can check if original operation with the same request ID
697
- # was received, and if so, will ignore the second request. This prevents
896
+ # ID, the server can check if the original operation with the same request ID
897
+ # was received, and if so, ignores the second request. This prevents
698
898
  # clients from accidentally creating duplicate commitments.
699
899
  #
700
900
  # The request ID must be a valid UUID with the exception that zero UUID is
701
901
  # not supported (00000000-0000-0000-0000-000000000000).
702
902
  # @!attribute [rw] validate_only
703
903
  # @return [::Boolean]
704
- # Optional. If set, performs request validation (e.g. permission checks and
705
- # any other type of validation), but do not actually execute the fault
706
- # injection.
904
+ # Optional. If set, performs request validation, for example, permission
905
+ # checks and any other type of validation, but does not actually execute the
906
+ # create request.
707
907
  class InjectFaultRequest
708
908
  include ::Google::Protobuf::MessageExts
709
909
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -726,27 +926,117 @@ module Google
726
926
  # @!attribute [rw] request_id
727
927
  # @return [::String]
728
928
  # Optional. An optional request ID to identify requests. Specify a unique
729
- # request ID so that if you must retry your request, the server will know to
730
- # ignore the request if it has already been completed. The server will
731
- # guarantee that for at least 60 minutes after the first request.
929
+ # request ID so that if you must retry your request, the server ignores the
930
+ # request if it has already been completed. The server guarantees that for at
931
+ # least 60 minutes since the first request.
732
932
  #
733
933
  # For example, consider a situation where you make an initial request and
734
934
  # the request times out. If you make the request again with the same request
735
- # ID, the server can check if original operation with the same request ID
736
- # was received, and if so, will ignore the second request. This prevents
935
+ # ID, the server can check if the original operation with the same request ID
936
+ # was received, and if so, ignores the second request. This prevents
737
937
  # clients from accidentally creating duplicate commitments.
738
938
  #
739
939
  # The request ID must be a valid UUID with the exception that zero UUID is
740
940
  # not supported (00000000-0000-0000-0000-000000000000).
741
941
  # @!attribute [rw] validate_only
742
942
  # @return [::Boolean]
743
- # Optional. If set, performs request validation (e.g. permission checks and
744
- # any other type of validation), but do not actually execute the restart.
943
+ # Optional. If set, performs request validation, for example, permission
944
+ # checks and any other type of validation, but does not actually execute the
945
+ # create request.
946
+ # @!attribute [rw] node_ids
947
+ # @return [::Array<::String>]
948
+ # Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to
949
+ # restart upon. Applicable only to read instances.
745
950
  class RestartInstanceRequest
746
951
  include ::Google::Protobuf::MessageExts
747
952
  extend ::Google::Protobuf::MessageExts::ClassMethods
748
953
  end
749
954
 
955
+ # Request for ExecuteSql rpc.
956
+ # @!attribute [rw] password
957
+ # @return [::String]
958
+ # Optional. The database native user’s password.
959
+ # @!attribute [rw] instance
960
+ # @return [::String]
961
+ # Required. The instance where the SQL will be executed. For the required
962
+ # format, see the comment on the Instance.name field.
963
+ # @!attribute [rw] database
964
+ # @return [::String]
965
+ # Required. Name of the database where the query will be executed.
966
+ # Note - Value provided should be the same as expected from `SELECT
967
+ # current_database();` and NOT as a resource reference.
968
+ # @!attribute [rw] user
969
+ # @return [::String]
970
+ # Required. Database user to be used for executing the SQL.
971
+ # Note - Value provided should be the same as expected from
972
+ # `SELECT current_user;` and NOT as a resource reference.
973
+ # @!attribute [rw] sql_statement
974
+ # @return [::String]
975
+ # Required. SQL statement to execute on database. Any valid statement is
976
+ # permitted, including DDL, DML, DQL statements.
977
+ class ExecuteSqlRequest
978
+ include ::Google::Protobuf::MessageExts
979
+ extend ::Google::Protobuf::MessageExts::ClassMethods
980
+ end
981
+
982
+ # Execute a SQL statement response.
983
+ # @!attribute [rw] sql_results
984
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::SqlResult>]
985
+ # SqlResult represents the results for the execution of sql statements.
986
+ # @!attribute [rw] metadata
987
+ # @return [::Google::Cloud::AlloyDB::V1beta::ExecuteSqlMetadata]
988
+ # Any additional metadata information regarding the execution of the sql
989
+ # statement.
990
+ class ExecuteSqlResponse
991
+ include ::Google::Protobuf::MessageExts
992
+ extend ::Google::Protobuf::MessageExts::ClassMethods
993
+ end
994
+
995
+ # Any additional metadata information regarding the execution of the SQL
996
+ # @!attribute [rw] message
997
+ # @return [::String]
998
+ # Message related to SQL execution. Marked as core content since it
999
+ # can potentially contain details related to the query or result set. This
1000
+ # field can be used to convey messages such as "when the SQL result set
1001
+ # exceeds the acceptable response size limits."
1002
+ # @!attribute [rw] partial_result
1003
+ # @return [::Boolean]
1004
+ # Set to true if SQL returned a result set larger than the acceptable
1005
+ # response size limits and the result was truncated.
1006
+ # @!attribute [rw] sql_statement_execution_duration
1007
+ # @return [::Google::Protobuf::Duration]
1008
+ # The time duration taken to execute the sql statement.
1009
+ # @!attribute [rw] status
1010
+ # @return [::Google::Cloud::AlloyDB::V1beta::ExecuteSqlMetadata::Status]
1011
+ # Status of SQL execution.
1012
+ class ExecuteSqlMetadata
1013
+ include ::Google::Protobuf::MessageExts
1014
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1015
+
1016
+ # Status contains all valid Status a SQL execution can end up in.
1017
+ module Status
1018
+ # The status is unknown.
1019
+ STATUS_UNSPECIFIED = 0
1020
+
1021
+ # No error during SQL execution i.e. All SQL statements ran to completion.
1022
+ # The "message" will be empty.
1023
+ OK = 1
1024
+
1025
+ # Same as OK, except indicates that only partial results were
1026
+ # returned. The "message" field will contain details on why results were
1027
+ # truncated.
1028
+ PARTIAL = 2
1029
+
1030
+ # Error during SQL execution. Atleast 1 SQL statement execution resulted in
1031
+ # a error. Side effects of other statements are rolled back. The "message"
1032
+ # field will contain human readable error given by Postgres of the first
1033
+ # bad SQL statement. SQL execution errors don't constitute API errors as
1034
+ # defined in https://google.aip.dev/193 but will be returned as part of
1035
+ # this message.
1036
+ ERROR = 3
1037
+ end
1038
+ end
1039
+
750
1040
  # Message for requesting list of Backups
751
1041
  # @!attribute [rw] parent
752
1042
  # @return [::String]
@@ -806,14 +1096,14 @@ module Google
806
1096
  # @!attribute [rw] request_id
807
1097
  # @return [::String]
808
1098
  # Optional. An optional request ID to identify requests. Specify a unique
809
- # request ID so that if you must retry your request, the server will know to
810
- # ignore the request if it has already been completed. The server will
811
- # guarantee that for at least 60 minutes since the first request.
1099
+ # request ID so that if you must retry your request, the server ignores the
1100
+ # request if it has already been completed. The server guarantees that for at
1101
+ # least 60 minutes since the first request.
812
1102
  #
813
1103
  # For example, consider a situation where you make an initial request and
814
1104
  # the request times out. If you make the request again with the same request
815
- # ID, the server can check if original operation with the same request ID
816
- # was received, and if so, will ignore the second request. This prevents
1105
+ # ID, the server can check if the original operation with the same request ID
1106
+ # was received, and if so, ignores the second request. This prevents
817
1107
  # clients from accidentally creating duplicate commitments.
818
1108
  #
819
1109
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -841,14 +1131,14 @@ module Google
841
1131
  # @!attribute [rw] request_id
842
1132
  # @return [::String]
843
1133
  # Optional. An optional request ID to identify requests. Specify a unique
844
- # request ID so that if you must retry your request, the server will know to
845
- # ignore the request if it has already been completed. The server will
846
- # guarantee that for at least 60 minutes since the first request.
1134
+ # request ID so that if you must retry your request, the server ignores the
1135
+ # request if it has already been completed. The server guarantees that for at
1136
+ # least 60 minutes since the first request.
847
1137
  #
848
1138
  # For example, consider a situation where you make an initial request and
849
1139
  # the request times out. If you make the request again with the same request
850
- # ID, the server can check if original operation with the same request ID
851
- # was received, and if so, will ignore the second request. This prevents
1140
+ # ID, the server can check if the original operation with the same request ID
1141
+ # was received, and if so, ignores the second request. This prevents
852
1142
  # clients from accidentally creating duplicate commitments.
853
1143
  #
854
1144
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -874,14 +1164,14 @@ module Google
874
1164
  # @!attribute [rw] request_id
875
1165
  # @return [::String]
876
1166
  # Optional. An optional request ID to identify requests. Specify a unique
877
- # request ID so that if you must retry your request, the server will know to
878
- # ignore the request if it has already been completed. The server will
879
- # guarantee that for at least 60 minutes after the first request.
1167
+ # request ID so that if you must retry your request, the server ignores the
1168
+ # request if it has already been completed. The server guarantees that for at
1169
+ # least 60 minutes since the first request.
880
1170
  #
881
1171
  # For example, consider a situation where you make an initial request and
882
1172
  # the request times out. If you make the request again with the same request
883
- # ID, the server can check if original operation with the same request ID
884
- # was received, and if so, will ignore the second request. This prevents
1173
+ # ID, the server can check if the original operation with the same request ID
1174
+ # was received, and if so, ignores the second request. This prevents
885
1175
  # clients from accidentally creating duplicate commitments.
886
1176
  #
887
1177
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -943,14 +1233,14 @@ module Google
943
1233
  # @!attribute [rw] request_id
944
1234
  # @return [::String]
945
1235
  # Optional. An optional request ID to identify requests. Specify a unique
946
- # request ID so that if you must retry your request, the server will know to
947
- # ignore the request if it has already been completed. The server will
948
- # guarantee that for at least 60 minutes after the first request.
1236
+ # request ID so that if you must retry your request, the server ignores the
1237
+ # request if it has already been completed. The server guarantees that for at
1238
+ # least 60 minutes since the first request.
949
1239
  #
950
1240
  # For example, consider a situation where you make an initial request and
951
1241
  # the request times out. If you make the request again with the same request
952
- # ID, the server can check if original operation with the same request ID
953
- # was received, and if so, will ignore the second request. This prevents
1242
+ # ID, the server can check if the original operation with the same request ID
1243
+ # was received, and if so, ignores the second request. This prevents
954
1244
  # clients from accidentally creating duplicate commitments.
955
1245
  #
956
1246
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1005,14 +1295,14 @@ module Google
1005
1295
  # @!attribute [rw] request_id
1006
1296
  # @return [::String]
1007
1297
  # Optional. An optional request ID to identify requests. Specify a unique
1008
- # request ID so that if you must retry your request, the server will know to
1009
- # ignore the request if it has already been completed. The server will
1010
- # guarantee that for at least 60 minutes after the first request.
1298
+ # request ID so that if you must retry your request, the server ignores the
1299
+ # request if it has already been completed. The server guarantees that for at
1300
+ # least 60 minutes since the first request.
1011
1301
  #
1012
1302
  # For example, consider a situation where you make an initial request and
1013
1303
  # the request times out. If you make the request again with the same request
1014
- # ID, the server can check if original operation with the same request ID
1015
- # was received, and if so, will ignore the second request. This prevents
1304
+ # ID, the server can check if the original operation with the same request ID
1305
+ # was received, and if so, ignores the second request. This prevents
1016
1306
  # clients from accidentally creating duplicate commitments.
1017
1307
  #
1018
1308
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1026,6 +1316,12 @@ module Google
1026
1316
  # @!attribute [r] batch_create_instances_metadata
1027
1317
  # @return [::Google::Cloud::AlloyDB::V1beta::BatchCreateInstancesMetadata]
1028
1318
  # Output only. BatchCreateInstances related metadata.
1319
+ # @!attribute [r] promote_cluster_status
1320
+ # @return [::Google::Cloud::AlloyDB::V1beta::PromoteClusterStatus]
1321
+ # Output only. PromoteClusterStatus related metadata.
1322
+ # @!attribute [r] upgrade_cluster_status
1323
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterStatus]
1324
+ # Output only. UpgradeClusterStatus related metadata.
1029
1325
  # @!attribute [r] create_time
1030
1326
  # @return [::Google::Protobuf::Timestamp]
1031
1327
  # Output only. The time the operation was created.
@@ -1056,6 +1352,104 @@ module Google
1056
1352
  extend ::Google::Protobuf::MessageExts::ClassMethods
1057
1353
  end
1058
1354
 
1355
+ # Message for current status of the database during Promote Cluster operation.
1356
+ # @!attribute [r] state
1357
+ # @return [::Google::Cloud::AlloyDB::V1beta::PromoteClusterStatus::State]
1358
+ # Output only. The current state of the promoted secondary's database.
1359
+ # Once the operation is complete, the final state of the database in the
1360
+ # LRO can be one of:
1361
+ # 1. PROMOTE_CLUSTER_AVAILABLE_FOR_READ, indicating that the promote
1362
+ # operation has failed mid-way, the database is still only available for
1363
+ # read.
1364
+ # 2. PROMOTE_CLUSTER_COMPLETED, indicating that a promote operation
1365
+ # completed successfully. The database is available for both read and write
1366
+ # requests
1367
+ class PromoteClusterStatus
1368
+ include ::Google::Protobuf::MessageExts
1369
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1370
+
1371
+ # State contains all valid states of the database during promote cluster
1372
+ # operation. This is used for status reporting through the LRO metadata.
1373
+ module State
1374
+ # The state of the database is unknown.
1375
+ STATE_UNSPECIFIED = 0
1376
+
1377
+ # The database is only available for read.
1378
+ PROMOTE_CLUSTER_AVAILABLE_FOR_READ = 1
1379
+
1380
+ # The database is available for both read and write. The promote operation
1381
+ # is near completion.
1382
+ PROMOTE_CLUSTER_AVAILABLE_FOR_WRITE = 2
1383
+
1384
+ # The promote operation is completed and the database is available for
1385
+ # write.
1386
+ PROMOTE_CLUSTER_COMPLETED = 3
1387
+ end
1388
+ end
1389
+
1390
+ # Message for current status of the Major Version Upgrade operation.
1391
+ # @!attribute [rw] state
1392
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Status]
1393
+ # Cluster Major Version Upgrade state.
1394
+ # @!attribute [rw] cancellable
1395
+ # @return [::Boolean]
1396
+ # Whether the operation is cancellable.
1397
+ # @!attribute [rw] source_version
1398
+ # @return [::Google::Cloud::AlloyDB::V1beta::DatabaseVersion]
1399
+ # Source database major version.
1400
+ # @!attribute [rw] target_version
1401
+ # @return [::Google::Cloud::AlloyDB::V1beta::DatabaseVersion]
1402
+ # Target database major version.
1403
+ # @!attribute [rw] stages
1404
+ # @return [::Array<::Google::Cloud::AlloyDB::V1beta::UpgradeClusterStatus::StageStatus>]
1405
+ # Status of all upgrade stages.
1406
+ class UpgradeClusterStatus
1407
+ include ::Google::Protobuf::MessageExts
1408
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1409
+
1410
+ # Status of an upgrade stage.
1411
+ # @!attribute [rw] read_pool_instances_upgrade
1412
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterStatus::ReadPoolInstancesUpgradeStageStatus]
1413
+ # Read pool instances upgrade metadata.
1414
+ # @!attribute [rw] stage
1415
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Stage]
1416
+ # Upgrade stage.
1417
+ # @!attribute [rw] state
1418
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterResponse::Status]
1419
+ # State of this stage.
1420
+ class StageStatus
1421
+ include ::Google::Protobuf::MessageExts
1422
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1423
+ end
1424
+
1425
+ # Read pool instances upgrade specific status.
1426
+ # @!attribute [rw] upgrade_stats
1427
+ # @return [::Google::Cloud::AlloyDB::V1beta::UpgradeClusterStatus::ReadPoolInstancesUpgradeStageStatus::Stats]
1428
+ # Read pool instances upgrade statistics.
1429
+ class ReadPoolInstancesUpgradeStageStatus
1430
+ include ::Google::Protobuf::MessageExts
1431
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1432
+
1433
+ # Upgrade stats for read pool instances.
1434
+ # @!attribute [rw] not_started
1435
+ # @return [::Integer]
1436
+ # Number of read pool instances for which upgrade has not started.
1437
+ # @!attribute [rw] ongoing
1438
+ # @return [::Integer]
1439
+ # Number of read pool instances undergoing upgrade.
1440
+ # @!attribute [rw] success
1441
+ # @return [::Integer]
1442
+ # Number of read pool instances successfully upgraded.
1443
+ # @!attribute [rw] failed
1444
+ # @return [::Integer]
1445
+ # Number of read pool instances which failed to upgrade.
1446
+ class Stats
1447
+ include ::Google::Protobuf::MessageExts
1448
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1449
+ end
1450
+ end
1451
+ end
1452
+
1059
1453
  # Message for requesting list of Users
1060
1454
  # @!attribute [rw] parent
1061
1455
  # @return [::String]
@@ -1116,14 +1510,14 @@ module Google
1116
1510
  # @!attribute [rw] request_id
1117
1511
  # @return [::String]
1118
1512
  # Optional. An optional request ID to identify requests. Specify a unique
1119
- # request ID so that if you must retry your request, the server will know to
1120
- # ignore the request if it has already been completed. The server will
1121
- # guarantee that for at least 60 minutes since the first request.
1513
+ # request ID so that if you must retry your request, the server ignores the
1514
+ # request if it has already been completed. The server guarantees that for at
1515
+ # least 60 minutes since the first request.
1122
1516
  #
1123
1517
  # For example, consider a situation where you make an initial request and
1124
1518
  # the request times out. If you make the request again with the same request
1125
- # ID, the server can check if original operation with the same request ID
1126
- # was received, and if so, will ignore the second request. This prevents
1519
+ # ID, the server can check if the original operation with the same request ID
1520
+ # was received, and if so, ignores the second request. This prevents
1127
1521
  # clients from accidentally creating duplicate commitments.
1128
1522
  #
1129
1523
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1151,14 +1545,14 @@ module Google
1151
1545
  # @!attribute [rw] request_id
1152
1546
  # @return [::String]
1153
1547
  # Optional. An optional request ID to identify requests. Specify a unique
1154
- # request ID so that if you must retry your request, the server will know to
1155
- # ignore the request if it has already been completed. The server will
1156
- # guarantee that for at least 60 minutes since the first request.
1548
+ # request ID so that if you must retry your request, the server ignores the
1549
+ # request if it has already been completed. The server guarantees that for at
1550
+ # least 60 minutes since the first request.
1157
1551
  #
1158
1552
  # For example, consider a situation where you make an initial request and
1159
1553
  # the request times out. If you make the request again with the same request
1160
- # ID, the server can check if original operation with the same request ID
1161
- # was received, and if so, will ignore the second request. This prevents
1554
+ # ID, the server can check if the original operation with the same request ID
1555
+ # was received, and if so, ignores the second request. This prevents
1162
1556
  # clients from accidentally creating duplicate commitments.
1163
1557
  #
1164
1558
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1183,14 +1577,14 @@ module Google
1183
1577
  # @!attribute [rw] request_id
1184
1578
  # @return [::String]
1185
1579
  # Optional. An optional request ID to identify requests. Specify a unique
1186
- # request ID so that if you must retry your request, the server will know to
1187
- # ignore the request if it has already been completed. The server will
1188
- # guarantee that for at least 60 minutes after the first request.
1580
+ # request ID so that if you must retry your request, the server ignores the
1581
+ # request if it has already been completed. The server guarantees that for at
1582
+ # least 60 minutes since the first request.
1189
1583
  #
1190
1584
  # For example, consider a situation where you make an initial request and
1191
1585
  # the request times out. If you make the request again with the same request
1192
- # ID, the server can check if original operation with the same request ID
1193
- # was received, and if so, will ignore the second request. This prevents
1586
+ # ID, the server can check if the original operation with the same request ID
1587
+ # was received, and if so, ignores the second request. This prevents
1194
1588
  # clients from accidentally creating duplicate commitments.
1195
1589
  #
1196
1590
  # The request ID must be a valid UUID with the exception that zero UUID is
@@ -1211,9 +1605,9 @@ module Google
1211
1605
  # @!attribute [rw] page_size
1212
1606
  # @return [::Integer]
1213
1607
  # Optional. The maximum number of databases to return. The service may return
1214
- # fewer than this value. If unspecified, an appropriate number of databases
1215
- # will be returned. The max value will be 2000, values above max will be
1216
- # coerced to max.
1608
+ # fewer than this value. If unspecified, 2000 is the default page_size. The
1609
+ # max value of page_size will be 4000, values above max will be coerced to
1610
+ # max.
1217
1611
  # @!attribute [rw] page_token
1218
1612
  # @return [::String]
1219
1613
  # Optional. A page token, received from a previous `ListDatabases` call.