From f6d3454f608ec40570deb62997ccda8048f6e2dc Mon Sep 17 00:00:00 2001
From: Sean McGinnis <sean_mcginnis@dell.com>
Date: Sat, 25 Feb 2017 11:58:03 -0600
Subject: [PATCH] Deprecate API v2

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

Change-Id: I913c44799cddc37c3342729ec0ef34068db5b2d4
---
 api-ref/source/v2/index.rst                               | 6 +++---
 cinder/api/versions.py                                    | 4 ++--
 releasenotes/notes/deprecate-api-v2-9f4543ab2e14b018.yaml | 7 +++++++
 3 files changed, 12 insertions(+), 5 deletions(-)
 create mode 100644 releasenotes/notes/deprecate-api-v2-9f4543ab2e14b018.yaml

diff --git a/api-ref/source/v2/index.rst b/api-ref/source/v2/index.rst
index 5693ddf0218..058c3c6ef08 100644
--- a/api-ref/source/v2/index.rst
+++ b/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::
 
diff --git a/cinder/api/versions.py b/cinder/api/versions.py
index 01d31b310c9..ab08194df4f 100644
--- a/cinder/api/versions.py
+++ b/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,
     },
diff --git a/releasenotes/notes/deprecate-api-v2-9f4543ab2e14b018.yaml b/releasenotes/notes/deprecate-api-v2-9f4543ab2e14b018.yaml
new file mode 100644
index 00000000000..fa97c8483a3
--- /dev/null
+++ b/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.