514 Commits

Author SHA1 Message Date
Zuul
7ca51e9271 Merge "api-ref: clarify volume_type param in volume create API" 2018-10-02 16:57:24 +00:00
Zuul
a12071d219 Merge "api-ref: fix req/resp params for v3 os-quota-class-sets" 2018-10-02 16:57:20 +00:00
Zuul
526f09855d Merge "api-ref: remove encryption from Show-an-encryption-type" 2018-10-02 16:57:14 +00:00
Zuul
4ce1ae6574 Merge "api-ref: total/free_capacity should be with postfix _gb" 2018-10-01 20:02:49 +00:00
Zuul
4af90c30eb Merge "api-ref: namespace in extensions is optional" 2018-10-01 19:28:51 +00:00
Zuul
9805fe1067 Merge "services api ref: fix field enum value and add missing field" 2018-10-01 19:28:48 +00:00
Zuul
9d404d4eeb Merge "Add delete snapshot preconditions" 2018-10-01 18:03:11 +00:00
Felipe Monteiro
8d161d9d19 api-ref: Change extensions updated type to updated_at
This changes the updated type to be updated_at (the updated
type is just a string whereas updated_at is iso-8601 formatted
string).

This change is consistent with:

* examples for os-extensions in API docs [0]
* Nova API docs for os-extensions [1]

[0] https://developer.openstack.org/api-ref/block-storage/v3/index.html#id6
[1] https://developer.openstack.org/api-ref/compute/#id402

Change-Id: I806dbc66f35fd0d9209c25c35adc2d64f5b9f8ed
2018-09-30 10:25:46 -04:00
zhufl
dd9e1764e0 api-ref: remove encryption from Show-an-encryption-type
https://developer.openstack.org/api-ref/block-storage/v3/index.html#show-an-encryption-type
encryption is not a field in the response of "Show an encryption type",
this is to remove it.

Change-Id: Ie344e6f988cf71e97272910e84e0034ab8c317ff
2018-09-30 15:55:48 +08:00
zhufl
a87f2b92d0 hosts api ref: all fields should be of type string
I512bfc97a1c3d4a508daf580d99fefe2a9ae4e13 tries to add
schema validation for volume hosts, and there are some
inconsistencies in api ref doc.
https://developer.openstack.org/api-ref/block-storage/v3/index.html#show-host-details-for-a-project
as the Response Example shows, all fields should be of
type string, not integer.

Change-Id: I8c6c50be45a1c923a8b7091d14cd5ae994d6e2cc
2018-09-30 09:44:22 +08:00
Zuul
677966470d Merge "api-ref: add missing fields in volume types" 2018-09-29 13:22:34 +00:00
zhufl
bb703a9f4d api-ref: add missing response body for groups
1. https://developer.openstack.org/api-ref/block-storage/v3/#create-group
   "Create group" should have response body, like
    {
	"group": {
		"id": "2c311e17-9daa-4229-926a-cb9e233f06b0",
		"name": "tempest-GroupsTest-Group-938181552"
	}
    }

2. https://developer.openstack.org/api-ref/block-storage/v3/#create-group-from-source
   "Create group from source" should have response body, like
    {
        "group": {
                "id": "2c311e17-9daa-4229-926a-cb9e233f06b0",
                "name": "tempest-GroupsTest-Group-938181552"
        }
    }

3. https://developer.openstack.org/api-ref/block-storage/v3/#show-group-details
   group_type in "Show group details" or "List groups with details"
   or "Create group" should be an uuid string, not object.

4. group_snapshot_id and source_group_id should be optional in the
   response of "Show group details".

Change-Id: Iea0c8f0f6fec1b8460c4ea53ed6468adbc31abf2
2018-09-29 17:24:11 +08:00
Zuul
57e0afa724 Merge "Adding variable for total gigabytes used by snapshot param" 2018-09-28 16:59:57 +00:00
zhufl
c141210246 api-ref: add missing fields in volume types
There are some fields missing in volume types api ref,
1. https://developer.openstack.org/api-ref/block-storage/v3/index.html#show-volume-type-detail
"os-volume-type-access:is_public" and "qos_specs_id" are missing
from the response of "Show volume type detail".

2. https://developer.openstack.org/api-ref/block-storage/v3/index.html#update-a-volume-type
"id" is missing from the response of "Updates a volume type."

Change-Id: I5f24a344755124fbc429f43a6970be00592a8ef2
2018-09-28 07:30:48 +00:00
zhufl
8fec696bfd api-ref: total/free_capacity should be with postfix _gb
https://developer.openstack.org/api-ref/block-storage/v3/index.html#list-all-back-end-storage-pools
free_capacity and total_capacity in "List all back-end storage pools"
should be free_capacity_gb and total_capacity_gb

Change-Id: Ic0690d12147fa63b903f3442eccde88c1d501711
2018-09-28 15:30:37 +08:00
zhufl
be156c2d0b api-ref: namespace in extensions is optional
https://developer.openstack.org/api-ref/block-storage/v2/index.html#list-api-extensions
namespace in the response of "List API extensions" should be optional.

Change-Id: Ie2351adcb8f1c30c791de7463e3bedb86200c357
2018-09-27 14:16:32 +08:00
Zuul
9d2f404bf7 Merge "Fix some inconsistencies in qos-specs api ref" 2018-09-26 03:11:43 +00:00
Zuul
bd2fe30ce4 Merge "Fix some inconsistencies in messages api ref" 2018-09-26 03:11:41 +00:00
Zuul
06f3e4e79e Merge "Fix api-ref title levels and index" 2018-09-26 01:54:35 +00:00
Zuul
c61f36be76 Merge "api-ref: add docs for os-migrate_volume API" 2018-09-26 00:58:53 +00:00
Matt Riedemann
3eda3fa7a4 api-ref: clarify volume_type param in volume create API
The volume_type parameter to the volume create API can be
either the volume type name or ID, the cinder-api will look
it up either way. This wasn't obvious from the API reference
and required digging into the code to figure it out. This change
simply clarifies the usage in the API reference.

Change-Id: Iae8c43374dee9767e17252279822ccd2121d8246
2018-09-24 11:13:05 -04:00
Matt Riedemann
b2276d693a api-ref: fix req/resp params for v3 os-quota-class-sets
The volume-type parameter in the update quota class sets
API reference was confusing. The volume_type is a namespace
on quota class values for snapshots, volumes and gigabytes.
The os-quota-sets API reference had this documented correctly,
so the os-quota-sets parameter values are re-used here for
os-quota-class-sets.

Change-Id: I6e8993f909834797572ec4b911bf709c3701fff1
Closes-Bug: #1794120
2018-09-24 11:08:24 -04:00
Matt Riedemann
00c5d946cd api-ref: mark name as optional in volume create API
The "name" parameter to the volume create API is optional,
this makes the docs reflect that. While in here, I've
renamed volume_name_1 to volume_name_optional so the variable
name is descriptive and dropped the redundant name_8 variable.

Change-Id: Ice42f06112a268b229f770f34096de19eb3447b2
Closes-Bug: #1794115
2018-09-24 10:41:34 -04:00
Zuul
6b13c7ebaf Merge "Update doc for get-pools API" 2018-09-21 13:58:34 +00:00
Zuul
d8dcd4097c Merge "Add microversion history to api-ref" 2018-09-20 17:33:26 +00:00
zhufl
c5d3396ca0 Fix some inconsistencies in qos-specs api ref
I433c78821185600a230803cddec54a5d264c2ca5 tries to add response
schema validation for qos-specs interfaces, and there are some
inconsistencies in api ref:
1. https://developer.openstack.org/api-ref/block-storage/v3/index.html#create-a-qos-specification
   Create a QoS specification has no response sample.
2. https://developer.openstack.org/api-ref/block-storage/v3/index.html#get-all-associations-for-a-qos-specification
   Get all associations for a QoS specification has incorrect response
   fields description and incorrect response sample.

Change-Id: Ib5c9b3a15ee2ca40c19e7a530d1ff5351d3dcaf8
2018-09-20 17:02:42 +08:00
zhufl
bf0a685c28 services api ref: fix field enum value and add missing field
I62072573624c9e579a61affed6a7f8d57a6fdb6d tries to add schema
validation for volume services, and there are some inconsistencies
in the api ref doc.

https://developer.openstack.org/api-ref/block-storage/v3/#list-all-cinder-services
1. As Response Example shows, status takes the value of enabled
   or disabled, not available/unavailable.
2. response may contain backend_state field which is optional.

Change-Id: I2435e3dc7c704de158b479d2ea543409b7686a07
2018-09-20 08:51:05 +08:00
whoami-rajat
e0baecf01f Adding variable for total gigabytes used by snapshot param
Refering to the host details API doc
https://developer.openstack.org/api-ref/block-storage/v3/index.html#show-host-details-for-a-project
snapshot_count and total_snapshot_gb are two different values,
but have been assigned the same variable as can be seen here,
https://github.com/openstack/cinder/blob/master/api-ref/source/v3/hosts.inc
This patch adds a new variable for total_snapshot_gb param.

Change-Id: I5727df835456bfa0ca63e253ddc700182b7cd85c
2018-09-19 19:07:48 +05:30
Sean McGinnis
027e5b23fd
Add microversion history to api-ref
This pulls in our microversion history document into the api-ref to make
it easier for api consumers to discover the history of API changes.

Change-Id: I9033a48e3f60199b60a904c8cf028f4a1e037ec3
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
2018-09-18 14:59:37 -05:00
zhufl
edcf82fd58 Fix some inconsistencies in messages api ref
I512bfc97a1c3d4a508daf580d99fefe2a9ae4e13 tries to add response
schema validation for messages interfaces, and there are some
inconsistencies in api ref:
1. delete message success code is 204, not 202
2. id is of the format uuid, which means string, not integer.

Change-Id: I13280bf158f541ed0514930274df8c03a0f81c4c
2018-09-18 14:23:00 +08:00
zhufl
4088690df1 Fix typos in volume api ref doc
This is to fix typos in volume api ref doc.

Change-Id: Ie861548a02ccdd6229edec682c3e4c2d6be084c7
2018-09-18 09:25:07 +08:00
Matt Riedemann
04ce5179bb api-ref: document no_snapshots default for volume transfer API
This documents the default value (False) for the no_snapshots
parameter to the 3.55 volume transfer API and also fixes the
no_snapshots value in the API sample to use proper json.

Change-Id: I852a04c0b772de64fa82c9c1630dff8ba6454eeb
2018-09-12 14:32:16 -04:00
Matt Riedemann
8f13d2e428 api-ref: add preconditions for volume transfer APIs
This adds the simple pre-conditions for the volume transfer
API (in its various forms) to the API reference. This came
up during discussions about nova server instance ownership
transfer and questioning whether or not in-use volumes could
be transferred and finding the API did not mention that case
at all.

Change-Id: I0bd42dd6a0e291979fb37bcab3823dfde369e7a9
2018-09-11 17:43:05 -04:00
TommyLike
a7dca2e783 Update doc for get-pools API
Update name description for get-pools
API's document.

Change-Id: I403c968e8b0a85d81dc8898153f18e418ca5d289
2018-08-29 09:38:23 +00:00
Matt Riedemann
76cc9bd02b api-ref: add docs for os-migrate_volume API
Adds the v2 and v3 API reference documentation for the
admin-only (by default) os-migrate_volume volume action
API. The only major difference with the v3 API is the
cluster parameter introduced in the 3.16 microversion.

Change-Id: I70f6b2cc4d25ea155ce09ddeec26b995890a2db3
Partial-Bug: #1607539
2018-08-22 20:38:22 -04:00
Sean McGinnis
9a8d738aa3 Add api-ref for mv 3.55 volume transfer
Adds the api-ref information for the the 3.55 version of the volume
transfer API.

Change-Id: Ib91c2f7018184821437da41bc0f7b0c0b2e69f0c
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
2018-08-17 14:53:07 +00:00
Sean McGinnis
ecaac074c0
Fix api-ref title levels and index
We had a few instances where the title level used for calls in the
api-ref was wrong, resulting in the api call being hidden inside the
details of another title level.

This fixes title levels to be consistent and adds a missing inclusion to
the v2 index.

Closes-bug: #1787203

Change-Id: I602250117dbf52f9e031e945040b45f089d8602e
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
2018-08-15 08:18:28 -05:00
TommyLike
99e925a82a Update document for metadata show API
Instead of "metadata", cinder will add "meta"
into response body of show metadata API.

Change-Id: Id39e3858f860e7f705d1c6ed44307d50fa8ff4b9
2018-08-13 21:56:57 +08:00
Jay S. Bryant
285fbc6447 Remove the CoprHD driver
The CoprHD driver was marked unsupported
in Rocky and the vendor has indicated that
the driver is deprecated.  Given the feedback
I am removing the driver.

Change-Id: I978315402edeb0c5dd6aee28315973fa502b0e20
2018-08-09 21:34:25 +00:00
Sean McGinnis
04560eaba2
Improve messages api-ref description
The description for the messages API was very terse. This adds some more
details to provide some description of what the API is used for.

Change-Id: If15400e9a538bf533e93f9693b6eddeb114fa7e5
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
2018-08-03 15:21:05 -05:00
Zuul
288d1fecb4 Merge "Update attachment create API document" 2018-07-23 18:56:30 +00:00
Zuul
4bb00dbcf6 Merge "Transfer snapshots with volumes" 2018-07-19 17:09:09 +00:00
wanghao
c0efaa1d46 Transfer snapshots with volumes
This feature changes Cinder to transfer
snapshots with volumes at the same time by default.
If user doesn't want to transfer snapshots, they could use
a new optional argument '--no-snapshots' after microversion 3.55.
And we also introduce the new V3 api 'v3/volume_transfers'
to move this API out of contrib into Cinder V3 API.

The cinderclient patch: https://review.openstack.org/#/c/577611/

Change-Id: If848d131e5edcdb77d0b3c2ca45a99c4d5e14d1e
Implements: blueprint transfer-snps-with-vols
2018-07-19 09:42:43 +08:00
TommyLike
6c9ec93a83 Update attachment create API document
Add 'mode' parameter to request body of
attachment create API.

Change-Id: I109e26837f107d2060f2c2f0ba9c94488e76b730
2018-07-19 01:21:43 +00:00
Neha Alhat
d98dbf4da8 Update api-ref and release notes for schema validation
This patch adds a reno for validate boolean parameters with spaces.
Also adds valid values in api-ref for boolean parameters that user
can pass in request body.

Implements: bp/json-schema-validation
Change-Id: Iff4b2906dba93a238d720a218fcf7a9f78b96a37
2018-07-17 15:05:54 +05:30
Zuul
688ff8157d Merge "api-ref: Update notes on encryption key size" 2018-07-16 04:15:27 +00:00
Eric Harney
4f3c5f1aff api-ref: Update notes on encryption key size
128 bit keys don't even work, and wouldn't be
recommended if they did.

Everyone should be using 256 bit keys.

Change-Id: I14c52b35abd55d0147b877b60af12c92130fa4a7
2018-07-12 15:33:39 -04:00
jeremy.zhang
999cd2be12 Fix parameter description in volume and snapshot manage extension
The parameters 'cinder_id', 'reason_not_safe', 'extra_info' can be None,
but are required in the response body of listing detail of managable
volumes or snapshots.

Change-Id: Iade148d2afeaae486aab4dc789d52e9522f206ee
2018-06-30 10:21:16 +08:00
Zuul
7959cd24d5 Merge "Add v3 api-ref for force delete snapshot" 2018-06-25 23:42:19 +00:00
Zuul
41178f1346 Merge "api-ref: Rephrase delete volume precondition" 2018-06-25 22:47:42 +00:00