f86cc2fc8e
This change creates two directories of content, based on who they're relevant to: users and contributors. Files which were in the top-level folder were moved, as well as some within folders in that top-level. This is one change of a multi-step process, so it only deals with renamings in order to make further changes cleaner. Change-Id: I3c9bb7da4f283e2696e7bcea84824c778bbcecfb Partial-Bug: 1416553
36 lines
999 B
ReStructuredText
36 lines
999 B
ReStructuredText
Resource
|
|
========
|
|
.. automodule:: openstack.resource
|
|
|
|
The prop class
|
|
--------------
|
|
|
|
.. autoclass:: openstack.resource.prop
|
|
:members:
|
|
|
|
The Resource class
|
|
------------------
|
|
|
|
.. autoclass:: openstack.resource.Resource
|
|
:members:
|
|
:member-order: bysource
|
|
|
|
How path_args are used
|
|
**********************
|
|
|
|
As :class:`Resource`\s often contain compound :data:`Resource.base_path`\s,
|
|
meaning the path is constructed from more than just that string, the
|
|
various request methods need a way to fill in the missing parts.
|
|
That's where ``path_args`` come in.
|
|
|
|
For example::
|
|
|
|
class ServerIP(resource.Resource):
|
|
base_path = "/servers/%(server_id)s/ips"
|
|
|
|
Making a GET request to obtain server IPs requires the ID of the server
|
|
to check. This is handled by passing ``{"server_id": "12345"}`` as the
|
|
``path_args`` argument when calling :meth:`Resource.get_by_id`. From there,
|
|
the method uses Python's string interpolation to fill in the ``server_id``
|
|
piece of the URL, and then makes the request.
|