google-cloud-memcache-v1 0.2.5 → 0.4.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.
@@ -0,0 +1,318 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # Required information for every language.
23
+ # @!attribute [rw] reference_docs_uri
24
+ # @return [::String]
25
+ # Link to automatically generated reference documentation. Example:
26
+ # https://cloud.google.com/nodejs/docs/reference/asset/latest
27
+ # @!attribute [rw] destinations
28
+ # @return [::Array<::Google::Api::ClientLibraryDestination>]
29
+ # The destination where API teams want this client library to be published.
30
+ class CommonLanguageSettings
31
+ include ::Google::Protobuf::MessageExts
32
+ extend ::Google::Protobuf::MessageExts::ClassMethods
33
+ end
34
+
35
+ # Details about how and where to publish client libraries.
36
+ # @!attribute [rw] version
37
+ # @return [::String]
38
+ # Version of the API to apply these settings to.
39
+ # @!attribute [rw] launch_stage
40
+ # @return [::Google::Api::LaunchStage]
41
+ # Launch stage of this version of the API.
42
+ # @!attribute [rw] rest_numeric_enums
43
+ # @return [::Boolean]
44
+ # When using transport=rest, the client request will encode enums as
45
+ # numbers rather than strings.
46
+ # @!attribute [rw] java_settings
47
+ # @return [::Google::Api::JavaSettings]
48
+ # Settings for legacy Java features, supported in the Service YAML.
49
+ # @!attribute [rw] cpp_settings
50
+ # @return [::Google::Api::CppSettings]
51
+ # Settings for C++ client libraries.
52
+ # @!attribute [rw] php_settings
53
+ # @return [::Google::Api::PhpSettings]
54
+ # Settings for PHP client libraries.
55
+ # @!attribute [rw] python_settings
56
+ # @return [::Google::Api::PythonSettings]
57
+ # Settings for Python client libraries.
58
+ # @!attribute [rw] node_settings
59
+ # @return [::Google::Api::NodeSettings]
60
+ # Settings for Node client libraries.
61
+ # @!attribute [rw] dotnet_settings
62
+ # @return [::Google::Api::DotnetSettings]
63
+ # Settings for .NET client libraries.
64
+ # @!attribute [rw] ruby_settings
65
+ # @return [::Google::Api::RubySettings]
66
+ # Settings for Ruby client libraries.
67
+ # @!attribute [rw] go_settings
68
+ # @return [::Google::Api::GoSettings]
69
+ # Settings for Go client libraries.
70
+ class ClientLibrarySettings
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
74
+
75
+ # This message configures the settings for publishing [Google Cloud Client
76
+ # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
77
+ # generated from the service config.
78
+ # @!attribute [rw] method_settings
79
+ # @return [::Array<::Google::Api::MethodSettings>]
80
+ # A list of API method settings, e.g. the behavior for methods that use the
81
+ # long-running operation pattern.
82
+ # @!attribute [rw] new_issue_uri
83
+ # @return [::String]
84
+ # Link to a place that API users can report issues. Example:
85
+ # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
+ # @!attribute [rw] documentation_uri
87
+ # @return [::String]
88
+ # Link to product home page. Example:
89
+ # https://cloud.google.com/asset-inventory/docs/overview
90
+ # @!attribute [rw] api_short_name
91
+ # @return [::String]
92
+ # Used as a tracking tag when collecting data about the APIs developer
93
+ # relations artifacts like docs, packages delivered to package managers,
94
+ # etc. Example: "speech".
95
+ # @!attribute [rw] github_label
96
+ # @return [::String]
97
+ # GitHub label to apply to issues and pull requests opened for this API.
98
+ # @!attribute [rw] codeowner_github_teams
99
+ # @return [::Array<::String>]
100
+ # GitHub teams to be added to CODEOWNERS in the directory in GitHub
101
+ # containing source code for the client libraries for this API.
102
+ # @!attribute [rw] doc_tag_prefix
103
+ # @return [::String]
104
+ # A prefix used in sample code when demarking regions to be included in
105
+ # documentation.
106
+ # @!attribute [rw] organization
107
+ # @return [::Google::Api::ClientLibraryOrganization]
108
+ # For whom the client library is being published.
109
+ # @!attribute [rw] library_settings
110
+ # @return [::Array<::Google::Api::ClientLibrarySettings>]
111
+ # Client library settings. If the same version string appears multiple
112
+ # times in this list, then the last one wins. Settings from earlier
113
+ # settings with the same version string are discarded.
114
+ class Publishing
115
+ include ::Google::Protobuf::MessageExts
116
+ extend ::Google::Protobuf::MessageExts::ClassMethods
117
+ end
118
+
119
+ # Settings for Java client libraries.
120
+ # @!attribute [rw] library_package
121
+ # @return [::String]
122
+ # The package name to use in Java. Clobbers the java_package option
123
+ # set in the protobuf. This should be used **only** by APIs
124
+ # who have already set the language_settings.java.package_name" field
125
+ # in gapic.yaml. API teams should use the protobuf java_package option
126
+ # where possible.
127
+ #
128
+ # Example of a YAML configuration::
129
+ #
130
+ # publishing:
131
+ # java_settings:
132
+ # library_package: com.google.cloud.pubsub.v1
133
+ # @!attribute [rw] service_class_names
134
+ # @return [::Google::Protobuf::Map{::String => ::String}]
135
+ # Configure the Java class name to use instead of the service's for its
136
+ # corresponding generated GAPIC client. Keys are fully-qualified
137
+ # service names as they appear in the protobuf (including the full
138
+ # the language_settings.java.interface_names" field in gapic.yaml. API
139
+ # teams should otherwise use the service name as it appears in the
140
+ # protobuf.
141
+ #
142
+ # Example of a YAML configuration::
143
+ #
144
+ # publishing:
145
+ # java_settings:
146
+ # service_class_names:
147
+ # - google.pubsub.v1.Publisher: TopicAdmin
148
+ # - google.pubsub.v1.Subscriber: SubscriptionAdmin
149
+ # @!attribute [rw] common
150
+ # @return [::Google::Api::CommonLanguageSettings]
151
+ # Some settings.
152
+ class JavaSettings
153
+ include ::Google::Protobuf::MessageExts
154
+ extend ::Google::Protobuf::MessageExts::ClassMethods
155
+
156
+ # @!attribute [rw] key
157
+ # @return [::String]
158
+ # @!attribute [rw] value
159
+ # @return [::String]
160
+ class ServiceClassNamesEntry
161
+ include ::Google::Protobuf::MessageExts
162
+ extend ::Google::Protobuf::MessageExts::ClassMethods
163
+ end
164
+ end
165
+
166
+ # Settings for C++ client libraries.
167
+ # @!attribute [rw] common
168
+ # @return [::Google::Api::CommonLanguageSettings]
169
+ # Some settings.
170
+ class CppSettings
171
+ include ::Google::Protobuf::MessageExts
172
+ extend ::Google::Protobuf::MessageExts::ClassMethods
173
+ end
174
+
175
+ # Settings for Php client libraries.
176
+ # @!attribute [rw] common
177
+ # @return [::Google::Api::CommonLanguageSettings]
178
+ # Some settings.
179
+ class PhpSettings
180
+ include ::Google::Protobuf::MessageExts
181
+ extend ::Google::Protobuf::MessageExts::ClassMethods
182
+ end
183
+
184
+ # Settings for Python client libraries.
185
+ # @!attribute [rw] common
186
+ # @return [::Google::Api::CommonLanguageSettings]
187
+ # Some settings.
188
+ class PythonSettings
189
+ include ::Google::Protobuf::MessageExts
190
+ extend ::Google::Protobuf::MessageExts::ClassMethods
191
+ end
192
+
193
+ # Settings for Node client libraries.
194
+ # @!attribute [rw] common
195
+ # @return [::Google::Api::CommonLanguageSettings]
196
+ # Some settings.
197
+ class NodeSettings
198
+ include ::Google::Protobuf::MessageExts
199
+ extend ::Google::Protobuf::MessageExts::ClassMethods
200
+ end
201
+
202
+ # Settings for Dotnet client libraries.
203
+ # @!attribute [rw] common
204
+ # @return [::Google::Api::CommonLanguageSettings]
205
+ # Some settings.
206
+ class DotnetSettings
207
+ include ::Google::Protobuf::MessageExts
208
+ extend ::Google::Protobuf::MessageExts::ClassMethods
209
+ end
210
+
211
+ # Settings for Ruby client libraries.
212
+ # @!attribute [rw] common
213
+ # @return [::Google::Api::CommonLanguageSettings]
214
+ # Some settings.
215
+ class RubySettings
216
+ include ::Google::Protobuf::MessageExts
217
+ extend ::Google::Protobuf::MessageExts::ClassMethods
218
+ end
219
+
220
+ # Settings for Go client libraries.
221
+ # @!attribute [rw] common
222
+ # @return [::Google::Api::CommonLanguageSettings]
223
+ # Some settings.
224
+ class GoSettings
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
228
+
229
+ # Describes the generator configuration for a method.
230
+ # @!attribute [rw] selector
231
+ # @return [::String]
232
+ # The fully qualified name of the method, for which the options below apply.
233
+ # This is used to find the method to apply the options.
234
+ # @!attribute [rw] long_running
235
+ # @return [::Google::Api::MethodSettings::LongRunning]
236
+ # Describes settings to use for long-running operations when generating
237
+ # API methods for RPCs. Complements RPCs that use the annotations in
238
+ # google/longrunning/operations.proto.
239
+ #
240
+ # Example of a YAML configuration::
241
+ #
242
+ # publishing:
243
+ # method_behavior:
244
+ # - selector: CreateAdDomain
245
+ # long_running:
246
+ # initial_poll_delay:
247
+ # seconds: 60 # 1 minute
248
+ # poll_delay_multiplier: 1.5
249
+ # max_poll_delay:
250
+ # seconds: 360 # 6 minutes
251
+ # total_poll_timeout:
252
+ # seconds: 54000 # 90 minutes
253
+ class MethodSettings
254
+ include ::Google::Protobuf::MessageExts
255
+ extend ::Google::Protobuf::MessageExts::ClassMethods
256
+
257
+ # Describes settings to use when generating API methods that use the
258
+ # long-running operation pattern.
259
+ # All default values below are from those used in the client library
260
+ # generators (e.g.
261
+ # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
262
+ # @!attribute [rw] initial_poll_delay
263
+ # @return [::Google::Protobuf::Duration]
264
+ # Initial delay after which the first poll request will be made.
265
+ # Default value: 5 seconds.
266
+ # @!attribute [rw] poll_delay_multiplier
267
+ # @return [::Float]
268
+ # Multiplier to gradually increase delay between subsequent polls until it
269
+ # reaches max_poll_delay.
270
+ # Default value: 1.5.
271
+ # @!attribute [rw] max_poll_delay
272
+ # @return [::Google::Protobuf::Duration]
273
+ # Maximum time between two subsequent poll requests.
274
+ # Default value: 45 seconds.
275
+ # @!attribute [rw] total_poll_timeout
276
+ # @return [::Google::Protobuf::Duration]
277
+ # Total polling timeout.
278
+ # Default value: 5 minutes.
279
+ class LongRunning
280
+ include ::Google::Protobuf::MessageExts
281
+ extend ::Google::Protobuf::MessageExts::ClassMethods
282
+ end
283
+ end
284
+
285
+ # The organization for which the client libraries are being published.
286
+ # Affects the url where generated docs are published, etc.
287
+ module ClientLibraryOrganization
288
+ # Not useful.
289
+ CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
290
+
291
+ # Google Cloud Platform Org.
292
+ CLOUD = 1
293
+
294
+ # Ads (Advertising) Org.
295
+ ADS = 2
296
+
297
+ # Photos Org.
298
+ PHOTOS = 3
299
+
300
+ # Street View Org.
301
+ STREET_VIEW = 4
302
+ end
303
+
304
+ # To where should client libraries be published?
305
+ module ClientLibraryDestination
306
+ # Client libraries will neither be generated nor published to package
307
+ # managers.
308
+ CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
309
+
310
+ # Generate the client library in a repo under github.com/googleapis,
311
+ # but don't publish it to package managers.
312
+ GITHUB = 10
313
+
314
+ # Publish the library to package managers like nuget.org and npmjs.com.
315
+ PACKAGE_MANAGER = 20
316
+ end
317
+ end
318
+ end
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # The launch stage as defined by [Google Cloud Platform
23
+ # Launch Stages](https://cloud.google.com/terms/launch-stages).
24
+ module LaunchStage
25
+ # Do not use this default value.
26
+ LAUNCH_STAGE_UNSPECIFIED = 0
27
+
28
+ # The feature is not yet implemented. Users can not use it.
29
+ UNIMPLEMENTED = 6
30
+
31
+ # Prelaunch features are hidden from users and are only visible internally.
32
+ PRELAUNCH = 7
33
+
34
+ # Early Access features are limited to a closed group of testers. To use
35
+ # these features, you must sign up in advance and sign a Trusted Tester
36
+ # agreement (which includes confidentiality provisions). These features may
37
+ # be unstable, changed in backward-incompatible ways, and are not
38
+ # guaranteed to be released.
39
+ EARLY_ACCESS = 1
40
+
41
+ # Alpha is a limited availability test for releases before they are cleared
42
+ # for widespread use. By Alpha, all significant design issues are resolved
43
+ # and we are in the process of verifying functionality. Alpha customers
44
+ # need to apply for access, agree to applicable terms, and have their
45
+ # projects allowlisted. Alpha releases don't have to be feature complete,
46
+ # no SLAs are provided, and there are no technical support obligations, but
47
+ # they will be far enough along that customers can actually use them in
48
+ # test environments or for limited-use tests -- just like they would in
49
+ # normal production cases.
50
+ ALPHA = 2
51
+
52
+ # Beta is the point at which we are ready to open a release for any
53
+ # customer to use. There are no SLA or technical support obligations in a
54
+ # Beta release. Products will be complete from a feature perspective, but
55
+ # may have some open outstanding issues. Beta releases are suitable for
56
+ # limited production use cases.
57
+ BETA = 3
58
+
59
+ # GA features are open to all developers and are considered stable and
60
+ # fully qualified for production use.
61
+ GA = 4
62
+
63
+ # Deprecated features are scheduled to be shut down and removed. For more
64
+ # information, see the "Deprecation Policy" section of our [Terms of
65
+ # Service](https://cloud.google.com/terms/)
66
+ # and the [Google Cloud Platform Subject to the Deprecation
67
+ # Policy](https://cloud.google.com/terms/deprecation) documentation.
68
+ DEPRECATED = 5
69
+ end
70
+ end
71
+ end
@@ -21,19 +21,20 @@ module Google
21
21
  module Cloud
22
22
  module Memcache
23
23
  module V1
24
+ # A Memorystore for Memcached instance
24
25
  # @!attribute [rw] name
25
26
  # @return [::String]
26
27
  # Required. Unique name of the resource in this scope including project and
27
28
  # location using the form:
28
29
  # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
29
30
  #
30
- # Note: Memcached instances are managed and addressed at regional level so
31
- # location_id here refers to a GCP region; however, users may choose which
32
- # zones Memcached nodes within an instances should be provisioned in.
33
- # Refer to [zones] field for more details.
31
+ # Note: Memcached instances are managed and addressed at the regional level
32
+ # so `location_id` here refers to a Google Cloud region; however, users may
33
+ # choose which zones Memcached nodes should be provisioned in within an
34
+ # instance. Refer to {::Google::Cloud::Memcache::V1::Instance#zones zones} field for more details.
34
35
  # @!attribute [rw] display_name
35
36
  # @return [::String]
36
- # User provided name for the instance only used for display
37
+ # User provided name for the instance, which is only used for display
37
38
  # purposes. Cannot be more than 80 characters.
38
39
  # @!attribute [rw] labels
39
40
  # @return [::Google::Protobuf::Map{::String => ::String}]
@@ -48,7 +49,7 @@ module Google
48
49
  # will be used.
49
50
  # @!attribute [rw] zones
50
51
  # @return [::Array<::String>]
51
- # Zones where Memcached nodes should be provisioned in.
52
+ # Zones in which Memcached nodes should be provisioned.
52
53
  # Memcached nodes will be equally distributed across these zones. If not
53
54
  # provided, the service will by default create nodes in all zones in the
54
55
  # region for the instance.
@@ -62,17 +63,17 @@ module Google
62
63
  # @return [::Google::Cloud::Memcache::V1::MemcacheVersion]
63
64
  # The major version of Memcached software.
64
65
  # If not provided, latest supported version will be used. Currently the
65
- # latest supported major version is MEMCACHE_1_5.
66
+ # latest supported major version is `MEMCACHE_1_5`.
66
67
  # The minor version will be automatically determined by our system based on
67
68
  # the latest supported minor version.
68
69
  # @!attribute [rw] parameters
69
70
  # @return [::Google::Cloud::Memcache::V1::MemcacheParameters]
70
- # Optional: User defined parameters to apply to the memcached process
71
+ # User defined parameters to apply to the memcached process
71
72
  # on each node.
72
73
  # @!attribute [r] memcache_nodes
73
74
  # @return [::Array<::Google::Cloud::Memcache::V1::Instance::Node>]
74
75
  # Output only. List of Memcached nodes.
75
- # Refer to [Node] message for more details.
76
+ # Refer to {::Google::Cloud::Memcache::V1::Instance::Node Node} message for more details.
76
77
  # @!attribute [r] create_time
77
78
  # @return [::Google::Protobuf::Timestamp]
78
79
  # Output only. The time the instance was created.
@@ -90,10 +91,18 @@ module Google
90
91
  # The full version format will be "memcached-1.5.16".
91
92
  # @!attribute [rw] instance_messages
92
93
  # @return [::Array<::Google::Cloud::Memcache::V1::Instance::InstanceMessage>]
93
- # List of messages that describe current statuses of memcached instance.
94
+ # List of messages that describe the current state of the Memcached instance.
94
95
  # @!attribute [r] discovery_endpoint
95
96
  # @return [::String]
96
- # Output only. Endpoint for Discovery API
97
+ # Output only. Endpoint for the Discovery API.
98
+ # @!attribute [rw] maintenance_policy
99
+ # @return [::Google::Cloud::Memcache::V1::MaintenancePolicy]
100
+ # The maintenance policy for the instance. If not provided,
101
+ # the maintenance event will be performed based on Memorystore
102
+ # internal rollout schedule.
103
+ # @!attribute [r] maintenance_schedule
104
+ # @return [::Google::Cloud::Memcache::V1::MaintenanceSchedule]
105
+ # Output only. Published maintenance schedule.
97
106
  class Instance
98
107
  include ::Google::Protobuf::MessageExts
99
108
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -192,6 +201,10 @@ module Google
192
201
  # Memcached instance has been created and ready to be used.
193
202
  READY = 2
194
203
 
204
+ # Memcached instance is updating configuration such as maintenance policy
205
+ # and schedule.
206
+ UPDATING = 3
207
+
195
208
  # Memcached instance is being deleted.
196
209
  DELETING = 4
197
210
 
@@ -200,6 +213,93 @@ module Google
200
213
  end
201
214
  end
202
215
 
216
+ # Maintenance policy per instance.
217
+ # @!attribute [r] create_time
218
+ # @return [::Google::Protobuf::Timestamp]
219
+ # Output only. The time when the policy was created.
220
+ # @!attribute [r] update_time
221
+ # @return [::Google::Protobuf::Timestamp]
222
+ # Output only. The time when the policy was updated.
223
+ # @!attribute [rw] description
224
+ # @return [::String]
225
+ # Description of what this policy is for. Create/Update methods
226
+ # return INVALID_ARGUMENT if the length is greater than 512.
227
+ # @!attribute [rw] weekly_maintenance_window
228
+ # @return [::Array<::Google::Cloud::Memcache::V1::WeeklyMaintenanceWindow>]
229
+ # Required. Maintenance window that is applied to resources covered by this
230
+ # policy. Minimum 1. For the current version, the maximum number of
231
+ # weekly_maintenance_windows is expected to be one.
232
+ class MaintenancePolicy
233
+ include ::Google::Protobuf::MessageExts
234
+ extend ::Google::Protobuf::MessageExts::ClassMethods
235
+ end
236
+
237
+ # Time window specified for weekly operations.
238
+ # @!attribute [rw] day
239
+ # @return [::Google::Type::DayOfWeek]
240
+ # Required. Allows to define schedule that runs specified day of the week.
241
+ # @!attribute [rw] start_time
242
+ # @return [::Google::Type::TimeOfDay]
243
+ # Required. Start time of the window in UTC.
244
+ # @!attribute [rw] duration
245
+ # @return [::Google::Protobuf::Duration]
246
+ # Required. Duration of the time window.
247
+ class WeeklyMaintenanceWindow
248
+ include ::Google::Protobuf::MessageExts
249
+ extend ::Google::Protobuf::MessageExts::ClassMethods
250
+ end
251
+
252
+ # Upcoming maintenance schedule.
253
+ # @!attribute [r] start_time
254
+ # @return [::Google::Protobuf::Timestamp]
255
+ # Output only. The start time of any upcoming scheduled maintenance for this instance.
256
+ # @!attribute [r] end_time
257
+ # @return [::Google::Protobuf::Timestamp]
258
+ # Output only. The end time of any upcoming scheduled maintenance for this instance.
259
+ # @!attribute [r] schedule_deadline_time
260
+ # @return [::Google::Protobuf::Timestamp]
261
+ # Output only. The deadline that the maintenance schedule start time can not go beyond,
262
+ # including reschedule.
263
+ class MaintenanceSchedule
264
+ include ::Google::Protobuf::MessageExts
265
+ extend ::Google::Protobuf::MessageExts::ClassMethods
266
+ end
267
+
268
+ # Request for {::Google::Cloud::Memcache::V1::CloudMemcache::Client#reschedule_maintenance RescheduleMaintenance}.
269
+ # @!attribute [rw] instance
270
+ # @return [::String]
271
+ # Required. Memcache instance resource name using the form:
272
+ # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
273
+ # where `location_id` refers to a GCP region.
274
+ # @!attribute [rw] reschedule_type
275
+ # @return [::Google::Cloud::Memcache::V1::RescheduleMaintenanceRequest::RescheduleType]
276
+ # Required. If reschedule type is SPECIFIC_TIME, must set up schedule_time as well.
277
+ # @!attribute [rw] schedule_time
278
+ # @return [::Google::Protobuf::Timestamp]
279
+ # Timestamp when the maintenance shall be rescheduled to if
280
+ # reschedule_type=SPECIFIC_TIME, in RFC 3339 format, for
281
+ # example `2012-11-15T16:19:00.094Z`.
282
+ class RescheduleMaintenanceRequest
283
+ include ::Google::Protobuf::MessageExts
284
+ extend ::Google::Protobuf::MessageExts::ClassMethods
285
+
286
+ # Reschedule options.
287
+ module RescheduleType
288
+ # Not set.
289
+ RESCHEDULE_TYPE_UNSPECIFIED = 0
290
+
291
+ # If the user wants to schedule the maintenance to happen now.
292
+ IMMEDIATE = 1
293
+
294
+ # If the user wants to use the existing maintenance policy to find the
295
+ # next available window.
296
+ NEXT_AVAILABLE_WINDOW = 2
297
+
298
+ # If the user wants to reschedule the maintenance to a specific time.
299
+ SPECIFIC_TIME = 3
300
+ end
301
+ end
302
+
203
303
  # Request for {::Google::Cloud::Memcache::V1::CloudMemcache::Client#list_instances ListInstances}.
204
304
  # @!attribute [rw] parent
205
305
  # @return [::String]
@@ -211,18 +311,17 @@ module Google
211
311
  # The maximum number of items to return.
212
312
  #
213
313
  # If not specified, a default value of 1000 will be used by the service.
214
- # Regardless of the page_size value, the response may include a partial list
215
- # and a caller should only rely on response's
216
- # [next_page_token][CloudMemcache.ListInstancesResponse.next_page_token]
314
+ # Regardless of the `page_size` value, the response may include a partial
315
+ # list and a caller should only rely on response's
316
+ # {::Google::Cloud::Memcache::V1::ListInstancesResponse#next_page_token `next_page_token`}
217
317
  # to determine if there are more instances left to be queried.
218
318
  # @!attribute [rw] page_token
219
319
  # @return [::String]
220
- # The next_page_token value returned from a previous List request,
221
- # if any.
320
+ # The `next_page_token` value returned from a previous List request, if any.
222
321
  # @!attribute [rw] filter
223
322
  # @return [::String]
224
323
  # List filter. For example, exclude all Memcached instances with name as
225
- # my-instance by specifying "name != my-instance".
324
+ # my-instance by specifying `"name != my-instance"`.
226
325
  # @!attribute [rw] order_by
227
326
  # @return [::String]
228
327
  # Sort results. Supported values are "name", "name desc" or "" (unsorted).
@@ -277,9 +376,9 @@ module Google
277
376
  # * Must start with a letter.
278
377
  # * Must be between 1-40 characters.
279
378
  # * Must end with a number or a letter.
280
- # * Must be unique within the user project / location
379
+ # * Must be unique within the user project / location.
281
380
  #
282
- # If any of the above are not met, will raise an invalid argument error.
381
+ # If any of the above are not met, the API raises an invalid argument error.
283
382
  # @!attribute [rw] instance
284
383
  # @return [::Google::Cloud::Memcache::V1::Instance]
285
384
  # Required. A Memcached Instance
@@ -292,6 +391,7 @@ module Google
292
391
  # @!attribute [rw] update_mask
293
392
  # @return [::Google::Protobuf::FieldMask]
294
393
  # Required. Mask of fields to update.
394
+ #
295
395
  # * `displayName`
296
396
  # @!attribute [rw] instance
297
397
  # @return [::Google::Cloud::Memcache::V1::Instance]
@@ -320,12 +420,12 @@ module Google
320
420
  # should be applied.
321
421
  # @!attribute [rw] node_ids
322
422
  # @return [::Array<::String>]
323
- # Nodes to which we should apply the instance-level parameter group.
423
+ # Nodes to which the instance-level parameter group is applied.
324
424
  # @!attribute [rw] apply_all
325
425
  # @return [::Boolean]
326
426
  # Whether to apply instance-level parameter group to all nodes. If set to
327
- # true, will explicitly restrict users from specifying any nodes, and apply
328
- # parameter group updates to all nodes within the instance.
427
+ # true, users are restricted from specifying individual nodes, and
428
+ # `ApplyParameters` updates all nodes within the instance.
329
429
  class ApplyParametersRequest
330
430
  include ::Google::Protobuf::MessageExts
331
431
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -351,8 +451,9 @@ module Google
351
451
  # @return [::String]
352
452
  # Output only. The unique ID associated with this set of parameters. Users
353
453
  # can use this id to determine if the parameters associated with the instance
354
- # differ from the parameters associated with the nodes and any action needs
355
- # to be taken to apply parameters on nodes.
454
+ # differ from the parameters associated with the nodes. A discrepancy between
455
+ # parameter ids can inform users that they may need to take action to apply
456
+ # parameters on nodes.
356
457
  # @!attribute [rw] params
357
458
  # @return [::Google::Protobuf::Map{::String => ::String}]
358
459
  # User defined set of parameters to use in the memcached process.
@@ -400,6 +501,31 @@ module Google
400
501
  extend ::Google::Protobuf::MessageExts::ClassMethods
401
502
  end
402
503
 
504
+ # Metadata for the given `::Google::Cloud::Location::Location`.
505
+ # @!attribute [r] available_zones
506
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Memcache::V1::ZoneMetadata}]
507
+ # Output only. The set of available zones in the location. The map is keyed
508
+ # by the lowercase ID of each zone, as defined by GCE. These keys can be
509
+ # specified in the `zones` field when creating a Memcached instance.
510
+ class LocationMetadata
511
+ include ::Google::Protobuf::MessageExts
512
+ extend ::Google::Protobuf::MessageExts::ClassMethods
513
+
514
+ # @!attribute [rw] key
515
+ # @return [::String]
516
+ # @!attribute [rw] value
517
+ # @return [::Google::Cloud::Memcache::V1::ZoneMetadata]
518
+ class AvailableZonesEntry
519
+ include ::Google::Protobuf::MessageExts
520
+ extend ::Google::Protobuf::MessageExts::ClassMethods
521
+ end
522
+ end
523
+
524
+ class ZoneMetadata
525
+ include ::Google::Protobuf::MessageExts
526
+ extend ::Google::Protobuf::MessageExts::ClassMethods
527
+ end
528
+
403
529
  # Memcached versions supported by our service.
404
530
  module MemcacheVersion
405
531
  MEMCACHE_VERSION_UNSPECIFIED = 0