2016-05-23 18:07:59 -03:00
|
|
|
.. -*- rst -*-
|
|
|
|
|
2016-07-04 14:35:49 -07:00
|
|
|
===============================
|
|
|
|
Service catalog and endpoints
|
|
|
|
===============================
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
A service is an OpenStack web service that you can access through a
|
2016-09-09 02:11:22 -04:00
|
|
|
URL, i.e. an endpoint.
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
A service catalog lists the services that are available to the
|
|
|
|
caller based upon the current authorization.
|
|
|
|
|
|
|
|
You can create, list, show details for, update, and delete
|
|
|
|
services. When you create or update a service, you can enable the
|
|
|
|
service, which causes it and its endpoints to appear in the service
|
|
|
|
catalog.
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
You can create, list, show details for, update, and delete endpoints.
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
|
|
|
|
List services
|
|
|
|
=============
|
|
|
|
|
|
|
|
.. rest_method:: GET /v3/services
|
|
|
|
|
|
|
|
Lists all services.
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/services``
|
2016-08-25 13:14:34 +07:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Request
|
|
|
|
-------
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2020-05-10 12:07:28 +00:00
|
|
|
- name: request_service_name_query_not_required
|
2016-08-05 15:30:07 +07:00
|
|
|
- type: service_type_query
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-08-05 15:30:07 +07:00
|
|
|
- name: service_name
|
|
|
|
- links: service_links
|
|
|
|
- enabled: service_enabled
|
2016-05-23 18:07:59 -03:00
|
|
|
- services: services
|
2016-08-05 15:30:07 +07:00
|
|
|
- type: service_type
|
|
|
|
- id: service_id
|
|
|
|
- description: service_description
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
|
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. literalinclude:: ./samples/admin/services-list-response.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
|
|
Create service
|
|
|
|
==============
|
|
|
|
|
|
|
|
.. rest_method:: POST /v3/services
|
|
|
|
|
|
|
|
Creates a service.
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/services``
|
2016-08-25 13:14:34 +07:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Request
|
|
|
|
-------
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-08-05 15:30:07 +07:00
|
|
|
- description: service_description
|
2016-05-23 18:07:59 -03:00
|
|
|
- service: service
|
2016-08-05 15:30:07 +07:00
|
|
|
- enabled: service_enabled
|
|
|
|
- type: service_type
|
|
|
|
- name: service_name
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. literalinclude:: ./samples/admin/service-create-request.json
|
|
|
|
:language: javascript
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-08-05 15:30:07 +07:00
|
|
|
- name: service_name
|
2016-05-23 18:07:59 -03:00
|
|
|
- service: service
|
2016-08-05 15:30:07 +07:00
|
|
|
- links: service_links
|
|
|
|
- type: service_type
|
|
|
|
- id: service_id
|
|
|
|
- description: service_description
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
2016-09-09 02:11:22 -04:00
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
- 201
|
2016-08-25 13:14:34 +07:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_status_code:: error status.yaml
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
2017-12-28 13:19:40 +05:30
|
|
|
- 409
|
2016-09-09 02:11:22 -04:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Show service details
|
|
|
|
====================
|
|
|
|
|
|
|
|
.. rest_method:: GET /v3/services/{service_id}
|
|
|
|
|
|
|
|
Shows details for a service.
|
|
|
|
|
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/service``
|
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- service_id: service_id_path
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- name: service_name
|
|
|
|
- service: service
|
|
|
|
- links: service_links
|
|
|
|
- type: service_type
|
|
|
|
- id: service_id
|
|
|
|
- description: service_description
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
- 404
|
|
|
|
|
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. literalinclude:: ./samples/admin/service-show-response.json
|
2016-05-23 18:07:59 -03:00
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
Update service
|
|
|
|
==============
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_method:: PATCH /v3/services/{service_id}
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
Updates a service.
|
|
|
|
|
|
|
|
The request body is the same as the create service request body,
|
|
|
|
except that you include only those attributes that you want to
|
|
|
|
update.
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/services``
|
2016-08-25 13:14:34 +07:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Request
|
|
|
|
-------
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- type: service_type
|
2017-02-03 13:20:19 -06:00
|
|
|
- enabled: service_enabled_not_required
|
|
|
|
- description: service_description_not_required
|
2016-09-09 02:11:22 -04:00
|
|
|
- service: service
|
|
|
|
- name: service_name
|
|
|
|
- service_id: service_id_path
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. literalinclude:: ./samples/admin/service-update-request.json
|
2016-05-23 18:07:59 -03:00
|
|
|
:language: javascript
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- name: service_name
|
|
|
|
- service: service
|
|
|
|
- links: service_links
|
|
|
|
- type: service_type
|
|
|
|
- id: service_id
|
|
|
|
- description: service_description
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
- 404
|
|
|
|
- 409
|
|
|
|
|
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. literalinclude:: ./samples/admin/service-update-response.json
|
2016-05-23 18:07:59 -03:00
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
Delete service
|
|
|
|
==============
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_method:: DELETE /v3/services/{service_id}
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
Deletes a service.
|
|
|
|
|
|
|
|
If you try to delete a service that still has associated endpoints,
|
|
|
|
this call either deletes all associated endpoints or fails until
|
|
|
|
all endpoints are deleted.
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/service``
|
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- service_id: service_id_path
|
|
|
|
|
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
2016-09-09 02:11:22 -04:00
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 204
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_status_code:: error status.yaml
|
2016-08-25 13:14:34 +07:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
- 404
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
|
|
|
|
List endpoints
|
|
|
|
==============
|
|
|
|
|
|
|
|
.. rest_method:: GET /v3/endpoints
|
|
|
|
|
|
|
|
Lists all available endpoints.
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/endpoints``
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Request
|
|
|
|
-------
|
2016-09-09 02:11:22 -04:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-08-05 16:11:21 +07:00
|
|
|
- interface: interface_query
|
|
|
|
- service_id: service_id_query
|
2020-07-21 21:22:40 +05:30
|
|
|
- region_id: region_id_query
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2017-02-03 13:20:19 -06:00
|
|
|
- region_id: region_id_required
|
2016-08-05 16:11:21 +07:00
|
|
|
- links: endpoints_links
|
|
|
|
- url: endpoint_url
|
|
|
|
- region: endpoint_region
|
|
|
|
- enabled: endpoint_enabled
|
2019-10-09 15:36:07 +05:30
|
|
|
- interface: endpoint_interface
|
2016-05-23 18:07:59 -03:00
|
|
|
- service_id: service_id
|
|
|
|
- endpoints: endpoints
|
2016-08-05 16:11:21 +07:00
|
|
|
- id: endpoint_id
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
|
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. literalinclude:: ./samples/admin/endpoints-list-response.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
|
|
Create endpoint
|
|
|
|
===============
|
|
|
|
|
|
|
|
.. rest_method:: POST /v3/endpoints
|
|
|
|
|
|
|
|
Creates an endpoint.
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/endpoints``
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Request
|
|
|
|
-------
|
2016-09-09 02:11:22 -04:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- endpoint: endpoint
|
2016-08-05 16:11:21 +07:00
|
|
|
- url: endpoint_url
|
2017-02-03 13:20:19 -06:00
|
|
|
- enabled: endpoint_enabled_not_required
|
2016-08-05 16:11:21 +07:00
|
|
|
- interface: endpoint_interface
|
2016-05-23 18:07:59 -03:00
|
|
|
- service_id: service_id
|
2017-02-03 13:20:19 -06:00
|
|
|
- region_id: region_id_not_required
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. literalinclude:: ./samples/admin/endpoint-create-request.json
|
|
|
|
:language: javascript
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- endpoint: endpoint
|
2016-08-05 16:11:21 +07:00
|
|
|
- links: endpoint_links
|
|
|
|
- url: endpoint_url
|
|
|
|
- region: endpoint_region
|
|
|
|
- enabled: endpoint_enabled
|
|
|
|
- interface: endpoint_interface
|
2016-05-23 18:07:59 -03:00
|
|
|
- service_id: service_id
|
2016-08-05 16:11:21 +07:00
|
|
|
- id: endpoint_id
|
2017-02-03 13:20:19 -06:00
|
|
|
- region_id: region_id_required
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_status_code:: success status.yaml
|
2016-08-25 13:14:34 +07:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
- 201
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
2017-12-28 13:19:40 +05:30
|
|
|
- 409
|
2016-09-09 02:11:22 -04:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
|
|
|
|
Show endpoint details
|
|
|
|
=====================
|
|
|
|
|
|
|
|
.. rest_method:: GET /v3/endpoints/{endpoint_id}
|
|
|
|
|
|
|
|
Shows details for an endpoint.
|
|
|
|
|
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/endpoints``
|
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- endpoint_id: endpoint_id_path
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- endpoint: endpoint
|
|
|
|
- name: endpoint_name
|
|
|
|
- links: endpoint_links
|
|
|
|
- url: endpoint_url
|
|
|
|
- region: endpoint_region
|
|
|
|
- interface: endpoint_interface
|
|
|
|
- service_id: service_id
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
- 404
|
|
|
|
|
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. literalinclude:: ./samples/admin/endpoint-show-response.json
|
2016-05-23 18:07:59 -03:00
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
Update endpoint
|
|
|
|
===============
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_method:: PATCH /v3/endpoints/{endpoint_id}
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
Updates an endpoint.
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/endpoint``
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Request
|
|
|
|
-------
|
2016-09-09 02:11:22 -04:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- endpoint: endpoint
|
|
|
|
- url: endpoint_url
|
|
|
|
- region: endpoint_region
|
|
|
|
- interface: endpoint_interface
|
|
|
|
- service_id: service_id
|
|
|
|
- endpoint_id: endpoint_id_path
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. literalinclude:: ./samples/admin/endpoint-update-request.json
|
2016-05-23 18:07:59 -03:00
|
|
|
:language: javascript
|
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- endpoint: endpoint
|
|
|
|
- id: endpoint_id
|
|
|
|
- links: endpoint_links
|
|
|
|
- url: endpoint_url
|
|
|
|
- region: endpoint_region
|
|
|
|
- interface: endpoint_interface
|
|
|
|
- service_id: service_id
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
- 404
|
|
|
|
- 409
|
|
|
|
|
|
|
|
Example
|
|
|
|
~~~~~~~
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. literalinclude:: ./samples/admin/endpoint-update-response.json
|
2016-05-23 18:07:59 -03:00
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
Delete endpoint
|
|
|
|
===============
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_method:: DELETE /v3/endpoints/{endpoint_id}
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Deletes an endpoint.
|
|
|
|
|
2017-01-30 13:53:09 -08:00
|
|
|
Relationship: ``https://docs.openstack.org/api/openstack-identity/3/rel/endpoint``
|
2016-08-11 14:37:21 -05:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
~~~~~~~~~~
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- endpoint_id: endpoint_id_path
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2017-12-28 13:19:40 +05:30
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
Status Codes
|
|
|
|
~~~~~~~~~~~~
|
2016-09-09 02:11:22 -04:00
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- 204
|
2016-08-25 13:14:34 +07:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
.. rest_status_code:: error status.yaml
|
2016-05-23 18:07:59 -03:00
|
|
|
|
2016-09-09 02:11:22 -04:00
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
2017-12-28 13:19:40 +05:30
|
|
|
- 404
|