Deprecate API v2

Officially deprecate API v2 to encourage users to move to API v3.

Change-Id: I913c44799cddc37c3342729ec0ef34068db5b2d4

api-ref/source/v2/index.rst

@@ -1,8 +1,8 @@
 :tocdepth: 2
 
-================================
-Block Storage API V2 (SUPPORTED)
-================================
+=================================
+Block Storage API V2 (DEPRECATED)
+=================================
 
 .. rest_expand_all::
 

cinder/api/versions.py

@@ -50,10 +50,10 @@ _KNOWN_VERSIONS = {
     },
     "v2.0": {
         "id": "v2.0",
-        "status": "SUPPORTED",
+        "status": "DEPRECATED",
         "version": "",
         "min_version": "",
-        "updated": "2014-06-28T12:20:21Z",
+        "updated": "2017-02-25T12:00:00Z",
         "links": _LINKS,
         "media-types": _MEDIA_TYPES,
     },

releasenotes/notes/deprecate-api-v2-9f4543ab2e14b018.yaml

@@ -0,0 +1,7 @@
+---
+deprecations:
+  - |
+    The Cinder v2 API has now been marked as deprecated. All new client code
+    should use the v3 API. API v3 adds support for microversioned API calls.
+    If no microversion is requested, the base 3.0 version for the v3 API is
+    identical to v2.