keystone/api-ref/source/v3-ext/federation/service-provider/sp.inc

170 lines
3.6 KiB
ReStructuredText

.. -*- rst -*-
Register a service provider
===========================
.. rest_method:: PUT /v3/OS-FEDERATION/service_providers/{id}
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/service_provider``
Normal response codes: 201
Request
-------
.. rest_parameters:: federation/service-provider/parameters.yaml
- auth_url: auth_url
- description: description
- enabled: enabled
- id: id_path
- sp_url: sp_url
Request Example
---------------
.. literalinclude:: federation/service-provider/samples/register-request.json
:language: javascript
Response
--------
.. rest_parameters:: federation/service-provider/parameters.yaml
- auth_url: auth_url
- description: description
- enabled: enabled
- id: id_body
- links: links
- relay_state_prefix: relay_state_prefix
- sp_url: sp_url
Response Example
----------------
.. literalinclude:: federation/service-provider/samples/register-response.json
:language: javascript
List service providers
======================
.. rest_method:: GET /v3/OS-FEDERATION/service_providers
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/service_providers``
Normal response codes: 200
Response
--------
.. rest_parameters:: federation/service-provider/parameters.yaml
- links: links_collection
- service_providers: service_providers
Response Example
----------------
.. literalinclude:: federation/service-provider/samples/list-response.json
:language: javascript
Get Service Provider
====================
.. rest_method:: GET /v3/OS-FEDERATION/service_providers/{id}
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/service_provider``
Normal response codes: 200
Request
-------
.. rest_parameters:: federation/service-provider/parameters.yaml
- id: id_path
Response
--------
.. rest_parameters:: federation/service-provider/parameters.yaml
- auth_url: auth_url
- description: description
- enabled: enabled
- id: id_body
- links: links
- relay_state_prefix: relay_state_prefix
- sp_url: sp_url
Response Example
----------------
.. literalinclude:: federation/service-provider/samples/get-response.json
:language: javascript
Delete Service Provider
=======================
.. rest_method:: DELETE /v3/OS-FEDERATION/service_providers/{id}
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/service_provider``
Normal response codes: 204
Request
-------
.. rest_parameters:: federation/service-provider/parameters.yaml
- id: id_path
Update service provider
=======================
.. rest_method:: PATCH /v3/OS-FEDERATION/service_providers/{id}
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/ext/OS-FEDERATION/1.0/rel/service_provider``
Normal response codes: 200
Request
-------
.. rest_parameters:: federation/service-provider/parameters.yaml
- id: id_path
- auth_url: auth_url
- description: description
- enabled: enabled
- sp_url: sp_url
Request Example
---------------
.. literalinclude:: federation/service-provider/samples/update-request.json
:language: javascript
Response
--------
.. rest_parameters:: federation/service-provider/parameters.yaml
- auth_url: auth_url
- description: description
- enabled: enabled
- id: id_body
- links: links
- relay_state_prefix: relay_state_prefix
- sp_url: sp_url
Response Example
----------------
.. literalinclude:: federation/service-provider/samples/update-response.json
:language: javascript