245 Commits

Author SHA1 Message Date
pooja jadhav
7e693dd107 Discrepancy in api-ref and code for create group snapshot API
'group_id' is mentioned as an optional parameter in api-ref doc for
POST /v3/{project_id}/group_snapshots API but in the code if we don't
pass group-id it returns BadRequest.

This patch fixes this discrepancy by updating the api-ref according
to the code.

Closes-Bug: #1735177
Change-Id: Id2165a07995ab706d4a327f7340dccee7799c7b6
2017-11-30 09:10:52 +05:30
Zuul
7ffc39f071 Merge "Fix group_type_id in api-ref" 2017-11-29 20:18:52 +00:00
luqitao
39694623e4 Support create volume from backup
This patch implements the spec of creating volume from backup.

Change-Id: Icdc6c7606c43243a9e12d7a42df293b729f589e5
Partial-Implements: blueprint support-create-volume-from-backup
2017-11-28 09:16:59 +08:00
Zuul
1c105a47f3 Merge "Fix description for volume_type object in API Ref" 2017-11-22 02:30:50 +00:00
ghanshyam
176f9b17b9 Fix group_type_id in api-ref
group_type_id in GET/DELETE/PUT /group_types/group_type_id
is mentioned as optional path variable which is not true.

- 7c66eb3d97/cinder/api/v3/group_types.py (L101)

This id is mandatory and doc should be updated.
This create confusion while test case or using this API,
example - https://review.openstack.org/#/c/521634/4/tempest/lib/services/volume/v3/group_types_client.py
Closes-Bugs: # 1733504

Change-Id: I220cd20fefbe83ba8c392ab6b1679620d6a1d934
2017-11-21 16:45:07 +03:00
Zuul
25c63d6f3d Merge "api-ref: fix 203 error response codes to be 403" 2017-11-21 03:26:54 +00:00
Zuul
69f7f87a26 Merge "Update api-ref to include volume_image_metadata" 2017-11-21 02:04:04 +00:00
Zuul
0836484c5e Merge "Fix v3 api-ref for restoring backup are wrongly described" 2017-11-21 02:03:59 +00:00
Zuul
561b97a1b5 Merge "Add v3 api-ref for showing encryption specs item" 2017-11-20 22:13:16 +00:00
Xiaojun Liao
47b48b99c1 Fix v3 api-ref for restoring backup are wrongly described
In v3 api-ref for restoring backup, the request contents are wrongly
described, it is mandatory to specify either the UUID or name of the
volume, Actually it's OK if you specify nothing.

The name parameter will work only if a new volume is created for restore.

Closes-Bug:#1732664

Change-Id: Ia6a9b99df0c7b83999a2e5ac9c945c91b284f807
Signed-off-by: Xiaojun Liao <xiaojunliao85@gmail.com>
2017-11-20 13:49:56 +08:00
zeng jia
a3814c0a6e Fix qos-spec-v2-qos-specs error
There are some small mistakes in the api-v2 doc,
please see this bug description:1733148
Closes-Bug:#1733148

Change-Id: I3726159a23625a33415f23b971d6e6f47bd77846
2017-11-19 14:12:11 +08:00
jeremy.zhang
4f4a0256f7 Add v3 api-ref for showing encryption specs item
This patch adds v3 api-ref for showing encryption specs item for an
existing volume type.

Change-Id: I80b1853cbe2cc02a056195e967e9422617bbf850
2017-11-18 16:32:01 +08:00
Chris Friesen
8cb4aedda6 Update api-ref to include volume_image_metadata
The detailed information for a volume can include "volume_image_metadata"
in the case where the volume was created from an image, or in the case
where the volume was created from a snapshot of such a volume.

Update the API ref to include the field so we accurately represent
the code.

Change-Id: If5fcdefaa10bfb00e60aa4559d3282d3c6a53752
Closes-Bug: #1732763
2017-11-17 21:24:44 +00:00
Matt Riedemann
0b1db32ec4 api-ref: fix 203 error response codes to be 403
I assume these were just typos, because 203 isn't an error response,
and for these APIs about the only error response you can get, besides
401 I guess, is a 403 for policy forbidding the user from making that
request. So this changes the various 203 to 403 error codes in the
API reference.

Change-Id: I377b4c11d04c84b00165aae00990c93c5d52e668
2017-11-15 10:25:47 -05:00
jeremy.zhang
ab9a8a2a6e Fix api-ref for group snapshots API
This patch mainly fixes the response parameters and examples for
the show/list/create group snapshots APIs.

Change-Id: If160ffdd7301337eac9353faffb72a9f069882c4
2017-10-31 15:25:22 +08:00
TommyLike
23b7463984 Support count info in List&Detail APIs
This patch adds support for display count info
in volume, backup and snapshot's list&detail APIs
since microversion 3.45, for instance:

1. /v3/{project_id}/volumes?with_count=True
2. /v3/{project_id}/volumes/detail?with_count=True

Depends-On: 1c8fe0ade43da925c5b810ef0cd27817f1c11c7b
Change-Id: I2e92b27c36357120fcf0ec5917c6484441c946a8
Implements: bp add-amount-info-in-list-api
2017-10-25 08:43:47 +00:00
Zuul
6fcae393c7 Merge "Replace http with https for doc links in cinder" 2017-10-23 05:23:59 +00:00
Zuul
90b3674f1c Merge "Api-ref: Add missing api response for volume transfer" 2017-10-18 21:50:35 +00:00
jeremy.zhang
dafdd7411b Add v3 api-ref for updating specific extra specs for a volume type
This patch adds v3 api-ref for the following volume type API:
Update specific extra specs assigned to a volume type.

Change-Id: Ib8622870d53cbdc249aa465ce62ed45dea2b4089
2017-10-17 17:46:39 +08:00
zhangbailin
234a0784bf Replace http with https for doc links in cinder
1) Update doc links according to OpenStack document migration
2) Use https instead of http for docs links
For example:
(1)http://docs.openstack.org/admin-guide/blockstorage_nfs_backend.html
->https://docs.openstack.org/cinder/latest/admin/blockstorage-nfs-backend.html
(2)http://docs.openstack.org/oslo.i18n/latest/user/index.html
->https://docs.openstack.org/oslo.i18n/latest/user/index.html
(3)http://docs.openstack.org/ --> https://docs.openstack.org/
(4)http://docs.openstack.org/admin-guide/blockstorage_multi_backend.html
->https://docs.openstack.org/cinder/latest/admin/blockstorage-multi-backend.html

Change-Id: I7fcdc4453cb3bad713c7d770012411701cca742b
Closes-Bug:#1710054
2017-10-17 11:14:01 +08:00
junboli
af340d0f05 Api-ref: Add missing api response for volume transfer
The volume transfer accept and create API missed the api response,
this change is to add them for both V2 and V3.

Closes-bug: #1723867
Change-Id: I4f8005633ed1eb53ab08b3493cdc97d44103dafa
2017-10-16 14:41:46 +08:00
jeremy.zhang
1a8c229bf6 Add v3 api-ref for showing all/specific extra specs for a volume type
This patch adds v3 api-ref for two APIs:
1. Show all extra specs assigned to a volume type
2. Show specific extra specs assigned to a volume type

Change-Id: Id5771ee7e52748374ae6a3167116589273000297
2017-10-13 23:18:21 +08:00
Jenkins
6ddb053944 Merge "Add documentation for API 'validate_setup_for_nested_quota_use'" 2017-10-11 14:40:10 +00:00
TommyLike
f70288d3e4 Add documentation for API 'validate_setup_for_nested_quota_use'
Documentation for API 'validate_setup_for_nested_quota_use' is
missing. Fix it.

Change-Id: Ica3d468856bad045c2bdd30a0f86924cc0aeb572
2017-10-11 16:04:36 +08:00
jeremy.zhang
ef0f65ce75 Add v3 api-ref for deleting extra spec for a volume type
This patch adds v3 api-ref for the API: delete a specific extra spec
for a volume type.

Change-Id: I9b0c1527247aaebe7dc1acc71a376cb41108ee69
2017-10-10 10:54:05 +08:00
Jenkins
cd9e03d440 Merge "Fix v3 api-ref for updating extra specs of volume type" 2017-10-08 16:18:29 +00:00
Jenkins
aeb8619935 Merge "Update provider parameter in sample json files" 2017-10-05 05:11:31 +00:00
Chiawei Xie
68c668cfc8 Fix Reset a snapshot's status API Request Example
Reset a snapshot's status API Request Example was syntax error with comma, so
remove comma to syntax correct.

Change-Id: I8b2c249aaf0f9729bc35b80ecd6cd28bb34835c0
Close-bug: #1720487
2017-09-30 14:07:48 +00:00
ghanshyam
cd6431b107 Fix description for volume_type object in API Ref
Volume_type is a object containing all information
about volume_type but its definition is wrong on
API-ref side
- http://developer.openstack.org/api-ref/block-storage/v2/#volume-types-types

This commit correct that to understand the API clearly.

Change-Id: I3384ad2f01917d71b3dfab46ef21d7e5c44cc904
Closes-bug: 1659443
2017-09-29 00:45:03 +00:00
jeremy.zhang
3e06a7339e Fix v3 api-ref for updating extra specs of volume type
In v3 api-ref for updating extra specs of volume type, the request and
response contents are wrongly described, and also the HTTP method and
URL are not correct. This patch addes new api-ref for it.

Change-Id: I4263c25a0638a68d0d102c7966ebb77604c019fc
2017-09-28 12:45:45 +00:00
Jenkins
da323cc14f Merge "Clean up api-ref index page" 2017-09-27 23:53:31 +00:00
Jenkins
201fc1e049 Merge "Api-ref: change 'tenant' to 'project' in v2 doc" 2017-09-27 22:58:49 +00:00
Sean McGinnis
81fbc19ea7 Clean up api-ref index page
We had an extra section that had a useless index link and a link
to the search page. To make search easier to find, moved that up
to the top and got rid of the index link.

Change-Id: I65d7a8930b7bb7db2f994fc615ff621956397e83
2017-09-27 15:22:44 -05:00
Kaitlin Farr
ddeb1d14c4 Update provider parameter in sample json files
In the sample json files, some examples of the provider value were
wrong and showed a key manager class instead of an encryptor name.
Other samples showed the legacy encryptor classes where the newer
os-brick encryptor shorthand names should be used instead.
I3eec91e221692177833909e0378116cea4966807 removes support for the
legacy provider class names, so it is important that the samples
reflect the updated shorthand names.

Change-Id: I1c3879a5d12a8c9802deeac1c6e24b57310588d5
2017-09-27 14:24:13 -04:00
ghanshyam
ea3603c245 Fix api-ref for reset group snapshot
reset-group-snalshot api-ref not correct for 'status' attribute.
That is mentioned as optional for request.
'status' in API request is mandatory attribute.

Also 'project_id' is mentioned as body element instead of path.

Those are confusing while implementing tests for this API
 - https://review.openstack.org/#/c/495735/
https://developer.openstack.org/api-ref/block-storage/v3/#reset-group-snapshot-status
Closes-Bug: #1719930

Change-Id: Id2016f86d0eae60d96df7a12eda1bbec9d1129a8
2017-09-27 15:10:37 +00:00
lihaijing
4403ed17ca Api-ref: change 'tenant' to 'project' in v2 doc
Since 'tenant' is the old term, all things should now refer to 'project'.

Change-Id: I3a255df758583a3c4301041c8ebffb90b8263fef
2017-09-27 18:14:25 +08:00
lihaijing
baf811f20d Api-ref: fix v2/v3 hosts extension api doc
Supplement error response codes and fix parameters problem.

Change-Id: Ia24c6980f437ab6838d64c345bc9c10a100762e1
Closes-Bug: #1715286
2017-09-26 10:33:07 +08:00
Jenkins
f32483c6e4 Merge "api-ref: Clarify os-host GET behavior" 2017-09-19 08:16:55 +00:00
Jenkins
2963fa0771 Merge "api-ref: Normalize response codes" 2017-09-19 02:59:03 +00:00
Jenkins
abada2cc17 Merge "Add missing snapshot action in index.rst" 2017-09-13 22:09:46 +00:00
junboli
c5c4be704f Add missing snapshot action in index.rst
In the file api-ref/source/v3/index.rst, it missed include
volumes-v3-snapshots-actions.inc, This change is to add it
and fix doc format error.

Change-Id: Ib6dc549f8bc8da5dfd64d0e390cd70b27cd63177
2017-09-13 02:37:56 +00:00
Jenkins
bb2bc2b450 Merge "[Api-ref]: Add missing key/values in the json files." 2017-09-12 22:38:24 +00:00
Matt Riedemann
77e42e2f39 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.

Change-Id: Ia22ddbcd86ecd12d74f365ec3c72d0635ff3566c
Partial-Bug: #1716705
2017-09-12 12:51:55 -04:00
Jenkins
4d5f502e84 Merge "Remove API v1" 2017-09-07 22:42:59 +00:00
Sean McGinnis
3e91de956e Remove API v1
The v1 API has been deprecated for many releases now. We have not
been able to remove it due to SDKs and tooling being slow to
update. This is the latest attempt to see if it has been long
enough.

Change-Id: I03bf2db5bd7e2fdfb4f6032758ccaf2b348a82ba
2017-09-06 07:39:10 -05:00
junboli
4a008914b5 [Api-ref]: Add missing key/values in the json files.
In api-ref/source/v3/samples, some of JSON file contents does not
match the current v3 input or output, This patch is to update the
Request and Response JSON contents.

Change-Id: Ib6f0fcb9dc476f77b20cd780cfc6e8e1e425f4e1
2017-09-05 14:17:12 +00:00
Jenkins
914f5bde72 Merge "Remove duplicate variables in v3." 2017-09-04 12:29:52 +00:00
Sean McGinnis
117f614428 api-ref: Normalize response codes
We had a mix of formatting for our API response codes. This
makes it so all have a leading space, no trailing comma, and
no empty Error response labels.

This also addresses a formatting issue with due to the spacing
between the Normal and Error lines that was causing the two to
run together in the formatted HTML, making it harder to read.

Change-Id: Ic411ee9f671c48ce60bda21984dafe55135685ba
2017-09-03 18:17:13 -05:00
Sean McGinnis
8db0e33a3a api-ref: Remove unused parameter defs
During the initial migration of the api-ref docs, there were
several parameter definitions pulled over that are not actually
used anywhere in the docs.

It may be that some of these _should_ be referenced, but at
least as of right now they are not. Rather than carrying them
around on the chance that they could be used down the road, we
should just clean them out for now.

Change-Id: Ic9018608b00705c80df05243647f5c81124610df
2017-09-03 11:22:55 -05:00
Sean McGinnis
fffdac20c2 api-ref: Make v3 enclosing objects consistent
Some request details provided information about the other
JSON value while others didn't. To make things consistent
and to make sure API consumers understand how the requests
need to be structured, this adds missing instances. It also
reorders some parameter lists to be a little more logical,
so even though we can't show the nested nature of some of
these, it at least doesn't show inner values before outer
ones.

This also corrects many errors seen while going through
the API ref. This is by no means exhaustive, and is already
somewhat out of the scope for this patch, so it is expected
that there are some (many) cases that are not addressed by
this patch. Those will be fixed with ongoing effort in
future patches.

Partial-bug: #1713517
Change-Id: I30964ba8d829778fd01174d639d44ba07e4b77a6
2017-09-01 09:54:34 -05:00