feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/__init__.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command group for Cloud Memorystore Memcached instances."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Instances(base.Group):
+  """Manage Cloud Memorystore Memcached instances."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/apply_parameters.yaml

@@ -0,0 +1,56 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Apply parameter update to nodes in a Memorystore Memcached instance.
+    description: |
+      Apply a parameter update to nodes in a Memcached instance from the current configuration
+      parameters staged in the instance metadata.
+
+      Applying a parameter update to a node causes a full cache flush on that node.
+    examples: |
+      To apply parameter update to nodes 'node-1' and 'node-2' of a Memcached
+      instance named 'my-memcache-instance' in region 'us-central1', run:
+
+        $ {command} my-memcache-instance --node-ids=node-1,node-2 --region=us-central1
+
+      To apply parameter update to all nodes of a Memcached instance named 'my-memcache-instance'
+      in region 'us-central1', run:
+
+        $ {command} my-memcache-instance --apply-all --region=us-central1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+      help_text: |
+        Arguments and flags that specify the Memcached instance on which to apply parameter update.
+    params:
+    - group:
+        mutex: true
+        required: true
+        params:
+        - arg_name: node-ids
+          api_field: applyParametersRequest.nodeIds
+          type: arg_list
+          help_text: |
+            Nodes on which to apply the parameter update.
+        - arg_name: apply-all
+          api_field: applyParametersRequest.applyAll
+          help_text: |
+            Apply the parameter update onto all nodes.
+
+  async:
+    collection: memcache.projects.locations.operations
+
+  input:
+    confirmation_prompt: |
+      WARNING: Applying parameters will cause a full cache flush to the selected nodes in instance [{__name__}] in [{locationsId}].
+
+  request:
+    ALPHA:
+      api_version: v1beta2
+    BETA:
+      api_version: v1beta2
+    GA:
+      api_version: v1
+    collection: memcache.projects.locations.instances
+    method: applyParameters

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/apply_software_update.yaml

@@ -0,0 +1,58 @@
+- release_tracks: [ALPHA, BETA, GA]
+  GA:
+    hidden: true
+  help_text:
+    brief: |
+      Apply software update to nodes in a Memorystore Memcached instance.
+    description: |
+      Apply a software update to nodes in a Memcached instance to the latest available software
+      version.
+
+      To check if a Memcache instance and its nodes have a new software update available, run:
+
+        $ gcloud beta memcache instances describe my-memcache-instance --format="table(updateAvailable.yesno(),memcacheNodes:format='table(nodeId,updateAvailable.yesno())')" --region=us-central1
+
+      Applying a software update to a node causes a full cache flush on that node.
+    examples: |
+      To apply software update to nodes 'node-1' and 'node-2' of a Memcached
+      instance named 'my-memcache-instance' in region 'us-central1', run:
+
+        $ {command} my-memcache-instance --node-ids=node-1,node-2 --region=us-central1
+
+      To apply software update to all nodes of a Memcached instance named 'my-memcache-instance'
+      in region 'us-central1', run:
+
+        $ {command} my-memcache-instance --apply-all --region=us-central1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+      help_text: |
+        Arguments and flags that specify the Memcached instance on which to apply software update.
+    params:
+    - group:
+        mutex: true
+        required: true
+        params:
+        - arg_name: node-ids
+          api_field: applySoftwareUpdateRequest.nodeIds
+          type: arg_list
+          help_text: |
+            Nodes on which to apply the software update.
+        - arg_name: apply-all
+          api_field: applySoftwareUpdateRequest.applyAll
+          help_text: |
+            Apply the software update onto all nodes.
+
+  async:
+    collection: memcache.projects.locations.operations
+
+  input:
+    confirmation_prompt: |
+      WARNING: Applying software update will cause a full cache flush to the selected nodes in
+      instance [{__name__}] in [{locationsId}].
+
+  request:
+    api_version: v1beta2
+    collection: memcache.projects.locations.instances
+    method: applySoftwareUpdate

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/config/__init__.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command group for managing Memcache instance configurations."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Config(base.Group):
+  """Manage Memcache instance configurations."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/config/export.yaml

@@ -0,0 +1,38 @@
+release_tracks: [ALPHA]
+command_type: CONFIG_EXPORT
+help_text:
+  brief: Export the configuration for a Memcache instance.
+  description: |
+    *{command}* exports the configuration for a Memcache instance.
+
+    Instance configurations can be exported in
+    Kubernetes Resource Model (krm) or Terraform HCL formats. The
+    default format is `krm`.
+
+    Specifying `--all` allows you to export the configurations for all
+    instances within the project.
+
+    Specifying `--path` allows you to export the configuration(s) to
+    a local directory.
+  examples: |
+    To export the configuration for an instance, run:
+
+      $ {command} my-instance
+
+    To export the configuration for an instance to a file, run:
+
+      $ {command} my-instance --path=/path/to/dir/
+
+    To export the configuration for an instance in Terraform
+    HCL format, run:
+
+      $ {command} my-instance --resource-format=terraform
+
+    To export the configurations for all instances within a
+    project, run:
+
+      $ {command} --all
+arguments:
+  resource:
+    help_text: Instance to export the configuration for.
+    spec: !REF googlecloudsdk.command_lib.memcache.resources:instance

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/create.yaml

@@ -0,0 +1,193 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Create a Memorystore Memcached instance.
+    description: |
+      Create a new Memorystore Memcached instance.
+
+      This command can fail for the following reasons:
+        * An instance with the same name already exists.
+        * The active account does not have the necessary permissions to create instances.
+    examples: |
+      To create a Memcached instance named 'my-memcache-instance' in region 'us-central1'
+      with 3 nodes, each with 2 CPUs and 2GB of memory, run:
+
+        $ {command} my-memcache-instance --region=us-central1 \
+            --node-count=3 --node-cpu=2 --node-memory=2GB
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+      help_text: |
+        Arguments and flags that specify the Memcached instance to create.
+    params:
+    - arg_name: display-name
+      api_field: instance.displayName
+      help_text: An arbitrary and optional user provided name for the instance.
+    - arg_name: labels
+      api_field: instance.labels.additionalProperties
+      metavar: KEY=VALUE
+      help_text: |
+        List of label KEY=VALUE pairs to add.
+      type:
+        arg_dict:
+          flatten: true
+          spec:
+          - api_field: key
+          - api_field: value
+    - arg_name: tags
+      # TODO(b/347173013): Remove hidden as part of GA launch.
+      hidden: true
+      metavar: KEY=VALUE
+      api_field: instance.tags.additionalProperties
+      help_text: |
+        List of tag KEY=VALUE pairs to add.
+      type:
+        arg_dict:
+          flatten: true
+          spec:
+          - api_field: key
+          - api_field: value
+    - arg_name: authorized-network
+      api_field: instance.authorizedNetwork
+      help_text: |
+        Full name of the Google Compute Engine network to which the instance
+        is connected. If unspecified, the default network will be used.
+    - arg_name: zones
+      api_field: instance.zones
+      type: arg_list
+      help_text: |
+        List of zones for the memcache nodes. The nodes will be divided
+        equally across the given zones up to --node-count value. If not
+        provided, the service will by default create nodes in all zones in the
+        region specified by --region flag.
+    - arg_name: node-count
+      help_text: Number of memcache nodes in this instance. Valid values range from 1 to 20.
+      api_field: instance.nodeCount
+      required: true
+    - arg_name: node-cpu
+      api_field: instance.nodeConfig.cpuCount
+      help_text: |
+        Number of cpus per node in this instance. Valid values are 1 or even
+        number between 2-32. Value of 1 is not supported in all regions.
+      required: true
+    # Check the range on this flag and then set it in the parser
+    - arg_name: node-memory
+      api_field: instance.nodeConfig.memorySizeMb
+      required: true
+      help_text: |
+        Amount of memory allocated per node in this instance. The value must be a whole number
+        followed by a size unit of 'MB' for megabyte, or 'GB' for gigabyte, ie '3072MB' or '9GB'.
+        The value must be between 1024MB and 307200MB.
+      default: 1024MB
+      type: googlecloudsdk.command_lib.memcache.instances_util:NodeMemory
+    - arg_name: memcached-version
+      api_field: instance.memcacheVersion
+      help_text: |
+        Optional major version of Memcached software to use with the instance.
+        If not provided, default of "1.5" will be used.
+      choices:
+      - arg_value: '1.5'
+        enum_value: MEMCACHE_1_5
+        help_text: Memcached major version 1.5
+      - arg_value: '1.6.15'
+        enum_value: MEMCACHE_1_6_15
+        help_text: Memcached version 1.6.15
+    - arg_name: maintenance-window-day
+      api_field: instance.maintenancePolicy.weeklyMaintenanceWindow.day
+      release_tracks: [ALPHA, BETA, GA]
+      choices:
+      - arg_value: monday
+        enum_value: MONDAY
+      - arg_value: tuesday
+        enum_value: TUESDAY
+      - arg_value: wednesday
+        enum_value: WEDNESDAY
+      - arg_value: thursday
+        enum_value: THURSDAY
+      - arg_value: friday
+        enum_value: FRIDAY
+      - arg_value: saturday
+        enum_value: SATURDAY
+      - arg_value: sunday
+        enum_value: SUNDAY
+      help_text: |
+        The day of week when the window starts, e.g. `sunday`.
+    - arg_name: maintenance-window-start-time
+      api_field: instance.maintenancePolicy.weeklyMaintenanceWindow.startTime.hours
+      release_tracks: [ALPHA, BETA, GA]
+      help_text: |
+        Hour of day (`0` to `23`) for the start of maintenance window, in UTC time zone.
+      processor: googlecloudsdk.command_lib.memcache.instances_util:CheckMaintenanceWindowStartTimeField
+    - arg_name: maintenance-window-duration
+      api_field: instance.maintenancePolicy.weeklyMaintenanceWindow.duration
+      release_tracks: [ALPHA, BETA, GA]
+      type: int
+      help_text: |
+        Duration in integer hours (`3` to `8`) of the maintenance window.
+      processor: googlecloudsdk.command_lib.memcache.instances_util:ConvertDurationToJsonFormat
+    - arg_name: parameters
+      api_field: instance.parameters.params
+      metavar: KEY=VALUE
+      help_text: |
+        User defined parameters to apply to the memcached process on each node. Possible attributes include:
+
+        *listen-backlog*::: The backlog queue limit for the instance.
+
+        *disable-flush-all*::: If enabled, flush_all command will be disabled. Applicable to
+        1.4.24 and higher.
+
+        *max-item-size*::: Max bytes of the instnace. Must at least be equal to slab_chunk_max
+        (which defaults to 524288 bytes) and less than 134217728 bytes. Additionally it must
+        be a multiple of slab_chunk_max.
+
+        *slab-min-size*::: This is an integer in the range [1, 1024].
+
+        *slab-growth-factor*::: This is a float in the range [1.01, 100].
+
+        *protocol*::: This is an enum with acceptable values of ["ascii", "auto"].
+
+        *disable-cas*::: This is a boolean value.
+
+        *disable-evictions*::: This is a boolean value.
+
+        *max-reqs-per-event*::: This is an integer in the range [1, 1000].
+
+        *track-sizes*::: This is a boolean value.
+
+        *worker-logbuf-size*::: This is an integer in the range [48, 524288].
+
+        *watcher-logbuf-size*::: This is an integer in the range [0, 2097151].
+
+        *lru-crawler*::: This is a boolean value.
+
+        *idle-timeout*::: This is an integer in the range [1,86400].
+
+        *lru-maintainer*::: This is a boolean value.
+
+        *maxconns-fast*::: This is a boolean value.
+
+        *hash-algorithm*::: This is an enum with accepted values of ["jenkins", "murmur3"].
+      type: "googlecloudsdk.command_lib.memcache.instances_util:Parameters"
+    - arg_name: reserved-ip-range-id
+      api_field: instance.reservedIpRangeId
+      release_tracks: [ALPHA, BETA, GA]
+      help_text: |
+        Contains the name of allocated IP address ranges associated with
+        the private service access connection for example, "test-default"
+        associated with IP range 10.0.0.0/29.
+
+  async:
+    collection: memcache.projects.locations.operations
+
+  request:
+    ALPHA:
+      api_version: v1beta2
+    BETA:
+      api_version: v1beta2
+    GA:
+      api_version: v1
+    collection: memcache.projects.locations.instances
+
+  output:
+    format: yaml

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/delete.yaml

@@ -0,0 +1,38 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Delete a Memorystore Memcached instance.
+    description: |
+      Delete a Memorystore Memcached instance.
+
+      This command can fail for the following reasons:
+        * The instance specified does not exist.
+        * The active account does not have permission to access the given
+          instance.
+    examples: |
+      To delete an instance named `my-memcache-instance` in region `us-central1`, run:
+
+        $ {command} my-memcache-instance --region=us-central1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+      help_text: |
+        Arguments and flags that specify the Memcached instance to delete.
+
+  async:
+    collection: memcache.projects.locations.operations
+
+  input:
+    confirmation_prompt: |
+      You are about to delete instance [{__name__}] in [{locationsId}].
+      Any associated data will be lost.
+
+  request:
+    ALPHA:
+      api_version: v1beta2
+    BETA:
+      api_version: v1beta2
+    GA:
+      api_version: v1
+    collection: memcache.projects.locations.instances

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/describe.yaml

@@ -0,0 +1,41 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Display metadata for a Memorystore Memcached instance.
+    description: |
+      Displays all metadata associated with a Memcached instance given a valid instance name.
+
+      This command can fail for the following reasons:
+        * The instance specified does not exist.
+        * The active account does not have permission to access the given instance.
+    examples: |
+      To display the metadata for an instance named `my-memcache-instance` in region `us-central1`,
+      run:
+
+        $ {command} my-memcache-instance --region=us-central1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+      help_text: |
+        Arguments and flags that specify the Memcached instance to describe.
+
+  request:
+    ALPHA:
+      api_version: v1beta2
+    BETA:
+      api_version: v1beta2
+    GA:
+      api_version: v1
+    collection: memcache.projects.locations.instances
+
+  response:
+    ALPHA:
+      modify_response_hooks:
+      - googlecloudsdk.command_lib.memcache.instances_describe_util:FormatResponse
+    BETA:
+      modify_response_hooks:
+      - googlecloudsdk.command_lib.memcache.instances_describe_util:FormatResponse
+    GA:
+      modify_response_hooks:
+      - googlecloudsdk.command_lib.memcache.instances_describe_util:FormatResponse

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/list.yaml

@@ -0,0 +1,49 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      List Memorystore Memcached instances.
+    description: |
+      List all Memcached instances under the specified project and region.
+
+      Specify the maximum number of instances to list using the `--limit` flag.
+    examples: |
+      To list all Memcached instances in region `us-central1`, run:
+
+          $ {command} --region=us-central1
+
+      To list up to five Memcached instances in region `us-central1`, run:
+
+          $ {command} --limit=5 --region=us-central1
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.memcache.resources:region
+      help_text: |
+        Region of the instances to display.
+
+  request:
+    ALPHA:
+      api_version: v1beta2
+    BETA:
+      api_version: v1beta2
+    GA:
+      api_version: v1
+    collection: memcache.projects.locations.instances
+
+  response:
+    id_field: name
+
+  output:
+    format: |
+      table(
+        name.basename():label=INSTANCE_NAME:sort=2,
+        name.segment(3):label=REGION,
+        authorizedNetwork.basename():label=NETWORK,
+        nodeCount:label=NODE_COUNT,
+        nodeConfig.cpuCount:label=NODE_CPU,
+        nodeConfig.memorySizeMb:label=NODE_MB,
+        memcacheVersion:label=MEMCACHED_VERSION,
+        state:label=STATUS,
+        createTime.date(),
+        updateTime.date()
+      )

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/reschedule_maintenance.yaml

@@ -0,0 +1,58 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Reschedule maintenance window for a Memcache instance.
+  description: |
+    Reschedule maintenance window for a Memcache instance.
+  examples: |
+    To reschedule maintenance window for an instance with the name 'my-memcache-instance' in region
+    'us-central-1' with next available window, run:
+
+      $ {command} my-memcache-instance --region=us-central1 --reschedule-type=next-available-window
+
+arguments:
+  resource:
+    spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+    help_text: |
+      Arguments and flags that specify the Cloud Memorystore for Memcache instance you
+      want to reschedule maintenance window.
+  params:
+  - arg_name: reschedule-type
+    api_field: rescheduleMaintenanceRequest.rescheduleType
+    required: true
+    choices:
+    - arg_value: IMMEDIATE
+      enum_value: IMMEDIATE
+      help_text: Reschedule the maintenance to perform now.
+    - arg_value: NEXT-AVAILABLE-WINDOW
+      enum_value: NEXT_AVAILABLE_WINDOW
+      help_text: Reschedule the maintenance to the next available window.
+    - arg_value: SPECIFIC-TIME
+      enum_value: SPECIFIC_TIME
+      help_text: Reschedule the maintenance to a specific time.
+    help_text: |
+      Reschedule type to use for the reschedule maintenance window.
+  - arg_name: schedule-time
+    api_field: rescheduleMaintenanceRequest.scheduleTime
+    help_text: |
+      Time in RFC3339 format, for example: 2012-11-15T16:19:00.094Z
+
+async:
+  collection: memcache.projects.locations.operations
+
+request:
+  ALPHA:
+    api_version: v1beta2
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.memcache.instances_reschedule_util:CheckSpecificTimeField
+  BETA:
+    api_version: v1beta2
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.memcache.instances_reschedule_util:CheckSpecificTimeField
+  GA:
+    api_version: v1
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.memcache.instances_reschedule_util:CheckSpecificTimeField
+  collection: memcache.projects.locations.instances
+  method: rescheduleMaintenance

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/update.yaml

@@ -0,0 +1,175 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Update a Memorystore Memcached instance.
+    description: |
+      Update a Memcached instance with one or more of the following actions:
+        * Scale up or down the number of nodes in the instance.
+        * Stage an update to instance configuration parameters.
+        * Update the instance metadata (display name, labels).
+
+      Updating parameters cannot be combined with any other update actions in the same call.
+      All other update actions can be combined in the same call.
+    examples: |
+      To scale a Memcached instance named 'my-memcache-instance' in region 'us-central1' to have
+      3 nodes, run:
+
+        $ {command} my-memcache-instance --node-count=3 --region=us-central1
+
+      To stage an update to the parameters 'protocol' and 'track-sizes' for a Memcached instance
+      named 'my-memcache-instance' in region 'us-central1', run:
+
+        $ {command} my-memcache-instance --parameters="protocol=ascii,track-sizes=true" \
+            --region=us-central1
+
+      To update a Memcached instance named 'my-memcache-instance' in region 'us-central1' to
+      have the display name "Foo Cache Service" and the labels 'env' and 'service', run:
+
+        $ {command} my-memcache-instance --display-name="Foo Cache Service" \
+            --labels="env=test,service=foo"
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+      help_text: |
+        Arguments and flags that specify the Memcached instance to update.
+    params:
+    - group:
+        mutex: true
+        required: true
+        params:
+        - group:
+            params:
+            - arg_name: display-name
+              api_field: instance.displayName
+              help_text: An arbitrary and optional user provided name for the instance.
+            - arg_name: tags
+              # TODO(b/347173013): Remove hidden as part of GA launch.
+              hidden: true
+              metavar: KEY=VALUE
+              api_field: instance.tags.additionalProperties
+              help_text: |
+                List of tag KEY=VALUE pairs to add.
+              type:
+                arg_dict:
+                  flatten: true
+                  spec:
+                  - api_field: key
+                  - api_field: value
+            - arg_name: labels
+              api_field: instance.labels.additionalProperties
+              metavar: KEY=VALUE
+              help_text: |
+                List of label KEY=VALUE pairs to add.
+              type:
+                arg_dict:
+                  flatten: true
+                  spec:
+                  - api_field: key
+                  - api_field: value
+            - arg_name: node-count
+              api_field: instance.nodeCount
+              help_text: |
+                Number of memcache nodes in this instance. Valid values range from 1 to 20.
+            - group:
+                release_tracks: [ALPHA, BETA, GA]
+                mutex: true
+                params:
+                - arg_name: maintenance-window-any
+                  action: store_true
+                  help_text: |
+                    Removes the user-specified maintenance window.
+                - group:
+                    params:
+                    - arg_name: maintenance-window-day
+                      release_tracks: [ALPHA, BETA, GA]
+                      api_field: instance.maintenancePolicy.weeklyMaintenanceWindow.day
+                      choices:
+                      - arg_value: monday
+                        enum_value: MONDAY
+                      - arg_value: tuesday
+                        enum_value: TUESDAY
+                      - arg_value: wednesday
+                        enum_value: WEDNESDAY
+                      - arg_value: thursday
+                        enum_value: THURSDAY
+                      - arg_value: friday
+                        enum_value: FRIDAY
+                      - arg_value: saturday
+                        enum_value: SATURDAY
+                      - arg_value: sunday
+                        enum_value: SUNDAY
+                      help_text: |
+                        The day of week when the window starts, e.g. 'sunday'.
+                    - arg_name: maintenance-window-start-time
+                      release_tracks: [ALPHA, BETA, GA]
+                      api_field: instance.maintenancePolicy.weeklyMaintenanceWindow.startTime.hours
+                      help_text: |
+                        Hour of day (0 to 23) for the start of maintenance window, in UTC time zone.
+                    - arg_name: maintenance-window-duration
+                      release_tracks: [ALPHA, BETA, GA]
+                      type: int
+                      api_field: instance.maintenancePolicy.weeklyMaintenanceWindow.duration
+                      processor: googlecloudsdk.command_lib.memcache.instances_util:ConvertDurationToJsonFormat
+                      help_text: |
+                        Duration in integer hours (`3` to `8`) of the maintenance window.
+        - arg_name: parameters
+          metavar: KEY=VALUE
+          help_text: |
+            User defined parameters to apply to the memcached process on each node. Possible attributes include:
+
+            *listen-backlog*::: The backlog queue limit for the instance.
+
+            *disable-flush-all*::: If enabled, flush_all command will be disabled. Applicable to
+            1.4.24 and higher.
+
+            *max-item-size*::: Max bytes of the instnace. Must at least be equal to slab_chunk_max
+            (which defaults to 524288 bytes) and less than 134217728 bytes. Additionally it must
+            be a multiple of slab_chunk_max.
+
+            *slab-min-size*::: This is an integer in the range [1, 1024].
+
+            *slab-growth-factor*::: This is a float in the range [1.01, 100].
+
+            *protocol*::: This is an enum with acceptable values of ["ascii", "auto"].
+
+            *disable-cas*::: This is a boolean value.
+
+            *disable-evictions*::: This is a boolean value.
+
+            *max-reqs-per-event*::: This is an integer in the range [1, 1000].
+
+            *track-sizes*::: This is a boolean value.
+
+            *worker-logbuf-size*::: This is an integer in the range [48, 524288].
+
+            *watcher-logbuf-size*::: This is an integer in the range [0, 2097151].
+
+            *lru-crawler*::: This is a boolean value.
+
+            *idle-timeout*::: This is an integer in the range [1,86400].
+
+            *lru-maintainer*::: This is a boolean value.
+
+            *maxconns-fast*::: This is a boolean value.
+
+            *hash-algorithm*::: This is an enum with accepted values of ["jenkins", "murmur3"].
+          type: "googlecloudsdk.command_lib.memcache.instances_util:Parameters"
+
+  async:
+    collection: memcache.projects.locations.operations
+
+  request:
+    ALPHA:
+      api_version: v1beta2
+    BETA:
+      api_version: v1beta2
+    GA:
+      api_version: v1
+    method: patch
+    # --parameters flag uses the method `updateParameters`, all other flags use method `patch`
+    modify_method_hook: googlecloudsdk.command_lib.memcache.instances_update_util:ChooseUpdateMethod
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.memcache.instances_update_util:ModifyMaintenanceMask
+    - googlecloudsdk.command_lib.memcache.instances_update_util:ModifyParams
+    collection: memcache.projects.locations.instances

gcloud auth application-default login/google-cloud-sdk/lib/surface/memcache/instances/upgrade.yaml

@@ -0,0 +1,50 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: |
+    Upgrade memcache instance to a newer memcached version
+  description: |
+    Upgrade memcahce instance to a newer memcached version.
+  examples: |
+    To upgrade memcache version of an instance with the name 'my-memcache-instance' in region
+    'us-central-1' to MEMCACHE_1_6_15
+
+      $ {command} my-memcache-instance --region=us-central1 --memcached-version="1.6.15"
+
+arguments:
+  resource:
+    spec: !REF googlecloudsdk.command_lib.memcache.resources:instance
+    help_text: |
+      Arguments and flags that specify the Memorystore for Memcached instance you
+      want to upgrade.
+  params:
+  - arg_name: memcached-version
+    ALPHA:
+      api_field: googleCloudMemcacheV1beta2UpgradeInstanceRequest.memcacheVersion
+    BETA:
+      api_field: googleCloudMemcacheV1beta2UpgradeInstanceRequest.memcacheVersion
+    GA:
+      api_field: googleCloudMemcacheV1UpgradeInstanceRequest.memcacheVersion
+    required: true
+    choices:
+    - arg_value: 1.6.15
+      enum_value: MEMCACHE_1_6_15
+      help_text: Memcached engine version 1.6.15
+    help_text: Memcached engine version to which instance should be upgraded to.
+
+async:
+  collection: memcache.projects.locations.operations
+
+input:
+  confirmation_prompt: |-
+    WARNING: Upgrading the Memcached instance causes a full cache flush on the instance. Some nodes of the instance are temporarily unavailable during the duration of upgrade. For more information, see the "Behaviour during version upgrade" section of the official Memorystore for Memcached documentation.
+
+request:
+  ALPHA:
+    api_version: v1beta2
+  BETA:
+    api_version: v1beta2
+  GA:
+    api_version: v1
+  collection: memcache.projects.locations.instances
+  method: upgrade