cinder/doc/source/configuration/block-storage/samples
Alan Bishop 31b34e91e0 Remove the need for project_id from API endpoints
Inclusion of a project_id in API URLs is now optional, and no longer
required. Removing the project_id requirement facilitates supporting
Secure RBAC's notion of system scope, in which an API method is not
associated with a specific project.

The API v3 routing is enhanced to provide duplicate routes for API
methods that traditionally required a project_id in the URL:
- The existing route for which a project_id is in the URL
- A new route for when the URL does not include a project_id

To test both routes and ensure there are no regresssions, the "API
samples" functional tests include a project_id in the URLs, and the
rest of the functional tests do not include the project_id. This is
handled by changing the 'noauth' WSGI middleware to no longer add the
project_id, and adding a new 'noauth_include_project_id' middleware
filter that implements the legacy behavior.

A new microversion V3.67 is introduced, but it only serves to inform
clients whether the project_id is optional or required. When an API
node supports mv 3.67, the project_id is optional in all API requests,
even when the request specifies a earlier microversion. See the spec
Ia44f199243be8f862520d7923007e7182b32f67d for more details on this
behavior.

Note: Much of the groundwork for this is based on manila's patch
I5127e150e8a71e621890f30dba6720b3932cf583.

DocImpact
APIImpact

Implements: blueprint project-id-optional-in-urls
Change-Id: I3729cbe1902ab4dc335451d13ed921ec236fb8fd
2022-02-08 08:32:23 -08:00
..
api-paste.ini.inc Remove the need for project_id from API endpoints 2022-02-08 08:32:23 -08:00
api-paste.ini.rst [DOC BLD FIX] Fix remote-code-block warnings 2017-08-29 10:53:48 -05:00
cinder.conf.rst Add pdf documentation build in tox 2019-08-28 20:37:56 +00:00
index.rst Better workaround for policy file in PDF docs 2021-09-14 17:04:59 -04:00
policy.yaml.rst Better workaround for policy file in PDF docs 2021-09-14 17:04:59 -04:00
rootwrap.conf.inc [DOC BLD FIX] Fix remote-code-block warnings 2017-08-29 10:53:48 -05:00
rootwrap.conf.rst [DOC BLD FIX] Fix remote-code-block warnings 2017-08-29 10:53:48 -05:00