api-ref: document microversions for the attachments API
The attachments API is completely new in the 3.27 API so
that should be pointed out in the API reference. The only
wrinkle is the 'complete attachment' API which is new in 3.44.
Partial-Bug:
@@ -6,6 +6,10 @@ Attachments
Lists all, lists all with details, shows details for, creates, and
deletes attachment.
+.. note:: Everything except for `Complete attachment` is new as of the 3.27
+ microversion. `Complete attachment` is new as of the 3.44
+ microversion.
+
Delete attachment
~~~~~~~~~~~~~~~~~
@@ -14,6 +18,8 @@ Delete attachment
Deletes an attachment.
+Available starting in the 3.27 microversion.
+
Normal response codes: 200
Error response codes: badRequest(400), itemNotFound(404)
@@ -35,6 +41,7 @@ Show attachment details
Shows details for an attachment.
+Available starting in the 3.27 microversion.
Normal response codes: 200
@@ -79,6 +86,8 @@ List attachments with details
Lists all attachments with details. Since v3.31 if non-admin
users specify invalid filters in the url, API will return bad request.
+Available starting in the 3.27 microversion.
+
Normal response codes: 200
Error response codes: badRequest(400)
@@ -123,6 +132,7 @@ List attachments
Lists all attachments, since v3.31 if non-admin users
specify invalid filters in the url, API will return bad request.
+Available starting in the 3.27 microversion.
Normal response codes: 200
@@ -166,6 +176,8 @@ Create attachment
Creates an attachment.
+Available starting in the 3.27 microversion.
+
Normal response codes: 202
Error response codes: badRequest(400), itemNotFound(404)
@@ -218,6 +230,8 @@ Update an attachment
Update a reserved attachment record with connector information
and set up the appropriate connection_info from the driver.
+Available starting in the 3.27 microversion.
+
Normal response codes: 200
Error response codes: badRequest(400), itemNotFound(404)
@@ -267,6 +281,8 @@ Complete attachment
Complete an attachment for a cinder volume.
+Available starting in the 3.44 microversion.
+
Normal response codes: 202
Error response codes: badRequest(400), itemNotFound(404)
