26 Commits

Author SHA1 Message Date
tengqm
fa39e4b1fd api-ref doc for stack (1)
This patch, as a first step, fixes inaccuracies/bugs in api-ref
documentation for stacks. The major changes in this patch include:

- Added missing 'location' and 'X-OpenStack-Request-Id' parameters
  which both appear in some response headers.
- Deleted some descriptions about parameters that are never
  referenced in any APIs.
- Added missing 'deletion_time' parameter.
- Added missing 'environment_files' parameter.
- Added missing sample JSON file for stack-create-response.json.
- Fixed errors in stack-preview-response.json.
- Added tabular description of response codes.
- Added a status.yaml file for response code description (shared).

Change-Id: I826ed899f925812df9b44144469700453789e087
2016-08-18 05:11:01 -04:00
tengqm
77927765a9 Split stack api-ref doc into three files
This patch splits the stacks.inc file into three files so that we can
patch them separately. The original file contains API calls about
stacks, stack snapshots and stack outputs, however, the latter two
have every right to be documented separately.

Change-Id: I3e3b71c914046939cd816c79359601e91791cf82
2016-08-18 03:23:05 -04:00
tengqm
8ee3e581d3 Fix api-ref doc for software deployment.
The current api documentation for software deployment is a mess. This
patch is an attempt to fix it.

Change-Id: I41da79865c2836e6750314497e910982bc5462a9
2016-08-08 03:04:43 -04:00
tengqm
1243dc3797 Fix software config api-ref doc
This patch adds the missing list operation on software configs. It also
reorders the operations on configs/deployments so that finding API docs
will be a little bit easier.

Change-Id: I26e4b34000b71c61f9d9de327c7754ff9031d6b4
2016-08-07 23:46:17 -04:00
Steve Baker
9af4a0acd8 Release note, api-ref for event list nested_depth
To document the feature for the spec-lite bug: #1588561

Change-Id: I466ebf159e4351f5e2d90cde298531803289ab4d
2016-08-04 12:18:31 +12:00
huangtianhua
ccdb9c9ae6 Show 'deletion_time' for stack-list/stack-show apis
We support to get the deleted stacks by filter in stack-list
api, support to show the deleted stack by stack-id,
so to show the 'deletion_time' info of stacks.

Change-Id: I8c55fe7f6a899ca66aa3fef15c93195c03c5aa11
Closes-Bug: #1587214
2016-06-20 10:23:35 +08:00
huangtianhua
2b41589185 [api-ref] Correct stack-list api-ref
Add three parameters in response body of stack-list.

Change-Id: I4f48a24a665d4bd1bf87d0634190126bf82c8430
2016-06-17 15:57:51 +08:00
huangtianhua
13f8527a4c [api-ref] Correct service-list api-ref
Add two parameters in response body.

Change-Id: I453a8b84a83147c4a61d1fb651c104e44fbedd18
2016-06-02 10:12:51 +08:00
Jenkins
67e6f20967 Merge "[api-ref] Added template-function-list" 2016-06-01 11:34:13 +00:00
Jenkins
8ba973a30b Merge "resource list filtering api-ref update" 2016-05-30 11:21:30 +00:00
Jenkins
9c8393c024 Merge "template validate ignore errors api-ref update" 2016-05-30 10:52:51 +00:00
Jenkins
5131faf03e Merge "Add to resource_schema returning description" 2016-05-30 10:45:10 +00:00
Jenkins
a3aa955085 Merge "Add to resource-type-list returning description" 2016-05-27 07:46:49 +00:00
pallavi
c3a83a8779 [api-ref] Added template-function-list
Change-Id: I4a11f2937606131a9dd467ead87f9b6ad8c2df2d
Closes-Bug: #1473814
2016-05-27 04:14:15 +00:00
Jenkins
2759ba7e55 Merge "Adding two parameters into Software configuration" 2016-05-26 13:13:28 +00:00
Peter Razumovsky
f5b64b3e4d Add to resource_schema returning description
Add to resource_schema command ability to return
resource description.

@APIImpact
@DocImpact

Change-Id: I148bb7764af4db45b75ce63d7fa58daa210b3ed4
Closes-bug: #1558049
2016-05-25 16:24:03 +03:00
Peter Razumovsky
42bfc8a282 Add to resource-type-list returning description
Add to resource-type-list command ability to return
resource description.

@APIImpact
@DocImpact

Change-Id: Ia92699e5ca60a891e9704c468e447e1053be7609
Closes-bug: #1558049
2016-05-25 16:10:34 +03:00
Kanagaraj Manickam
ad97123c20 resource list filtering api-ref update
api-ref resource  list is updated to detail
on the filtering supported.

As part of this change, event list related
filtering parameters updated to leverage them
in resource filtering.

Change-Id: I61fc302219cc875e23ee1f2d57394196f64c8e63
2016-05-23 15:57:04 +05:30
Kanagaraj Manickam
4635f666c4 template validate ignore errors api-ref update
api-ref is updated for template validate REST API
to provide details on the ignore_errors query
parameter.

Change-Id: I9e2911c7fbe708913b6f143c6d4e408b148ce672
2016-05-23 15:17:05 +05:30
Jenkins
2219a32995 Merge "Remove html_static_path from api-ref" 2016-05-23 04:28:29 +00:00
Jenkins
9d96d08876 Merge "migrate to upstream os-api-ref" 2016-05-19 09:37:25 +00:00
Daniel Gonzalez
d4b096a513 Remove html_static_path from api-ref
In Id3a71841f5b9a9ea7bb5803afd967ab4feadfe10 the in tree copy of
os-api-ref was migrated to the upstream version. The html_static_path
setting in conf.py was forgotten in the patch, which caused a warning
when building the API reference.
This patch comments out the setting from conf.py to prevent the
warning.

TrivialFix

Change-Id: I267b3f671fdfa2033c24d9407c7bed7e8527e9a2
2016-05-19 09:44:15 +02:00
Sean Dague
c9751d4e60 migrate to upstream os-api-ref
This removes the in tree copy of os-api-ref and migrates to the
upstream released version. It will fix the issues with the style
because the static files weren't in the right place in tree.

Change-Id: Id3a71841f5b9a9ea7bb5803afd967ab4feadfe10
2016-05-18 08:26:55 -04:00
Jay Dobies
2c3def1b2f Fix api-ref generation errors
This patch fixes errors with the include directives generated by the
api-site team for the migration. This patch fixes the errors by bringing
our api-ref docs in line with the existing docs; verifying that the
previous docs are still valid will be a separate initiative.

Change-Id: Ibb7d57d8665dbfb655b2c3bd4a69fdc0f8a44d69
2016-05-16 12:17:06 -04:00
sharat.sharma
9ccb0946da Adding two parameters into Software configuration
This patch added two parameter: software_config and
software_deployments.
"software_config" add into "Create configuration" and
"Show configuration details".
"software_deployments" parameter add into "Show deployment details",
"Update deployment" and "Create deployment".

Change-Id: Iee5cb9affb5dd88cf8769bea20ff3934fcd43b07
Closes-Bug: #1567193
2016-05-11 13:36:11 +05:30
Jay Dobies
4170566618 Migrate API documentations into the Heat tree
For more information, see:
http://lists.openstack.org/pipermail/openstack-dev/2016-May/093765.html

This is the initial port from api-site. The includes in
source/v1/index.rst are alphabetized, but we may want to revisit that
and reorder them according to importance.

Change-Id: I6f578107e17d3a97e667f645a05493da12ae2048
Implements: blueprint api-doc-migration
2016-05-04 15:46:28 -04:00