Deprecate the unused instance-name

The '--instnace-name' option exists in nova CLI for a long time,
but it is not used, so we deprecate it firstly and will remove it in
T release.


Change-Id: I0c3d611fc322ae2c9f28ce3845b1c08eaab69485
Closes-Bug: #1788182

novaclient/v2/shell.py

@@ -1379,7 +1379,9 @@ def _print_flavor(flavor):
     dest='instance_name',
     metavar='<name-regexp>',
     default=None,
-    help=_('Search with regular expression match by server name.'))
+    action=shell.DeprecatedAction,
+    help=_('Search with regular expression match by server name. The option '
+           'is not used and will be removed in T release.'))
 @utils.arg(
     '--status',
     dest='status',

releasenotes/notes/deprecate-instance-name-option-bc76629d28f1d456.yaml

@@ -0,0 +1,7 @@
+---
+deprecations:
+  - |
+    The ``--instance-name`` option has been deprecated from the ``nova list``
+    command because the instance name query parameter is ignored by the
+    compute REST API.
+