google-cloud-memorystore-v1 1.1.1 → 1.2.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.
@@ -22,6 +22,20 @@ module Google
22
22
  module Memorystore
23
23
  module V1
24
24
  # A Memorystore instance.
25
+ # @!attribute [rw] gcs_source
26
+ # @return [::Google::Cloud::Memorystore::V1::Instance::GcsBackupSource]
27
+ # Optional. Immutable. Backups that stored in Cloud Storage buckets.
28
+ # The Cloud Storage buckets need to be the same region as the instances.
29
+ # Read permission is required to import from the provided Cloud Storage
30
+ # Objects.
31
+ #
32
+ # Note: The following fields are mutually exclusive: `gcs_source`, `managed_backup_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
33
+ # @!attribute [rw] managed_backup_source
34
+ # @return [::Google::Cloud::Memorystore::V1::Instance::ManagedBackupSource]
35
+ # Optional. Immutable. Backups that generated and managed by memorystore
36
+ # service.
37
+ #
38
+ # Note: The following fields are mutually exclusive: `managed_backup_source`, `gcs_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
25
39
  # @!attribute [rw] name
26
40
  # @return [::String]
27
41
  # Identifier. Unique name of the instance.
@@ -58,18 +72,19 @@ module Google
58
72
  # @return [::Integer]
59
73
  # Optional. Number of shards for the instance.
60
74
  # @!attribute [r] discovery_endpoints
75
+ # @deprecated This field is deprecated and may be removed in the next major version update.
61
76
  # @return [::Array<::Google::Cloud::Memorystore::V1::DiscoveryEndpoint>]
62
- # Output only. Endpoints clients can connect to the instance through.
63
- # Currently only one discovery endpoint is supported.
77
+ # Output only. Deprecated: Use the endpoints.connections.psc_auto_connection
78
+ # or endpoints.connections.psc_connection values instead.
64
79
  # @!attribute [rw] node_type
65
80
  # @return [::Google::Cloud::Memorystore::V1::Instance::NodeType]
66
- # Optional. Immutable. Machine type for individual nodes of the instance.
81
+ # Optional. Machine type for individual nodes of the instance.
67
82
  # @!attribute [rw] persistence_config
68
83
  # @return [::Google::Cloud::Memorystore::V1::PersistenceConfig]
69
84
  # Optional. Persistence configuration of the instance.
70
85
  # @!attribute [rw] engine_version
71
86
  # @return [::String]
72
- # Optional. Immutable. Engine version of the instance.
87
+ # Optional. Engine version of the instance.
73
88
  # @!attribute [rw] engine_configs
74
89
  # @return [::Google::Protobuf::Map{::String => ::String}]
75
90
  # Optional. User-provided engine configurations for the instance.
@@ -84,15 +99,46 @@ module Google
84
99
  # @return [::Boolean]
85
100
  # Optional. If set to true deletion of the instance will fail.
86
101
  # @!attribute [rw] psc_auto_connections
102
+ # @deprecated This field is deprecated and may be removed in the next major version update.
87
103
  # @return [::Array<::Google::Cloud::Memorystore::V1::PscAutoConnection>]
88
- # Required. Immutable. User inputs and resource details of the auto-created
89
- # PSC connections.
104
+ # Optional. Immutable. Deprecated: Use the
105
+ # endpoints.connections.psc_auto_connection value instead.
106
+ # @!attribute [r] psc_attachment_details
107
+ # @return [::Array<::Google::Cloud::Memorystore::V1::PscAttachmentDetail>]
108
+ # Output only. Service attachment details to configure PSC connections.
90
109
  # @!attribute [rw] endpoints
91
110
  # @return [::Array<::Google::Cloud::Memorystore::V1::Instance::InstanceEndpoint>]
92
111
  # Optional. Endpoints for the instance.
93
112
  # @!attribute [rw] mode
94
113
  # @return [::Google::Cloud::Memorystore::V1::Instance::Mode]
95
114
  # Optional. The mode config for the instance.
115
+ # @!attribute [rw] ondemand_maintenance
116
+ # @return [::Boolean]
117
+ # Optional. Input only. Ondemand maintenance for the instance.
118
+ # @!attribute [rw] maintenance_policy
119
+ # @return [::Google::Cloud::Memorystore::V1::MaintenancePolicy]
120
+ # Optional. The maintenance policy for the instance. If not provided,
121
+ # the maintenance event will be performed based on Memorystore
122
+ # internal rollout schedule.
123
+ # @!attribute [r] maintenance_schedule
124
+ # @return [::Google::Cloud::Memorystore::V1::MaintenanceSchedule]
125
+ # Output only. Published maintenance schedule.
126
+ # @!attribute [rw] cross_instance_replication_config
127
+ # @return [::Google::Cloud::Memorystore::V1::CrossInstanceReplicationConfig]
128
+ # Optional. The config for cross instance replication.
129
+ # @!attribute [rw] async_instance_endpoints_deletion_enabled
130
+ # @return [::Boolean]
131
+ # Optional. If true, instance endpoints that are created and registered by
132
+ # customers can be deleted asynchronously. That is, such an instance endpoint
133
+ # can be de-registered before the forwarding rules in the instance endpoint
134
+ # are deleted.
135
+ # @!attribute [r] backup_collection
136
+ # @return [::String]
137
+ # Output only. The backup collection full resource name. Example:
138
+ # projects/\\{project}/locations/\\{location}/backupCollections/\\{collection}
139
+ # @!attribute [rw] automated_backup_config
140
+ # @return [::Google::Cloud::Memorystore::V1::AutomatedBackupConfig]
141
+ # Optional. The automated backup config for the instance.
96
142
  class Instance
97
143
  include ::Google::Protobuf::MessageExts
98
144
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -112,12 +158,42 @@ module Google
112
158
  # @!attribute [r] target_replica_count
113
159
  # @return [::Integer]
114
160
  # Output only. Target number of replica nodes per shard for the instance.
161
+ # @!attribute [r] target_engine_version
162
+ # @return [::String]
163
+ # Output only. Target engine version for the instance.
164
+ # @!attribute [r] target_node_type
165
+ # @return [::Google::Cloud::Memorystore::V1::Instance::NodeType]
166
+ # Output only. Target node type for the instance.
115
167
  class UpdateInfo
116
168
  include ::Google::Protobuf::MessageExts
117
169
  extend ::Google::Protobuf::MessageExts::ClassMethods
118
170
  end
119
171
  end
120
172
 
173
+ # Backups that stored in Cloud Storage buckets.
174
+ # The Cloud Storage buckets need to be the same region as the instances.
175
+ # @!attribute [rw] uris
176
+ # @return [::Array<::String>]
177
+ # Optional. Example: gs://bucket1/object1, gs://bucket2/folder2/object2
178
+ class GcsBackupSource
179
+ include ::Google::Protobuf::MessageExts
180
+ extend ::Google::Protobuf::MessageExts::ClassMethods
181
+ end
182
+
183
+ # Backups that generated and managed by memorystore.
184
+ # @!attribute [rw] backup
185
+ # @return [::String]
186
+ # Optional. Example:
187
+ # //memorystore.googleapis.com/projects/\\{project}/locations/\\{location}/backupCollections/\\{collection}/backups/\\{backup}
188
+ # A shorter version (without the prefix) of the backup name is also
189
+ # supported, like
190
+ # projects/\\{project}/locations/\\{location}/backupCollections/\\{collection}/backups/\\{backup_id}
191
+ # In this case, it assumes the backup is under memorystore.googleapis.com.
192
+ class ManagedBackupSource
193
+ include ::Google::Protobuf::MessageExts
194
+ extend ::Google::Protobuf::MessageExts::ClassMethods
195
+ end
196
+
121
197
  # InstanceEndpoint consists of PSC connections that are created
122
198
  # as a group in each VPC network for accessing the instance. In each group,
123
199
  # there shall be one connection for each service attachment in the cluster.
@@ -133,8 +209,8 @@ module Google
133
209
  # Information of each PSC connection.
134
210
  # @!attribute [rw] psc_auto_connection
135
211
  # @return [::Google::Cloud::Memorystore::V1::PscAutoConnection]
136
- # Detailed information of a PSC connection that is created through
137
- # service connectivity automation.
212
+ # Immutable. Detailed information of a PSC connection that is created
213
+ # through service connectivity automation.
138
214
  #
139
215
  # Note: The following fields are mutually exclusive: `psc_auto_connection`, `psc_connection`. If a field in that set is populated, all other fields in the set will automatically be cleared.
140
216
  # @!attribute [rw] psc_connection
@@ -243,11 +319,318 @@ module Google
243
319
  end
244
320
  end
245
321
 
322
+ # The automated backup config for an instance.
323
+ # @!attribute [rw] fixed_frequency_schedule
324
+ # @return [::Google::Cloud::Memorystore::V1::AutomatedBackupConfig::FixedFrequencySchedule]
325
+ # Optional. Trigger automated backups at a fixed frequency.
326
+ # @!attribute [rw] automated_backup_mode
327
+ # @return [::Google::Cloud::Memorystore::V1::AutomatedBackupConfig::AutomatedBackupMode]
328
+ # Optional. The automated backup mode. If the mode is disabled, the other
329
+ # fields will be ignored.
330
+ # @!attribute [rw] retention
331
+ # @return [::Google::Protobuf::Duration]
332
+ # Optional. How long to keep automated backups before the backups are
333
+ # deleted. The value should be between 1 day and 365 days. If not specified,
334
+ # the default value is 35 days.
335
+ class AutomatedBackupConfig
336
+ include ::Google::Protobuf::MessageExts
337
+ extend ::Google::Protobuf::MessageExts::ClassMethods
338
+
339
+ # This schedule allows the backup to be triggered at a fixed frequency
340
+ # (currently only daily is supported).
341
+ # @!attribute [rw] start_time
342
+ # @return [::Google::Type::TimeOfDay]
343
+ # Required. The start time of every automated backup in UTC. It must be set
344
+ # to the start of an hour. This field is required.
345
+ class FixedFrequencySchedule
346
+ include ::Google::Protobuf::MessageExts
347
+ extend ::Google::Protobuf::MessageExts::ClassMethods
348
+ end
349
+
350
+ # The automated backup mode.
351
+ module AutomatedBackupMode
352
+ # Default value. Automated backup config is not specified.
353
+ AUTOMATED_BACKUP_MODE_UNSPECIFIED = 0
354
+
355
+ # Automated backup config disabled.
356
+ DISABLED = 1
357
+
358
+ # Automated backup config enabled.
359
+ ENABLED = 2
360
+ end
361
+ end
362
+
363
+ # BackupCollection of an instance.
364
+ # @!attribute [rw] name
365
+ # @return [::String]
366
+ # Identifier. Full resource path of the backup collection.
367
+ # @!attribute [r] instance_uid
368
+ # @return [::String]
369
+ # Output only. The instance uid of the backup collection.
370
+ # @!attribute [r] instance
371
+ # @return [::String]
372
+ # Output only. The full resource path of the instance the backup collection
373
+ # belongs to. Example:
374
+ # projects/\\{project}/locations/\\{location}/instances/\\{instance}
375
+ # @!attribute [r] kms_key
376
+ # @return [::String]
377
+ # Output only. The KMS key used to encrypt the backups under this backup
378
+ # collection.
379
+ # @!attribute [r] uid
380
+ # @return [::String]
381
+ # Output only. System assigned unique identifier of the backup collection.
382
+ # @!attribute [r] create_time
383
+ # @return [::Google::Protobuf::Timestamp]
384
+ # Output only. The time when the backup collection was created.
385
+ class BackupCollection
386
+ include ::Google::Protobuf::MessageExts
387
+ extend ::Google::Protobuf::MessageExts::ClassMethods
388
+ end
389
+
390
+ # Backup of an instance.
391
+ # @!attribute [rw] name
392
+ # @return [::String]
393
+ # Identifier. Full resource path of the backup. the last part of the name is
394
+ # the backup id with the following format: [YYYYMMDDHHMMSS]_[Shorted Instance
395
+ # UID] OR customer specified while backup instance. Example:
396
+ # 20240515123000_1234
397
+ # @!attribute [r] create_time
398
+ # @return [::Google::Protobuf::Timestamp]
399
+ # Output only. The time when the backup was created.
400
+ # @!attribute [r] instance
401
+ # @return [::String]
402
+ # Output only. Instance resource path of this backup.
403
+ # @!attribute [r] instance_uid
404
+ # @return [::String]
405
+ # Output only. Instance uid of this backup.
406
+ # @!attribute [r] total_size_bytes
407
+ # @return [::Integer]
408
+ # Output only. Total size of the backup in bytes.
409
+ # @!attribute [r] expire_time
410
+ # @return [::Google::Protobuf::Timestamp]
411
+ # Output only. The time when the backup will expire.
412
+ # @!attribute [r] engine_version
413
+ # @return [::String]
414
+ # Output only. valkey-7.5/valkey-8.0, etc.
415
+ # @!attribute [r] backup_files
416
+ # @return [::Array<::Google::Cloud::Memorystore::V1::BackupFile>]
417
+ # Output only. List of backup files of the backup.
418
+ # @!attribute [r] node_type
419
+ # @return [::Google::Cloud::Memorystore::V1::Instance::NodeType]
420
+ # Output only. Node type of the instance.
421
+ # @!attribute [r] replica_count
422
+ # @return [::Integer]
423
+ # Output only. Number of replicas for the instance.
424
+ # @!attribute [r] shard_count
425
+ # @return [::Integer]
426
+ # Output only. Number of shards for the instance.
427
+ # @!attribute [r] backup_type
428
+ # @return [::Google::Cloud::Memorystore::V1::Backup::BackupType]
429
+ # Output only. Type of the backup.
430
+ # @!attribute [r] state
431
+ # @return [::Google::Cloud::Memorystore::V1::Backup::State]
432
+ # Output only. State of the backup.
433
+ # @!attribute [r] uid
434
+ # @return [::String]
435
+ # Output only. System assigned unique identifier of the backup.
436
+ class Backup
437
+ include ::Google::Protobuf::MessageExts
438
+ extend ::Google::Protobuf::MessageExts::ClassMethods
439
+
440
+ # Type of the backup.
441
+ module BackupType
442
+ # The default value, not set.
443
+ BACKUP_TYPE_UNSPECIFIED = 0
444
+
445
+ # On-demand backup.
446
+ ON_DEMAND = 1
447
+
448
+ # Automated backup.
449
+ AUTOMATED = 2
450
+ end
451
+
452
+ # State of the backup.
453
+ module State
454
+ # The default value, not set.
455
+ STATE_UNSPECIFIED = 0
456
+
457
+ # The backup is being created.
458
+ CREATING = 1
459
+
460
+ # The backup is active to be used.
461
+ ACTIVE = 2
462
+
463
+ # The backup is being deleted.
464
+ DELETING = 3
465
+
466
+ # The backup is currently suspended due to reasons like project deletion,
467
+ # billing account closure, etc.
468
+ SUSPENDED = 4
469
+ end
470
+ end
471
+
472
+ # Backup is consisted of multiple backup files.
473
+ # @!attribute [r] file_name
474
+ # @return [::String]
475
+ # Output only. e.g: <shard-id>.rdb
476
+ # @!attribute [r] size_bytes
477
+ # @return [::Integer]
478
+ # Output only. Size of the backup file in bytes.
479
+ # @!attribute [r] create_time
480
+ # @return [::Google::Protobuf::Timestamp]
481
+ # Output only. The time when the backup file was created.
482
+ class BackupFile
483
+ include ::Google::Protobuf::MessageExts
484
+ extend ::Google::Protobuf::MessageExts::ClassMethods
485
+ end
486
+
487
+ # Cross instance replication config.
488
+ # @!attribute [rw] instance_role
489
+ # @return [::Google::Cloud::Memorystore::V1::CrossInstanceReplicationConfig::InstanceRole]
490
+ # Required. The role of the instance in cross instance replication.
491
+ # @!attribute [rw] primary_instance
492
+ # @return [::Google::Cloud::Memorystore::V1::CrossInstanceReplicationConfig::RemoteInstance]
493
+ # Optional. Details of the primary instance that is used as the replication
494
+ # source for this secondary instance.
495
+ #
496
+ # This field is only set for a secondary instance.
497
+ # @!attribute [rw] secondary_instances
498
+ # @return [::Array<::Google::Cloud::Memorystore::V1::CrossInstanceReplicationConfig::RemoteInstance>]
499
+ # Optional. List of secondary instances that are replicating from this
500
+ # primary instance.
501
+ #
502
+ # This field is only set for a primary instance.
503
+ # @!attribute [r] update_time
504
+ # @return [::Google::Protobuf::Timestamp]
505
+ # Output only. The last time cross instance replication config was updated.
506
+ # @!attribute [r] membership
507
+ # @return [::Google::Cloud::Memorystore::V1::CrossInstanceReplicationConfig::Membership]
508
+ # Output only. An output only view of all the member instances participating
509
+ # in the cross instance replication. This view will be provided by every
510
+ # member instance irrespective of its instance role(primary or secondary).
511
+ #
512
+ # A primary instance can provide information about all the secondary
513
+ # instances replicating from it. However, a secondary instance only knows
514
+ # about the primary instance from which it is replicating. However, for
515
+ # scenarios, where the primary instance is unavailable(e.g. regional outage),
516
+ # a Getinstance request can be sent to any other member instance and this
517
+ # field will list all the member instances participating in cross instance
518
+ # replication.
519
+ class CrossInstanceReplicationConfig
520
+ include ::Google::Protobuf::MessageExts
521
+ extend ::Google::Protobuf::MessageExts::ClassMethods
522
+
523
+ # Details of the remote instance associated with this instance in a cross
524
+ # instance replication setup.
525
+ # @!attribute [rw] instance
526
+ # @return [::String]
527
+ # Optional. The full resource path of the remote instance in
528
+ # the format: projects/<project>/locations/<region>/instances/<instance-id>
529
+ # @!attribute [r] uid
530
+ # @return [::String]
531
+ # Output only. The unique identifier of the remote instance.
532
+ class RemoteInstance
533
+ include ::Google::Protobuf::MessageExts
534
+ extend ::Google::Protobuf::MessageExts::ClassMethods
535
+ end
536
+
537
+ # An output only view of all the member instances participating in the cross
538
+ # instance replication.
539
+ # @!attribute [r] primary_instance
540
+ # @return [::Google::Cloud::Memorystore::V1::CrossInstanceReplicationConfig::RemoteInstance]
541
+ # Output only. The primary instance that acts as the source of replication
542
+ # for the secondary instances.
543
+ # @!attribute [r] secondary_instances
544
+ # @return [::Array<::Google::Cloud::Memorystore::V1::CrossInstanceReplicationConfig::RemoteInstance>]
545
+ # Output only. The list of secondary instances replicating from the primary
546
+ # instance.
547
+ class Membership
548
+ include ::Google::Protobuf::MessageExts
549
+ extend ::Google::Protobuf::MessageExts::ClassMethods
550
+ end
551
+
552
+ # The role of the instance in cross instance replication.
553
+ module InstanceRole
554
+ # instance role is not set.
555
+ # The behavior is equivalent to NONE.
556
+ INSTANCE_ROLE_UNSPECIFIED = 0
557
+
558
+ # This instance does not participate in cross instance replication. It is
559
+ # an independent instance and does not replicate to or from any other
560
+ # instances.
561
+ NONE = 1
562
+
563
+ # A instance that allows both reads and writes. Any data written to this
564
+ # instance is also replicated to the attached secondary instances.
565
+ PRIMARY = 2
566
+
567
+ # A instance that allows only reads and replicates data from a primary
568
+ # instance.
569
+ SECONDARY = 3
570
+ end
571
+ end
572
+
573
+ # Maintenance policy per instance.
574
+ # @!attribute [r] create_time
575
+ # @return [::Google::Protobuf::Timestamp]
576
+ # Output only. The time when the policy was created.
577
+ # @!attribute [r] update_time
578
+ # @return [::Google::Protobuf::Timestamp]
579
+ # Output only. The time when the policy was updated.
580
+ # @!attribute [rw] weekly_maintenance_window
581
+ # @return [::Array<::Google::Cloud::Memorystore::V1::WeeklyMaintenanceWindow>]
582
+ # Optional. Maintenance window that is applied to resources covered by this
583
+ # policy. Minimum 1. For the current version, the maximum number of
584
+ # weekly_window is expected to be one.
585
+ class MaintenancePolicy
586
+ include ::Google::Protobuf::MessageExts
587
+ extend ::Google::Protobuf::MessageExts::ClassMethods
588
+ end
589
+
590
+ # Time window specified for weekly operations.
591
+ # @!attribute [rw] day
592
+ # @return [::Google::Type::DayOfWeek]
593
+ # Optional. Allows to define schedule that runs specified day of the week.
594
+ # @!attribute [rw] start_time
595
+ # @return [::Google::Type::TimeOfDay]
596
+ # Optional. Start time of the window in UTC.
597
+ class WeeklyMaintenanceWindow
598
+ include ::Google::Protobuf::MessageExts
599
+ extend ::Google::Protobuf::MessageExts::ClassMethods
600
+ end
601
+
602
+ # Upcoming maintenance schedule.
603
+ # @!attribute [r] start_time
604
+ # @return [::Google::Protobuf::Timestamp]
605
+ # Output only. The start time of any upcoming scheduled maintenance for this
606
+ # instance.
607
+ # @!attribute [r] end_time
608
+ # @return [::Google::Protobuf::Timestamp]
609
+ # Output only. The end time of any upcoming scheduled maintenance for this
610
+ # instance.
611
+ class MaintenanceSchedule
612
+ include ::Google::Protobuf::MessageExts
613
+ extend ::Google::Protobuf::MessageExts::ClassMethods
614
+ end
615
+
616
+ # Configuration of a service attachment of the cluster, for creating PSC
617
+ # connections.
618
+ # @!attribute [r] service_attachment
619
+ # @return [::String]
620
+ # Output only. Service attachment URI which your self-created PscConnection
621
+ # should use as target.
622
+ # @!attribute [r] connection_type
623
+ # @return [::Google::Cloud::Memorystore::V1::ConnectionType]
624
+ # Output only. Type of Psc endpoint.
625
+ class PscAttachmentDetail
626
+ include ::Google::Protobuf::MessageExts
627
+ extend ::Google::Protobuf::MessageExts::ClassMethods
628
+ end
629
+
246
630
  # Details of consumer resources in a PSC connection.
247
- # @!attribute [r] port
631
+ # @!attribute [rw] port
248
632
  # @return [::Integer]
249
- # Optional. Output only. port will only be set for Primary/Reader or
250
- # Discovery endpoint.
633
+ # Optional. port will only be set for Primary/Reader or Discovery endpoint.
251
634
  # @!attribute [r] psc_connection_id
252
635
  # @return [::String]
253
636
  # Output only. The PSC connection id of the forwarding rule connected to the
@@ -289,9 +672,12 @@ module Google
289
672
  end
290
673
 
291
674
  # User created Psc connection configuration.
292
- # @!attribute [r] psc_connection_id
675
+ # @!attribute [rw] port
676
+ # @return [::Integer]
677
+ # Optional. port will only be set for Primary/Reader or Discovery endpoint.
678
+ # @!attribute [rw] psc_connection_id
293
679
  # @return [::String]
294
- # Output only. The PSC connection id of the forwarding rule connected to the
680
+ # Required. The PSC connection id of the forwarding rule connected to the
295
681
  # service attachment.
296
682
  # @!attribute [rw] ip_address
297
683
  # @return [::String]
@@ -470,6 +856,36 @@ module Google
470
856
  end
471
857
  end
472
858
 
859
+ # Request for rescheduling instance maintenance.
860
+ # @!attribute [rw] name
861
+ # @return [::String]
862
+ # Required. Name of the instance to reschedule maintenance for:
863
+ # `projects/{project}/locations/{location_id}/instances/{instance}`
864
+ # @!attribute [rw] reschedule_type
865
+ # @return [::Google::Cloud::Memorystore::V1::RescheduleMaintenanceRequest::RescheduleType]
866
+ # Required. If reschedule type is SPECIFIC_TIME, schedule_time must be set.
867
+ # @!attribute [rw] schedule_time
868
+ # @return [::Google::Protobuf::Timestamp]
869
+ # Optional. Timestamp when the maintenance shall be rescheduled to if
870
+ # reschedule_type=SPECIFIC_TIME, in RFC 3339 format.
871
+ # Example: `2012-11-15T16:19:00.094Z`.
872
+ class RescheduleMaintenanceRequest
873
+ include ::Google::Protobuf::MessageExts
874
+ extend ::Google::Protobuf::MessageExts::ClassMethods
875
+
876
+ # Reschedule options.
877
+ module RescheduleType
878
+ # Not set.
879
+ RESCHEDULE_TYPE_UNSPECIFIED = 0
880
+
881
+ # If the user wants to schedule the maintenance to happen now.
882
+ IMMEDIATE = 1
883
+
884
+ # If the user wants to reschedule the maintenance to a specific time.
885
+ SPECIFIC_TIME = 3
886
+ end
887
+ end
888
+
473
889
  # Request message for [ListInstances][].
474
890
  # @!attribute [rw] parent
475
891
  # @return [::String]
@@ -615,6 +1031,161 @@ module Google
615
1031
  extend ::Google::Protobuf::MessageExts::ClassMethods
616
1032
  end
617
1033
 
1034
+ # Request for [ListBackupCollections]
1035
+ # @!attribute [rw] parent
1036
+ # @return [::String]
1037
+ # Required. The resource name of the backupCollection location using the
1038
+ # form:
1039
+ # `projects/{project_id}/locations/{location_id}`
1040
+ # where `location_id` refers to a Google Cloud region.
1041
+ # @!attribute [rw] page_size
1042
+ # @return [::Integer]
1043
+ # Optional. The maximum number of items to return.
1044
+ #
1045
+ # If not specified, a default value of 1000 will be used by the service.
1046
+ # Regardless of the page_size value, the response may include a partial list
1047
+ # and a caller should only rely on response's
1048
+ # {::Google::Cloud::Memorystore::V1::ListBackupCollectionsResponse#next_page_token `next_page_token`}
1049
+ # to determine if there are more clusters left to be queried.
1050
+ # @!attribute [rw] page_token
1051
+ # @return [::String]
1052
+ # Optional. The `next_page_token` value returned from a previous
1053
+ # [ListBackupCollections] request, if any.
1054
+ class ListBackupCollectionsRequest
1055
+ include ::Google::Protobuf::MessageExts
1056
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1057
+ end
1058
+
1059
+ # Response for [ListBackupCollections].
1060
+ # @!attribute [rw] backup_collections
1061
+ # @return [::Array<::Google::Cloud::Memorystore::V1::BackupCollection>]
1062
+ # A list of backupCollections in the project.
1063
+ #
1064
+ # If the `location_id` in the parent field of the request is "-", all regions
1065
+ # available to the project are queried, and the results aggregated.
1066
+ # If in such an aggregated query a location is unavailable, a placeholder
1067
+ # backupCollection entry is included in the response with the `name` field
1068
+ # set to a value of the form
1069
+ # `projects/{project_id}/locations/{location_id}/backupCollections/`- and the
1070
+ # `status` field set to ERROR and `status_message` field set to "location not
1071
+ # available for ListBackupCollections".
1072
+ # @!attribute [rw] next_page_token
1073
+ # @return [::String]
1074
+ # Token to retrieve the next page of results, or empty if there are no more
1075
+ # results in the list.
1076
+ # @!attribute [rw] unreachable
1077
+ # @return [::Array<::String>]
1078
+ # Locations that could not be reached.
1079
+ class ListBackupCollectionsResponse
1080
+ include ::Google::Protobuf::MessageExts
1081
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1082
+ end
1083
+
1084
+ # Request for [GetBackupCollection].
1085
+ # @!attribute [rw] name
1086
+ # @return [::String]
1087
+ # Required. Instance backupCollection resource name using the form:
1088
+ # `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}`
1089
+ # where `location_id` refers to a Google Cloud region.
1090
+ class GetBackupCollectionRequest
1091
+ include ::Google::Protobuf::MessageExts
1092
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1093
+ end
1094
+
1095
+ # Request for [ListBackups].
1096
+ # @!attribute [rw] parent
1097
+ # @return [::String]
1098
+ # Required. The resource name of the backupCollection using the form:
1099
+ # `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}`
1100
+ # @!attribute [rw] page_size
1101
+ # @return [::Integer]
1102
+ # Optional. The maximum number of items to return.
1103
+ #
1104
+ # If not specified, a default value of 1000 will be used by the service.
1105
+ # Regardless of the page_size value, the response may include a partial list
1106
+ # and a caller should only rely on response's
1107
+ # {::Google::Cloud::Memorystore::V1::ListBackupsResponse#next_page_token `next_page_token`}
1108
+ # to determine if there are more clusters left to be queried.
1109
+ # @!attribute [rw] page_token
1110
+ # @return [::String]
1111
+ # Optional. The `next_page_token` value returned from a previous
1112
+ # [ListBackupCollections] request, if any.
1113
+ class ListBackupsRequest
1114
+ include ::Google::Protobuf::MessageExts
1115
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1116
+ end
1117
+
1118
+ # Response for [ListBackups].
1119
+ # @!attribute [rw] backups
1120
+ # @return [::Array<::Google::Cloud::Memorystore::V1::Backup>]
1121
+ # A list of backups in the project.
1122
+ # @!attribute [rw] next_page_token
1123
+ # @return [::String]
1124
+ # Token to retrieve the next page of results, or empty if there are no more
1125
+ # results in the list.
1126
+ # @!attribute [rw] unreachable
1127
+ # @return [::Array<::String>]
1128
+ # Backups that could not be reached.
1129
+ class ListBackupsResponse
1130
+ include ::Google::Protobuf::MessageExts
1131
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1132
+ end
1133
+
1134
+ # Request for [GetBackup].
1135
+ # @!attribute [rw] name
1136
+ # @return [::String]
1137
+ # Required. Instance backup resource name using the form:
1138
+ # `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}/backups/{backup_id}`
1139
+ class GetBackupRequest
1140
+ include ::Google::Protobuf::MessageExts
1141
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1142
+ end
1143
+
1144
+ # Request for [DeleteBackup].
1145
+ # @!attribute [rw] name
1146
+ # @return [::String]
1147
+ # Required. Instance backup resource name using the form:
1148
+ # `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}/backups/{backup_id}`
1149
+ # @!attribute [rw] request_id
1150
+ # @return [::String]
1151
+ # Optional. Idempotent request UUID.
1152
+ class DeleteBackupRequest
1153
+ include ::Google::Protobuf::MessageExts
1154
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1155
+ end
1156
+
1157
+ # Request for [ExportBackup].
1158
+ # @!attribute [rw] gcs_bucket
1159
+ # @return [::String]
1160
+ # Google Cloud Storage bucket, like "my-bucket".
1161
+ # @!attribute [rw] name
1162
+ # @return [::String]
1163
+ # Required. Instance backup resource name using the form:
1164
+ # `projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}/backups/{backup_id}`
1165
+ class ExportBackupRequest
1166
+ include ::Google::Protobuf::MessageExts
1167
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1168
+ end
1169
+
1170
+ # Request for [BackupInstance].
1171
+ # @!attribute [rw] name
1172
+ # @return [::String]
1173
+ # Required. Instance resource name using the form:
1174
+ # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
1175
+ # where `location_id` refers to a Google Cloud region.
1176
+ # @!attribute [rw] ttl
1177
+ # @return [::Google::Protobuf::Duration]
1178
+ # Optional. TTL for the backup to expire. Value range is 1 day to 100 years.
1179
+ # If not specified, the default value is 100 years.
1180
+ # @!attribute [rw] backup_id
1181
+ # @return [::String]
1182
+ # Optional. The id of the backup to be created. If not specified, the
1183
+ # default value ([YYYYMMDDHHMMSS]_[Shortened Instance UID] is used.
1184
+ class BackupInstanceRequest
1185
+ include ::Google::Protobuf::MessageExts
1186
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1187
+ end
1188
+
618
1189
  # Request message for [GetCertificateAuthority][].
619
1190
  # @!attribute [rw] name
620
1191
  # @return [::String]