Commit Graph

20 Commits

Author SHA1 Message Date
Raildo Mascena 12020a0b83 Adding note for create a project without domain info
When we create a project, using a project scoped token,
without add the domain_id or domain information in the
project creation parameters, this project will be
automatically created on the default domain.

Change-Id: Ib7a2d47c2204b0639f029c3079f4fa86ee78e3a9
2020-07-03 11:36:06 -03:00
Colleen Murphy 34f6144a47 Document the "immutable" resource option
Roles, projects, and domains can accept "immutable" as a resource
option. This change explains the option in the admin guide and updates
the API reference to mention it.

Change-Id: I95926927472f6418f97a08fea0ebd56da04ce7a5
Related-bug: #1823258
2020-03-17 14:33:29 -07:00
wangxiyuan 5b25f50c35 Update api-ref for unified limits
This patch did:
1. Change the empty string "" to null for `description` property
2. Add the missing `project_id` property back.
3. Add `project_id` filter for listing limits
4. Add `include_limits` filter for showing project

Change-Id: Iffaec737739a29ff81e10f7db33abfc3181fdbbe
2018-08-03 11:02:28 +08:00
wangqiangbj 92db2475d3 add 'tags' in request body of projects
first, add 'tags' in request body of projects when create
and update.
second, put necessary parameter 'name'in first place when
create and update for convenience.

Change-Id: I46a20c3e36dc47db3ec20d39da9036f19e5e4e5c
2018-01-31 09:39:09 +08:00
Suramya Shah 0540954cff Reorganize api-ref: v3 projects
Reorganize as per the documentation session at PTG:
https://etherpad.openstack.org/p/queens-ptg-keystone-docs-cleanup

Change-Id: I8e75cdfcc22a60b3d35e8ab0e5ef4cd677f70bd4
2017-12-28 11:51:08 +05:30
Gage Hugo 0579dec0b9 Add project tags api-ref documentation and reno
This change creates a new page describing the usage of project tags
as well as adds in project tag information into existing projects
refs. The added document highlights the properties of a project
tag, the new API calls created, filtering/searching uses, and examples
for each.

This change also creates a release note for the changes made
that add project tags.

Change-Id: Icff11da9412378ae59c6f392f98b05475c7c501d
Partially-Implements: bp project-tags
2017-10-17 17:56:29 -05:00
Eric Brown 30d9095d28 Use https for docs.openstack.org references
The openstack.org pages now support https and our references to
the site should by default be one signed by the organization.

Change-Id: I30a462e03d1fd7852511e22cac34c6bc0e8917f4
2017-01-30 16:05:08 -08:00
Steve Martinelli 1974f2d5dc [api] add a note about project name restrictions
Mention that project names are limited to domain, 64 characters,
and utf8 support depends on the given backend.

Change-Id: Idc266d693c9e81d2bc9b51f20ad5f1282bda5721
Closes-Bug: 1631517
2016-10-12 15:30:04 +00:00
Dave Chen d907ad3b6f Remove the APIs from doc that is not supported yet
The support of updating project or deleting project cascadely has
not yet implemented in the controller [1] and no routed is defined
yet for this feature.

So, remove they from the public doc and can be added back when this
feature is fully implemented in order not to mislead readers.

[1] https://review.openstack.org/#/c/243585/

bp project-tree-deletion

Change-Id: I22b2cb41d44975bca6bc96ba2e3daa61d5029cce
2016-09-12 16:10:28 +00:00
tengqm 830b01fb3c Tweak api-ref doc for projects
This patch adds the status code table into the api-ref doc for projects.
It brings in a 'status.yaml' file that could be shared by other *.inc
files.

Change-Id: Ic536a4dd686cf9bde70b91f5575e8f3053fd1295
2016-09-10 20:59:47 -04:00
Anh Tran 43df6125f9 api-ref: Splitting status lines in API v3.
Currently, 'Normal response codes' and 'Error response codes' are
in the same line. We should split them.

Change-Id: Iecfa8849a57dc895f639ab2e7d910a2a8763f83a
2016-08-25 13:14:34 +07:00
gage hugo d36e555788 [api] add relationship links to v3
Nearly all the "relationship" links are missing in v3 APIs.

Added relationship links to v3 API pages.

Change-Id: If519692a5b48e563719e8cde5c694edad6e01ef8
Partial-Bug: #1609159
2016-08-11 15:17:59 -05:00
Anh Tran ceaa09dcd7 api-ref: Correcting V3 Policies APIs
Fixed in Create/List/Show/Update APIs.
http://developer.openstack.org/api-ref/identity/v3/index.html#policies

Change-Id: Ia3e4caf80c783ac2213444e9d6fecf39018187d8
Partial-Bug: #1610777
2016-08-11 08:35:26 +07:00
Tin Lam 5740a320f8 api-ref: Add query options to GET /projects API documentation
Add the following query options to the api-ref:

* parents_as_list (key-only, no value expected)
* subtree_as_list (key-only, no value expected)
* parents_as_ids (key-only, no value expected)
* subtree_as_ids (key-only, no value expected)

Change-Id: Ie9362885d57112c81c7141c4238e9e3d5d3e0431
Closes-Bug: #1609175
2016-08-10 12:32:31 +00:00
liyingjun 8026a952de Document query option (is_domain) for projects
The "is_domain" query parameter is missing from GET/UPDATE /v3/projects
documentation in the API site.

Change-Id: I059f7e2ac689ec799dbdcc30c071de26d1603c47
Closes-bug: #1609174
2016-08-07 22:47:10 +08:00
Henry Nash 0b49d43e5b Fix up the api-ref request/response parameters for projects
A number of the examples are also updated, since not all of
them were valid combinations of domain_id, parent_id and
is_domain.

Change-Id: Id642762cd6acfdf6142b24caf3de1d16db599065
2016-07-21 06:07:43 +01:00
Henry Nash 20259d1971 Improve introdcution to api-ref projects
This patch fixes up the intro to projects as well as where
we have text for a given API. A follow on patch will fix up
the paramaters, many of which are wrong.

Change-Id: Ia34a9a1c2460f95886d9d9ea0c560fdf94435012
2016-07-17 16:45:06 +01:00
Lance Bragstad f808dfac27 Correct normal response codes for project docs
The project documentation was listing 20X http status codes as Error response
codes. This commit corrects the documentation to list 20X status codes as
Normal response codes.

Change-Id: I278d7380d2253b36ee4a4c9ad093f1103d6da256
2016-07-13 20:06:59 +00:00
Steve Martinelli ebccd23b78 Add missing preamble for v3 and v3-ext
The api-ref site had a short blurb about the resources listed
in the document, add that back.

Change-Id: I2bac40a250a5b73fb70320d598a12c34c359e3c2
2016-07-04 14:35:49 -07:00
Samuel de Medeiros Queiroz 9a5395f1b2 Migrate identity /v3 docs from api-ref repo
Docs at [1] have already been converted from WADL (SGML / XML) to RST
using fairy-slipper [2].

This commit polish the results from the conversion and migrate the docs
to our repository under 'api-ref/source' directory. In addition, it
added missing descriptions for access_token_id and consumer_id to
'parameters.yaml'.

Polishing the generated RST files include:
- Removing unnecessary blank lines;
- Removing empty references.

Polishing the generated RST files do not include:
- Modifying their content;
- Modifying file names;
- Wrapping lines at the maximum of 79 chars.

Updating the documentation will be done after this migration step.

This change also adds a tox environment to build the docs using sphinx
under 'api-ref/build', which in turn is added to '.gitignore'.

Lastly, 'os-api-ref' is added as a test requirement. It provides the
sphinx stanzas rest_method and rest_parameter, used to define OpenStack
APIs in RST docs.

[1] https://github.com/openstack/api-site/tree/master/api-ref/source/identity/v3
[2] https://github.com/russell/fairy-slipper

Change-Id: If1b9a3e1b2e4ea7211c337071254c26b881893a3
2016-05-24 09:58:23 -03:00