promenade/doc/source/api.rst

65 lines
1.1 KiB
ReStructuredText

Promenade API
=============
/v1.0/health
------------
Allows other components to validate Promenade's health status.
GET /v1.0/health
Returns the health status.
Responses:
+ 204 No Content
/v1.0/join-scripts
------------------
Generates join scripts and for Drydock.
GET /v1.0/join-scripts
Generates script to be consumed by Drydock.
Query parameters
hostname
Name of the node
ip
IP address of the node
design_ref
Endpoint containing configuration documents
dynamic.labels
Used to set configuration options in the generated script
static.labels
Used to set configuration options in the generated script
Responses:
+ 200 OK: Script returned as response body
+ 400 Bad Request: One or more query parameters is missing or misspelled
/v1.0/validatedesign
--------------------
Performs validations against specified documents.
POST /v1.0/validatedesign
Performs validation against specified documents.
Message Body
href
Location of the document to be validated
Responses:
+ 200 OK: Documents were successfully validated
+ 400 Bad Request: Documents were not successfully validated