Commit Graph

237 Commits

Author SHA1 Message Date
Jenkins 7f5dd33a70 Merge "Complete verification of servers-action-fixed-ip.inc" 2017-03-28 10:58:37 +00:00
Jenkins 93aee8203a Merge "api-ref: Complete all the verifications of remote consoles" 2017-03-27 13:29:49 +00:00
He Jie Xu 54af57f485 api-ref: Complete all the verifications of remote consoles
This patch includes all the verifications of remote consoles

part of blueprint api-ref-in-rst-pike

Co-Authored-By: Markus Zoeller <mzoeller@linux.vnet.ibm.com>
Change-Id: Ib169e4bd931b5a04f31cd0e7c43c161b49eafe5c
2017-03-23 10:51:13 +08:00
Jenkins b672f35de6 Merge "Add description for Image location in snapshot" 2017-03-17 19:30:48 +00:00
Jenkins b5e9198c99 Merge "api-ref: Fix parameters and examples in aggregate API" 2017-03-17 17:35:13 +00:00
Jenkins 2b3ce2a028 Merge "Improve descriptions for hostId, host, and hypervisor_hostname" 2017-03-17 16:52:39 +00:00
Jenkins 6dc60505f9 Merge "Add api-ref for filter/sort whitelist" 2017-03-17 16:13:44 +00:00
melanie witt 261e7e3c5e Improve descriptions for hostId, host, and hypervisor_hostname
The current descriptions for hostId, host, and hypervisor_hostname are
vague, so this adds more detail to make them more understandable.

Closes-Bug: #1673593

Change-Id: Id3ea9bbfe59a47b24e3584cf16b5a556007e58ea
2017-03-17 11:04:15 -04:00
Kevin_Zheng e06cb39121 Add api-ref for filter/sort whitelist
Add api-ref doc for the filter/sort whitelist,
showing what can be used to filter and
sort results when calling list server API.

Co-Authored-By: ghanshyam <ghanshyammann@gmail.com>
Change-Id: I821085f885f207408e56f73ccbf0956dc017ba78
2017-03-17 06:56:47 +00:00
jichenjc 72081ded4d Add description for Image location in snapshot
snapshot action nova will return image URL in response header
better to provide this info to end user for their reference.

Also, the backup header description is changed as well.

Change-Id: I15cf228b4a5a2d0dbae5fa76ec6821487e7808ed
Closes-Bug: 1657998
2017-03-13 19:09:08 +08:00
Takashi NATSUME 48f6f0148d api-ref: Fix parameters and examples in aggregate API
- The type of aggegate ID is changed to 'integer' instead of 'string'.
- The uuid of aggegate is changed to 'required'
  because the uuid is always shown in the response after v2.41.
- The response examples are replaced with v2.41 examples.

Change-Id: Ib106898d32dc67e414f489468e91561ab0a5eb80
Closes-Bug: #1659475
2017-03-13 04:04:39 +00:00
Jenkins 330590d0aa Merge "remove a TODO as all set for tags" 2017-03-10 22:51:34 +00:00
Takashi NATSUME 2800b53836 api-ref: Fix keypair API parameters
Fix parameter types and the order of parameters.
Add missing parameters.
Add a period at the end of a parameter description.
Replace sample files with v2.10 files.

Change-Id: I9d8d20b42c7d32e11af479e79c9c9e8475421302
Closes-Bug: #1656781
2017-03-10 15:58:06 +09:00
Andreas Jaeger 7ad3807500 Fix api-ref with Sphinx 1.5
Sphinx 1.5 is more picky about highlighting and currently building of
api-ref fails with:

Warning, treated as error:
/home/aj/Software/vcs/OpenStack/openstack/nova/api-ref/source/index.rst:4:
WARNING: Could not lex literal_block as "json". Highlighting skipped.

Fix problems found:
Remove duplicate "progress: 0" from
os-rescue/server-get-resp-unrescue.json,
os-server-tags/v2.26/servers-tags-details-resp.json,
os-server-tags/v2.26/server-tags-show-details-resp.json.

Change json to javascript for highlighting of delete_info.

Change-Id: I7cd969fb4c9d4bff995c34725cfb739cccaba12c
2017-03-03 11:58:50 +01:00
stewie925 5c574cf31c Complete verification of servers-action-fixed-ip.inc
This includes the parameter, body, and example verifications for
api-ref servers-action-fixed-ip.

part of bp:api-ref-in-rst-pike

Change-Id: I2b9971d7ff3716f330b55020bf37489dbc9e9b2c
2017-02-28 09:28:59 -08:00
jichenjc 70dd9660f5 remove a TODO as all set for tags
tags already documented in api-ref and we already had all
server queries there, so no additional steps for it

part of bp:api-ref-in-rst-pike

Change-Id: I726171f256a3404801a7f9b8109d46bf5b7c62cf
2017-02-25 22:06:56 +08:00
Jenkins 4d33ec2954 Merge "api-ref: cleanup os-server-groups 'policies' parameter description" 2017-02-23 22:49:30 +00:00
Jenkins 92c03b45a5 Merge "api-ref: fix instance action 'message' description" 2017-02-23 12:43:13 +00:00
Jenkins 3caffeda7e Merge "api-ref: note that boot ignores bdm:device_name" 2017-02-16 23:29:54 +00:00
Jenkins 658bd1699c Merge "api-ref: Fix deprecated proxy API parameters" 2017-02-16 04:44:46 +00:00
Jenkins bdeb05dfb0 Merge "api-ref: Fix network_label parameter type" 2017-02-15 02:02:58 +00:00
Takashi NATSUME 1091915804 api-ref: Fix deprecated proxy API parameters
All the network proxy APIs were deprecated in Newton.
The related quotas have been filtered out in quotas APIs
since I7311ad726f5ca50f5648a539b03c00e712235834.
And they have also been filtered out in limits API
since I00bad055847adbbe26fe2f9225a4adde18f546b8.

But the API reference has not been updated yet.
So fix it.

Change-Id: Ie06585ab572cf6278a580bd3fdb1e86cbd0bcb7a
Closes-Bug: #1654167
2017-02-14 23:41:46 +00:00
Balazs Gibizer 7486398220 api-ref: note that boot ignores bdm:device_name
The volume_attach case was documented properly but the nova boot
case missed the note after I76a7cfd995db6c04f7af48ff8c9acdd55750ed76
was merged.

Change-Id: I1aa0518e60e349ad625ac366f7748ba35806c829
Closes-Bug: #1664509
2017-02-14 21:29:54 +00:00
Takashi NATSUME 92e4f6cff9 api-ref: Fix network_label parameter type
Change-Id: Ia20e97927cddac8be94d58996122fc7ca43c2c0f
Closes-Bug: #1662146
2017-02-13 07:47:58 +00:00
Matt Riedemann a72968a9e0 api-ref: fix instance action 'message' description
There was a typo in the description of this parameter
and it also didn't read very clearly, so I've just
re-written the description of this.

On a side note, it's a bit odd that this is a required
parameter in the response (Tempest requires it in the
response schema) even though it's only set if the
action failed.

Change-Id: Ic84031119e2ffb6b1fb0b0a193967b2823464651
2017-02-11 16:57:00 -05:00
Matt Riedemann f7d9e82a20 api-ref: mark id as optional in POST /flavors
When creating a flavor you do not actually have to
provide an id. If one is not provided in the request,
an id is automatically generated from a uuid when
creating the flavor. This updates the api-ref to
point that out.

Change-Id: Ie3c7042bd5f1ae05ad4e4eeba078f82c5e23d33a
Closes-Bug: #1663389
2017-02-09 16:32:24 -05:00
Jenkins 312efe4563 Merge "api-ref: document the 'tenant_id' query parameter" 2017-02-09 14:18:10 +00:00
Jordan Pittier acfad7cf6f api-ref: document the 'tenant_id' query parameter
When listing servers, it's possible to filter servers based on
the tenant_id. This patch documents this.

Change-Id: I8432aa922cb61ef052cd1f7436546e69d7b6aceb
2017-02-07 16:02:47 +01:00
Artom Lifshitz e80e2511cf Fix tag attribute disappearing in 2.33 and 2.37
In the context of device tagging, bugs have caused the tag attribute
to disappear starting with version 2.33 for block_devices and starting
with version 2.37 for network interfaces. In other words, block
devices could only be tagged in 2.32 and network interfaces between
2.32 and 2.36 inclusively.

This patch documents this behaviour in api-ref and introduces
microversion 2.42, which re-adds the tag in all the right places.

Change-Id: Ia0869dc6f7f5bd347ccbd0930d1d668d37695a22
Closes-bug: 1658571
Implements: blueprint fix-tag-attribute-disappearing
2017-01-30 19:38:46 -05:00
Takashi NATSUME 070656a478 api-ref: Fix path parameters in os-hypervisors.inc
The hypervisor ID in path parameters have been fixed to 'integer'.
In "Search Hypervisor" and "List Hypervisor Servers",
the hypervisor IDs have been fixed to a string for searching
hypervisor host names.

Change-Id: I2260f0c4ca82d5a2ae5a46bcf8f48f9eaaf09f2f
Closes-Bug: #1654197
2017-01-26 23:40:12 +00:00
Jenkins e1b90214c2 Merge "api-ref: Fix parameters whose values are 'null'" 2017-01-19 00:05:24 +00:00
Takashi NATSUME 7c66d4184b api-ref: Fix a parameter in os-availability-zone.inc
In "Get Availability Zone Information",
the 'hosts' response parameter is always 'null'.
So fix the description.

Change-Id: I23bd8b3a422aa03c3f56d7f2f10f6603acd0078a
Closes-Bug: #1654427
2017-01-18 10:02:18 +00:00
Takashi NATSUME 8892be066a api-ref: Fix parameters whose values are 'null'
Replace 'string' type with 'none' type in parameters
whose values are 'null'.

http://lists.openstack.org/pipermail/openstack-dev/2017-January/110009.html

TrivialFix
Change-Id: I4ebcc4db362eaf18560c9d6a6f8c11ecbead4c16
2017-01-16 17:19:51 +09:00
Takashi NATSUME 69f27a7ced api-ref: Fix parameters and response in os-quota-sets.inc
The type of 'quota_set' is changed to 'object'.
Add a missing response description of DELETE method.

Change-Id: I0a51861c68866303734a1d161b85689e1a3ba636
Closes-Bug: #1653897
2017-01-16 00:12:20 +00:00
Jenkins 9b918199d8 Merge "Return uuid attribute for aggregates" 2017-01-07 05:12:18 +00:00
Jenkins f98006f8a4 Merge "correct misleading wording" 2017-01-06 17:48:23 +00:00
jichenjc e4ae7e91dc correct misleading wording
this schema tells us host is required
https://github.com/openstack/nova/blob/master/nova/api/
openstack/compute/schemas/migrate_server.py#L33
and also param say it's required, but the doc says 'if you omit'
will misleading user ,actually, user can't omit it, they need
to input null to let scheduler decide

Implements: blueprint api-ref-in-rst-ocata

Change-Id: I2661c85f32eff8e199856635a4c40a494a5decb6
2017-01-06 14:38:40 +00:00
Jenkins 7083017ab9 Merge "Missing usage next links in api-ref" 2017-01-06 13:11:26 +00:00
Jay Pipes 03c2776e49 Return uuid attribute for aggregates
Adds a Compute API microversion that triggers returning an aggregate's UUID
field. This field is necessary for scripts that must populate the placement API
with resource provider to aggregate relationships, which rely on UUIDs for
global identification.

APIImpact
blueprint: return-uuid-from-os-aggregates-api
Change-Id: I4112ccd508eb85403933fec8b52efd468e866772
Closes-bug: #1652642
2017-01-05 14:32:43 -05:00
Takashi NATSUME 1278b1fe44 api-ref: Fix parameters in os-server-groups.inc
Fix the following parameters.

- 'id'(server group id) defined as a path parameter in body
- 'server_group' object defined as 'server_groups' list
- missing 'server_group' object
- 'user_id' defined as a query parameter in body

Change-Id: I3dcf6aa317b428d6984b0dcb61496594a68bba6f
Closes-Bug: #1652897
2017-01-03 23:29:37 +00:00
Diana Clarke 38a1edf636 Missing usage next links in api-ref
Microversion 2.40 added paging to simple tenant usage, complete with
"next" links, but the api-ref response documentation wasn't updated to
include them.

Change-Id: Iaf2d71cc45b896ccb00271fd455befd24f1efadd
Closes-Bug: #1651254
2017-01-03 08:46:34 -05:00
Jenkins 1015642f41 Merge "Trival fix typos in api-ref" 2017-01-03 09:23:00 +00:00
Matt Riedemann 0a3f5dca2c api-ref: cleanup os-server-groups 'policies' parameter description
The 'policies' parameter for the os-server-groups API is an array
for legacy reasons, but the schema validation allows only a single
item and it's from the enumerated list, and exactly one must be
specified when creating a server group.

This patch cleans up the policies parameter description to avoid
confusion over the number of items that can be specified or their
form, and it also provides a description of each available policy.

Since the jsonschema for policies is a bit confusing too, this
patch adds a comment in the schema code to avoid future confusion
over how the validation works.

Change-Id: I3ab2880ed6e8bb2cdf476c197719b83d768d44d0
Closes-Bug: #1652943
2016-12-28 10:06:40 -05:00
Takashi NATSUME e7f5f02f7d api-ref: Fix parameter type in servers-admin-action.inc
Fix parameter type and add a missing parameter
in servers-admin-action.inc.

Change-Id: I8ad9227b49ad8148098a8658647bb4a9216d15ba
Closes-Bug: #1651441
2016-12-26 05:30:47 +00:00
Kevin_Zheng 250799551b Trival fix typos in api-ref
Trival fix typos in api-ref

Change-Id: I98347db828a919dd9fa8f3c3ad51c7a048909176
2016-12-21 21:50:55 +08:00
Jenkins f2e4b244e8 Merge "osapi_max_limit -> max_limit" 2016-12-19 15:25:50 +00:00
Diana Clarke c8b631bc36 osapi_max_limit -> max_limit
This max limit config option was moved to the api group in
Ida4ee57d6e1822e35e3198f6d3a89410e211d57d. Update the api-ref to reflect
those changes.

Change-Id: I8ee5b07eecc49833987be499273f3eb7420197e4
2016-12-15 13:28:51 -05:00
Diana Clarke 83404013cb Simple tenant usage pagination
Add optional parameters 'limit' and 'marker' to the
os-simple-tenant-usage endpoints for pagaination.

  /os-simple-tenant-usage?limit={limit}&marker={instance_uuid}
  /os-simple-tenant-usage/{tenant}?limit={limit}&marker={instance_uuid}

The aggregate usage totals may no longer reflect all instances for a
tenant, but rather just the instances for a given page. API consumers
will need to stitch the aggregate data back together (add the totals)
if a tenant's instances span several pages.

Implements blueprint paginate-simple-tenant-usage
Change-Id: Ic8e9f869f1b855f968967bedbf77542f287f26c0
2016-12-14 03:33:50 +00:00
Takashi NATSUME 6ab20bc523 api-ref: Fix 'id' (attachment_id) parameters
At first, the 'attachment_id_resp' in parameters.yaml was defined
as 'required' in I3789a4ad36e30728024f2aa122403b0e53b1e741
for os-volume_attachments.inc.
Then it was changed to 'optional' in
I0c1d183c5aaf6fb796be30fa5627bd5644ea689f
for os-volumes.inc.
So currently 'id' (attachment_id) parameters in
os-volume_attachments.inc are wrong.
They should be 'required'. So fix them.

Change-Id: I403a9eb1b08a840cbb2b82cb37f1b49c6edb87c9
Closes-Bug: #1608842
2016-12-13 06:18:05 +00:00
Jenkins e75d5f9d53 Merge "[proxy-api] microversion 2.39 deprecates image-metadata proxy API" 2016-12-07 21:17:03 +00:00