keystone/api-ref/source/v3-ext/federation/mapping/mapping.inc

152 lines
2.7 KiB
ReStructuredText

.. -*- rst -*-
Create a mapping
================
.. rest_method:: PUT /v3/OS-FEDERATION/mappings/{id}
Relationship: ``http://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/mapping``
Normal response codes: 201
Request
-------
.. rest_parameters:: federation/mapping/parameters.yaml
- id: id_path
- rules: rules
Request Example
---------------
.. literalinclude:: federation/mapping/samples/create-request.json
:language: javascript
Response
--------
.. rest_parameters:: federation/mapping/parameters.yaml
- id: id_body
- links: links
- rules: rules
Response Example
----------------
.. literalinclude:: federation/mapping/samples/create-response.json
:language: javascript
Get a mapping
=============
.. rest_method:: GET /v3/OS-FEDERATION/mappings/{id}
Relationship: ``http://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/mapping``
Normal response codes: 200
Request
-------
.. rest_parameters:: federation/mapping/parameters.yaml
- id: id_path
Response
--------
.. rest_parameters:: federation/mapping/parameters.yaml
- id: id_body
- links: links
- rules: rules
Response Example
----------------
.. literalinclude:: federation/mapping/samples/get-response.json
:language: javascript
Update a mapping
================
.. rest_method:: PATCH /v3/OS-FEDERATION/mappings/{id}
Relationship: ``http://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/mapping``
Normal response codes: 200
Request
-------
.. rest_parameters:: federation/mapping/parameters.yaml
- id: id_path
- rules: rules
Request Example
---------------
.. literalinclude:: federation/mapping/samples/update-request.json
:language: javascript
Response
--------
.. rest_parameters:: federation/mapping/parameters.yaml
- id: id_body
- links: links
- rules: rules
Response Example
----------------
.. literalinclude:: federation/mapping/samples/update-response.json
:language: javascript
List all mappings
=================
.. rest_method:: GET /v3/OS-FEDERATION/mappings
Relationship: ``http://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/mappings``
Normal response codes: 200
Response
--------
.. rest_parameters:: federation/mapping/parameters.yaml
- links: links_collection
- mappings: mappings
Response Example
----------------
.. literalinclude:: federation/mapping/samples/list-response.json
:language: javascript
Delete a mapping
================
.. rest_method:: DELETE /v3/OS-FEDERATION/mappings/{id}
Relationship: ``http://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/mapping``
Normal response codes: 204
Request
-------
.. rest_parameters:: federation/mapping/parameters.yaml
- id: id_path