Remove api guide in favor of swagger Docs
This removes the API guide as it was out of date, and the recently added swagger docs are much more accurate and useful. Ideally we should implement hosting of the swagger docs somewhere, but not much benefit in continuing to host an inaccurate api guide in the meantime. Change-Id: I4bee4dda7332e1c8ca1a60aa15c793efb937375f
This commit is contained in:
Sean Eagan
parent
99ced61d3e
commit
177b20185a
@ -1,589 +0,0 @@
|
|||||||
Armada Restful API v1.0
|
|
||||||
=======================
|
|
||||||
|
|
||||||
Description
|
|
||||||
~~~~~~~~~~~
|
|
||||||
|
|
||||||
The Armada API provides the services similar to the cli via Restful endpoints
|
|
||||||
|
|
||||||
|
|
||||||
Base URL
|
|
||||||
~~~~~~~~
|
|
||||||
|
|
||||||
https://armada.localhost/api/v1.0/
|
|
||||||
|
|
||||||
DEFAULT
|
|
||||||
~~~~~~~
|
|
||||||
|
|
||||||
GET ``/releases``
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
|
|
||||||
Summary
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Get tiller releases
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Request
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
|
|
||||||
Responses
|
|
||||||
+++++++++
|
|
||||||
|
|
||||||
**200**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
obtain all running releases
|
|
||||||
|
|
||||||
**Example:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"message": {
|
|
||||||
"namespace": [
|
|
||||||
"armada-release",
|
|
||||||
"armada-release"
|
|
||||||
],
|
|
||||||
"default": [
|
|
||||||
"armada-release",
|
|
||||||
"armada-release"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
**403**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Unable to Authorize or Permission
|
|
||||||
|
|
||||||
|
|
||||||
**405**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Failed to perform action
|
|
||||||
|
|
||||||
GET ``/status``
|
|
||||||
---------------
|
|
||||||
|
|
||||||
|
|
||||||
Summary
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Get armada running state
|
|
||||||
|
|
||||||
|
|
||||||
Request
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
|
|
||||||
Responses
|
|
||||||
+++++++++
|
|
||||||
|
|
||||||
**200**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
obtain armada status
|
|
||||||
|
|
||||||
**Example:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"message": {
|
|
||||||
"tiller": {
|
|
||||||
"state": True,
|
|
||||||
"version": "v2.5.0"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
**403**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Unable to Authorize or Permission
|
|
||||||
|
|
||||||
|
|
||||||
**405**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Failed to perform action
|
|
||||||
|
|
||||||
|
|
||||||
POST ``/validatedesign``
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
|
|
||||||
Summary
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Validates Armada manifest
|
|
||||||
|
|
||||||
|
|
||||||
Request
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
|
|
||||||
Responses
|
|
||||||
+++++++++
|
|
||||||
|
|
||||||
**200**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
obtain valid status true/false
|
|
||||||
|
|
||||||
|
|
||||||
**Example:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"valid": true
|
|
||||||
}
|
|
||||||
|
|
||||||
**403**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Unable to Authorize or Permission
|
|
||||||
|
|
||||||
|
|
||||||
**405**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Failed to perform action
|
|
||||||
|
|
||||||
|
|
||||||
POST ``/apply``
|
|
||||||
---------------
|
|
||||||
|
|
||||||
|
|
||||||
Summary
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Install/Update Armada Manifest
|
|
||||||
|
|
||||||
Request
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Body
|
|
||||||
^^^^
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
disable-update-post | boolean | | | |
|
|
||||||
disable-update-pre | boolean | | | |
|
|
||||||
dry-run | boolean | | | |
|
|
||||||
enable-chart-cleanup | boolean | | | |
|
|
||||||
tiller-host | string | | | |
|
|
||||||
tiller-port | int | | | |
|
|
||||||
timeout | int | | | |
|
|
||||||
wait | boolean | | | |
|
|
||||||
|
|
||||||
|
|
||||||
**Armada schema:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"api": true,
|
|
||||||
"armada": {}
|
|
||||||
}
|
|
||||||
|
|
||||||
Responses
|
|
||||||
+++++++++
|
|
||||||
|
|
||||||
**200**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Successful installation/update of manifest
|
|
||||||
|
|
||||||
**Example:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"message": {
|
|
||||||
"installed": [
|
|
||||||
"armada-release",
|
|
||||||
"armada-release"
|
|
||||||
],
|
|
||||||
"updated": [
|
|
||||||
"armada-release",
|
|
||||||
"armada-release"
|
|
||||||
],
|
|
||||||
"diff": [
|
|
||||||
"values": "value diff",
|
|
||||||
"values": "value diff 2"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
**403**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Unable to Authorize or Permission
|
|
||||||
|
|
||||||
|
|
||||||
**405**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Failed to perform action
|
|
||||||
|
|
||||||
POST ``/rollback/{release}``
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
|
|
||||||
Summary
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Rollback release name
|
|
||||||
|
|
||||||
|
|
||||||
Parameters
|
|
||||||
++++++++++
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 15, 10, 10, 10, 20, 30
|
|
||||||
|
|
||||||
release | path | Yes | string | | | name of the release to rollback
|
|
||||||
version | query | No | integer | | | version of the release to rollback to
|
|
||||||
dry_run | query | No | boolean | | | perform dry run
|
|
||||||
wait | query | No | boolean | | | whether to wait for rollback to complete before returning
|
|
||||||
timeout | query | No | integer | | | time to wait for rollback to complete before timing out
|
|
||||||
|
|
||||||
Request
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
|
|
||||||
Responses
|
|
||||||
+++++++++
|
|
||||||
|
|
||||||
**200**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Successfully Test release response
|
|
||||||
|
|
||||||
**Example:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"message": {
|
|
||||||
"message": "Rollback of release xyz complete"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
**403**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Unable to Authorize or Permission
|
|
||||||
|
|
||||||
|
|
||||||
**405**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Failed to perform action
|
|
||||||
|
|
||||||
|
|
||||||
POST ``/test/{release}``
|
|
||||||
------------------------
|
|
||||||
|
|
||||||
|
|
||||||
Summary
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Test release name
|
|
||||||
|
|
||||||
|
|
||||||
Parameters
|
|
||||||
++++++++++
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 15, 10, 10, 10, 20, 30
|
|
||||||
|
|
||||||
release | path | Yes | string | | | name of the release to test
|
|
||||||
|
|
||||||
Request
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
|
|
||||||
Responses
|
|
||||||
+++++++++
|
|
||||||
|
|
||||||
**200**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Successfully Test release response
|
|
||||||
|
|
||||||
**Example:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"message": {
|
|
||||||
"message": "armada-release",
|
|
||||||
"result": "No test found."
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
**403**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Unable to Authorize or Permission
|
|
||||||
|
|
||||||
|
|
||||||
**405**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Failed to perform action
|
|
||||||
|
|
||||||
POST ``/tests``
|
|
||||||
---------------
|
|
||||||
|
|
||||||
|
|
||||||
Summary
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Test manifest releases
|
|
||||||
|
|
||||||
Request
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
Body
|
|
||||||
^^^^
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
armada | Yes | | | |
|
|
||||||
|
|
||||||
**Armada schema:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"armada": {}
|
|
||||||
}
|
|
||||||
|
|
||||||
Responses
|
|
||||||
+++++++++
|
|
||||||
|
|
||||||
**200**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Successful Test of manifest
|
|
||||||
|
|
||||||
**Example:**
|
|
||||||
|
|
||||||
.. code-block:: javascript
|
|
||||||
|
|
||||||
{
|
|
||||||
"message": {
|
|
||||||
"failed": [
|
|
||||||
"armada-release",
|
|
||||||
"armada-release"
|
|
||||||
],
|
|
||||||
"passed": [
|
|
||||||
"armada-release",
|
|
||||||
"armada-release"
|
|
||||||
],
|
|
||||||
"skipped": [
|
|
||||||
"armada-release",
|
|
||||||
"armada-release"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
**403**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Unable to Authorize or Permission
|
|
||||||
|
|
||||||
|
|
||||||
**405**
|
|
||||||
^^^^^^^
|
|
||||||
|
|
||||||
Failed to perform action
|
|
||||||
|
|
||||||
Data Structures
|
|
||||||
~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
Armada Request Model Structure
|
|
||||||
------------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
disable-update-post | boolean | | | |
|
|
||||||
disable-update-pre | boolean | | | |
|
|
||||||
dry-run | boolean | | | |
|
|
||||||
enable-chart-cleanup | boolean | | | |
|
|
||||||
tiller-host | string | | | |
|
|
||||||
tiller-port | int | | | |
|
|
||||||
timeout | int | | | |
|
|
||||||
wait | boolean | | | |
|
|
||||||
|
|
||||||
**Armada schema:**
|
|
||||||
|
|
||||||
Armada Response Model Structure
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
message | No | | | |
|
|
||||||
|
|
||||||
**Message schema:**
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
installed | No | array of string | | |
|
|
||||||
updated | No | array of string | | |
|
|
||||||
values | No | array of string | | |
|
|
||||||
|
|
||||||
|
|
||||||
Releases Response Model Structure
|
|
||||||
---------------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
message | No | | | |
|
|
||||||
|
|
||||||
**Message schema:**
|
|
||||||
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
namespace | No | array of string | | |
|
|
||||||
|
|
||||||
Status Response Model Structure
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
message | No | | | |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**Message schema:**
|
|
||||||
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
tiller | No | | | |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**Tiller schema:**
|
|
||||||
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
state | No | string | | |
|
|
||||||
version | No | string | | |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Test Response Model Structure
|
|
||||||
-----------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
message | No | | | |
|
|
||||||
|
|
||||||
**Message schema:**
|
|
||||||
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
message | No | string | | |
|
|
||||||
result | No | string | | |
|
|
||||||
|
|
||||||
Tests Request Model Structure
|
|
||||||
-----------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
armada | Yes | | | |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**Armada schema:**
|
|
||||||
|
|
||||||
|
|
||||||
Tests Response Model Structure
|
|
||||||
------------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
message | No | | | |
|
|
||||||
|
|
||||||
|
|
||||||
**Message schema:**
|
|
||||||
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
failed | No | array of string | | |
|
|
||||||
passed | No | array of string | | |
|
|
||||||
skipped | No | array of string | | |
|
|
||||||
|
|
||||||
|
|
||||||
Validate Response Model Structure
|
|
||||||
---------------------------------
|
|
||||||
|
|
||||||
.. csv-table::
|
|
||||||
:delim: |
|
|
||||||
:header: "Name", "Required", "Type", "Format", "Properties", "Description"
|
|
||||||
:widths: 20, 10, 15, 15, 30, 25
|
|
||||||
|
|
||||||
valid | No | boolean | | |
|
|
||||||
@ -10,7 +10,6 @@ Operations Guide
|
|||||||
:maxdepth: 2
|
:maxdepth: 2
|
||||||
:caption: Contents:
|
:caption: Contents:
|
||||||
|
|
||||||
guide-api
|
|
||||||
guide-build-armada-yaml
|
guide-build-armada-yaml
|
||||||
guide-configure
|
guide-configure
|
||||||
guide-troubleshooting
|
guide-troubleshooting
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user