123 Commits

Author SHA1 Message Date
Jenkins
8eeee1f580 Merge "Api-ref: Add doc for update backup" 2017-06-14 23:51:08 +00:00
jeremy.zhang
2d8d09f097 Fix response code for update and delete API in volume attachments
The normal response code for update or delete API described in volume
attachments api-ref is 202, but the actual response code from the curl
request is 200. This patch is to fix the response codes of these two
APIs in api-ref.

Change-Id: I6eb43f63bb504cb64b12f55de759779058b2979d
2017-06-13 23:03:14 +08:00
wangxiyuan
a71b838aad Api-ref: Add doc for update backup
Cinder added updating backup support in V3.9.

This patch added related api-ref.

Change-Id: I537cb609240e3bcfa130a116e1912d1b660a21f8
Closes-bug: #1607388
2017-06-07 02:07:30 +00:00
luqitao
e9acdab687 [api-ref]Adds API documentation for 'os-set_bootable' action
There is no document about update a volume's bootable status,
so add the missing doc.

Change-Id: If706205678cfd7a803e2d7733bec34494b47fc66
Partial-Bug: #1607539
2017-06-04 07:44:47 -04:00
Vu Cong Tuan
7404ba21b8 Trivial fix typos
Change-Id: Icd38d004eb89f1902365d71d64aa34a65eee9d37
2017-06-01 09:25:28 +07:00
Jenkins
3c1e569beb Merge "Fix api-ref for POST backup for optional name" 2017-05-31 12:30:59 +00:00
Jenkins
ae28bdb395 Merge "Add the missing "vol_type_id" param for qos association api-ref" 2017-05-30 17:24:45 +00:00
Jenkins
cb67f4f177 Merge "Make "connector" param to be optional in force-detach api" 2017-05-28 22:53:54 +00:00
ghanshyam
b817ad2225 Fix api-ref for POST backup for optional name
name attribute in create backup request is optional but
api-ref does not say so.
- https://developer.openstack.org/api-ref/block-storage/v3/index.html?expanded=create-a-backup-detail#backups-backups

Change-Id: I9ac456382ac8d3a27256762e3a56bd784abda201
Closes-Bug: #1678005
2017-05-28 16:43:33 -05:00
Jenkins
c83a9bbb97 Merge "api-ref: add list manageable resource API" 2017-05-28 21:18:48 +00:00
luqitao
b7f85fe0c9 Add the missing "vol_type_id" param for qos association api-ref
According to the code [1], "vol_type_id" is a required param,
so do "project_id/tenant_id" and "qos_id", they aren't optional params.

[1] https://github.com/openstack/cinder/blob/master/cinder/api/contrib/qos_specs_manage.py#L261:L269

Change-Id: I7727a9b675080bb92d2e42e293868a1e4eb92e10
2017-05-27 00:53:38 -04:00
luqitao
00edd490c6 Make "connector" param to be optional in force-detach api
One of the purposes of force-detach is to help the admin clean up
if things are in a bad state, so there might not be a connector to
pass in. This is the case if Cinder thinks the volume is attached
but the Nova instance has already been deleted.

Change-Id: I417ed7b100dfe8402599028597511949e00725ac
Closes-Bug: #1619647
2017-05-26 01:30:28 -04:00
Andrey Volkov
8235e6e1e2 api-ref cleanup: required flag for tenants
Current url scheme doesn't allow to skip admin_tenant_id
or tenant_id params. This change marks them as required
in api-ref. Get default quotas for a project signature
was changed on correct also.

Partial-Bug: #1415214

Change-Id: I0c528d1c49346477b608a12f8f35ee6d47404bd3
2017-05-23 14:48:48 +00:00
wangxiyuan
95115ae7ab api-ref: add list manageable resource API
This patch did:
1. Add list manageable volumes API doc.
2. Add create and list manageable snapshots API doc.

Change-Id: Iccffb69b0ffb220f43258ee4c47d5d8964ae7836
Closes-bug: #1590977
2017-05-23 09:51:28 +08:00
Jenkins
07857fb572 Merge "api-ref cleanup: remove quotas user related calls" 2017-05-23 00:07:34 +00:00
Jenkins
284fe17f6c Merge "Add the missing parameters in the api-ref of ext-backups.inc" 2017-05-22 17:21:04 +00:00
Jenkins
e4bf29c88f Merge "Fix incorrect volume_id request description in api-ref" 2017-05-22 16:22:39 +00:00
liuyamin
551c2963a0 Add the missing parameters in the api-ref of ext-backups.inc
Add "snapshot_id" and "data_timestamp" and "volume_name" to
the response parameters and error response code in the api-ref of
ext-backups.inc.

Change-Id: I2e3a6c737a74816e5e56b5a435a73e0bf501bec8
Closes-bug: #1676693
2017-05-22 14:01:27 +08:00
TommyLike
8fcb809509 Add 'resource_filters' API to support generalized filtering
This patch adds ``resource_filters`` API to retrieve
configured resource filters.

APIImpact

Partial: blueprint generalized-filtering-for-cinder-list-resource
Depends-On: ff3d41b15abb2915de87830980147be51e5da971

Change-Id: I387268b277c46c72624a3d3b5eabf03724a7a847
2017-05-20 10:33:21 +08:00
liuyamin
238a16a8a6 Add API documentation for force-delete volume in v2 and v3.
There is no API doc found for force-delete volume in cinder.
We need to add the API doc for the operation with its description,
request and response parameters.

Change-Id: Id25b4070a3946d2d7d89f44bdc81039286a5d8fe
Closes-bug: #1673644
2017-05-19 15:52:17 +08:00
wanghao
0b675b0438 Add missing retype API documentation
Now retype is missing in v2/v3 API documentation.
Add it in doc.

Change-Id: I2ba0d7b993a5b3e21c396ed3d0862808e0daf0b3
Closes-Bug: #1603293
2017-05-18 11:47:20 +08:00
wanghao
7e17004018 Fix incorrect volume_id request description in api-ref
Now some API documents for volume actions like
extending volume(https://developer.openstack.org/api-ref/
block-storage/v3/?expanded=extend-a-volume-size-detail) are
using incorrect request argument description
'volume_id in body'.

It should be 'in path'.

Change-Id: I2006b4af4dfc09fb0403c1a78ecef4ac920a51c4
Closes-Bug: #1691358
2017-05-17 14:41:51 +08:00
TommyLike
5c90bd64fe Add documentation for invalid filter keys
Now cinder will raise 400 if invalid filter
keys are specified, Update the corresponding
list APIs.

DocImpact
Depends-On: ff3d41b15abb2915de87830980147be51e5da971

Change-Id: I8419b374d7f743e7e9fc88e31c8c4f7d9470059b
2017-05-17 09:11:27 +08:00
Jenkins
5faa626f80 Merge "[api-ref] Add cascade to volume delete" 2017-05-11 19:12:24 +00:00
Matt Riedemann
e13256469d Re-arrange v3 API reference
This applies an order to the v3 API reference documents.

The idea being how does a new user come into and use the API
and what APIs should they see first when getting started.
Naturally they need to know about versions and microversions
that are avaible. Then they might need to know about volume
types before creating a volume. Once they create a volume
and know the basics of working with volumes, they can start
to take some actions on volumes. After that it's just kind
of a random free for all of APIs and the only order applied
to the rest is sorting alphabetically by title.

Change-Id: I8956de3e6907582f7115430eb959813a13e87a49
2017-05-03 09:32:06 -05:00
Matt Riedemann
ad56443ecb Re-order api-ref home page index
Since the v2 API is deprecated, put it in the index after
the v3 API which is current, since as a user the first thing
I want to see is the currently supported API reference, not
the deprecated stuff I shouldn't be using anyway.

Change-Id: I760533ca693cb8f678a6031e07789cd68f11bc47
2017-05-03 09:28:50 -05:00
Jenkins
ae1df67883 Merge "Add attachment API doc" 2017-05-03 00:31:04 +00:00
Amy Marrich (spotz)
e0e201c9a9 Volume Type Encryption added to v2 api-ref
Added volume type encryption sections to volumes v2 types and
added related parameters to parameters file.

Appropriate sample files added.

Had to add for v2 to several headings to pass tox/gates

Change-Id: I7a35551c4ebd345ce2d6c42217015b29c324d96c
Closes-Bug: #1679736
2017-04-26 08:20:05 -05:00
TommyLike
5c19a66950 Add attachment API doc
Add attachment API related Docs, please note we
use 'instance_uuid' in the request and 'instance' in
the response to represent the same thing 'server_id'.

DocImpact

Change-Id: I8bd5a9061af2b47fd227e8cf2f48f80f271bde14
2017-04-21 10:30:41 +08:00
Jenkins
22777e559e Merge "api-ref: fix rest method error in reset group and group-snapshot status." 2017-04-13 20:14:22 +00:00
Jenkins
6ce8d6f32f Merge "Missing volume status on block storage v2 API" 2017-04-11 05:32:43 +00:00
Jenkins
e2e2edddf0 Merge "Delete the duplicate interface about the api version" 2017-04-11 04:26:06 +00:00
Jenkins
0842264377 Merge "Adds API documentation for list and show hosts." 2017-04-11 04:16:03 +00:00
Jenkins
bb9692cb2c Merge "Add missing and incorrect response and error codes in cinder api-ref" 2017-04-11 04:15:55 +00:00
nidhimittalhada
1146617992 Missing volume status on block storage v2 API
Added missing volume states in api docs.

Change-Id: I5789053938d5bae3291cb139a075dc5adf9c2f40
Closes-Bug: #1665276
2017-04-07 16:11:19 +05:30
Jenkins
641864b662 Merge "Add two response parameters in the api-ref of getting capabilities" 2017-04-01 03:36:20 +00:00
wangxiyuan
969d080c07 [api-ref] Add cascade to volume delete
Delete volume with cascade is supported by Cinder from V2.

cascade is missing in api-ref.

Change-Id: I66b4bb345aba5a6b4165f971556b858e4c0e258c
Closes-bug: #1677456
2017-03-31 15:35:15 +08:00
Jenkins
04ad974984 Merge "Remove XML description from media-types" 2017-03-30 19:16:20 +00:00
wangxiyuan
4339f17ac5 [api-ref] Update snapshot/volume's metadata api-ref
Volume/Snapshot contains two kinds API for it's metadata: POST/PUT

POST is used for creatng or replacing the volume/snapshot's
metadata items that match keys. It doesn't modify items that
are not in the request.

PUT is used for replacing all the volume/snapshot's metadata
with the key-value pairs in the request.

Cinder's api-ref description is wrong. This patch fixed the
description and added the missing POST/PUT request.

Change-Id: I51128d32c9f70ba57d7d4cf0634a16ca566db95f
2017-03-27 14:33:05 +08:00
lihaijing
e3288824c1 api-ref: fix rest method error in reset group and group-snapshot status.
In Block Storage API V3, reset group and group-snapshot status
actually use 'POST' method not 'PUT' mothod.

Change-Id: I1eb1f5576bfb0dc4c68e0067f8fa0453f1d3b9db
Closes-bug: #1676252
2017-03-27 11:19:58 +08:00
yfzhao
88aa1bcabb Add two response parameters in the api-ref of getting capabilities
Add "display_name" and "replication_targets" to the response parameters
in the api-ref of getting capabilities.

Change-Id: Id1776641ea9938d024906707fec2e21404668ff7
Closes-bug: #1674237
2017-03-25 12:25:07 +08:00
Jenkins
3f8466b712 Merge "Fix version numbers on media-types" 2017-03-24 19:55:30 +00:00
Jenkins
748b218ec5 Merge "api-ref: Fix volume_id parameter for the path" 2017-03-24 16:12:29 +00:00
Jenkins
42402ebbf4 Merge "Fix 500 error when 'mountpoint' is not provided to os-attach" 2017-03-24 16:12:12 +00:00
Matt Riedemann
b3400efd96 api-ref: Fix volume_id parameter for the path
When the volume_id is in the path for an API, it is
required. This fixes the volume_id_1 parameter for the
path argument by making it required and also renaming
it to be more clear of what it's used for. And finally,
this fixes the os-attach parameter to indicate volume_id
is in the path and is required, not optional.

Change-Id: I0e8868d35b5ea06ef809c896f943d92ad8e71e3e
2017-03-23 13:02:52 -04:00
Matt Riedemann
6b04a764cb Fix 500 error when 'mountpoint' is not provided to os-attach
This fixes the 500 resulting from the KeyError when mountpoint
is not provided during an os-attach call. It also fixes the
API reference docs to no longer lie about mountpoint being
an optional parameter.

Change-Id: Ica9ccb0246bc84c087afc338b5102ce48f57e82b
Closes-Bug: #1575675
2017-03-23 12:49:30 -04:00
Jenkins
ce32522d3a Merge "[Doc] Add documentation for messages API." 2017-03-23 15:19:05 +00:00
TommyLike
5545524142 [Doc] Add documentation for messages API.
Add documentation in v3 for messages API.

Change-Id: I6f9886c98eec4bb33fa1b4ad5b51a35a36762bfe
2017-03-23 20:22:49 +08:00
liuyamin
3f2539fa4f Delete the duplicate interface about the api version
In the document of cinder api,there are duplicate interface in the
api-versions.inc and volumes-v2/v3-versions.inc about listng all
api versions(rest_method:: GET /).So remove the interface in
volumes-v2/v3-versions.inc

Closes-Bug: #1674278
Change-Id: I34da088161771ec8e518a02235c7f78988a311f5
2017-03-23 14:24:57 +08:00
Jenkins
d1b5a11325 Merge "Fix status_code of "list versions" API" 2017-03-23 00:57:56 +00:00