- release_tracks: [ALPHA]

  help_text:
    brief: Update a Cloud Spanner instance.
    description: Update a Cloud Spanner instance.
    examples: |
      To update the display name of a Cloud Spanner instance, run:

        $ {command} my-instance-id --description=my-new-display-name

      To update the node count of a Cloud Spanner instance, run:

        $ {command} my-instance-id --nodes=1

  arguments:
    resource:
      help_text: The Cloud Spanner instance to update.
      spec: !REF googlecloudsdk.command_lib.spanner.resources:instance
    params:
    - arg_name: description
      api_field: updateInstanceRequest.instance.displayName
      help_text: The descriptive name for this instance as it appears in UIs. Must
        be unique per project and between 4 and 30 characters in length.
    - arg_name: nodes
      api_field: updateInstanceRequest.instance.nodeCount
      help_text: The number of nodes allocated to this instance to update.

  request:
    collection: spanner.projects.instances

  async:
    collection: spanner.projects.instances.operations