nova/api-ref/source/os-certificates.inc
ghanshyam 60935aa688 Trivial: add 'DEPRECATED' for os-certificates API ref
os-certificates API has been deprecated in
I0ffa9200d8b4f52da4751e731aecffe09fd3d4be

This patch just add 'DEPRECATED' in its heading in api-ref
to make it more clear.

Change-Id: I5ef30330e033eeb0576d3b4d31441d5481cc7d2e
2016-08-01 15:08:42 +09:00

69 lines
1.5 KiB
ReStructuredText

.. -*- rst -*-
=================================================
Root certificates (os-certificates) (DEPRECATED)
=================================================
Creates and shows details for a root certificate.
.. warning::
This API existed solely because of the need to build euca bundles
when Nova had an in tree EC2 API. It no longer interacts with any
parts of the system besides it's own certificate daemon. It is
deprecated and will be removed in the near future.
Create Root Certificate
=======================
.. rest_method:: POST /os-certificates
Creates a root certificate.
Normal response codes: 200
Error response codes: unauthorized(401), forbidden(403)
Response
--------
.. rest_parameters:: parameters.yaml
- certificate: certificate
- data: data
- private_key: private_key
|
**Example Create Root Certificate**
.. literalinclude:: ../../doc/api_samples/os-certificates/certificate-create-resp.json
:language: javascript
Show Root Certificate Details
=============================
.. rest_method:: GET /os-certificates/root
Shows details for a root certificate.
Normal response codes: 200
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404), notImplemented(501)
Response
--------
.. rest_parameters:: parameters.yaml
- certificate: certificate
- data: data
- private_key: private_key
|
**Example Show Root Certificate Details**
.. literalinclude:: ../../doc/api_samples/os-certificates/certificate-get-root-resp.json
:language: javascript