332e2b6fe4
We noticed that from the user perspective it is hard
to know when a cluster_template provided by the cloud
admin is mature enough for a production release.
This field will allow the administrator to add an
annotation to the cluster template like
{deprecated, recommended, testing} giving further
usefull information to the end user about the
template's life cycle
This patch adds the necessary database column and
API objects to handle the new argument.
story: 2007857
task: 40160
Change-Id: I5d1c4221f089bc5cd12b25f620aa01771a029df9
Signed-off-by: Diogo Guerra <diogo.filipe.tomas.guerra@cern.ch>
378 lines
8.4 KiB
ReStructuredText
378 lines
8.4 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
==========================
|
|
Manage Cluster Templates
|
|
==========================
|
|
|
|
Lists, creates, shows details for, updates, and deletes Cluster Templates.
|
|
|
|
Create new cluster template
|
|
=====================================
|
|
|
|
.. rest_method:: POST /v1/clustertemplates
|
|
|
|
Create new cluster template.
|
|
|
|
Response Codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 201
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- labels: labels
|
|
- fixed_subnet: fixed_subnet
|
|
- master_flavor_id: master_flavor_id
|
|
- no_proxy: no_proxy
|
|
- https_proxy: https_proxy
|
|
- http_proxy: http_proxy
|
|
- tls_disabled: tls_disabled
|
|
- keypair_id: keypair_id
|
|
- public: public_type
|
|
- docker_volume_size: docker_volume_size
|
|
- server_type: server_type
|
|
- external_network_id: external_network_id
|
|
- image_id: image_id
|
|
- volume_driver: volume_driver
|
|
- registry_enabled: registry_enabled
|
|
- docker_storage_driver: docker_storage_driver
|
|
- name: name
|
|
- network_driver: network_driver
|
|
- fixed_network: fixed_network
|
|
- coe: coe
|
|
- flavor_id: flavor_id
|
|
- master_lb_enabled: master_lb_enabled
|
|
- dns_nameserver: dns_nameserver
|
|
- floating_ip_enabled: floating_ip_enabled
|
|
- hidden: hidden
|
|
- tags: tags
|
|
|
|
Request Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/clustertemplate-create-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- X-Openstack-Request-Id: request_id
|
|
- insecure_registry: insecure_registry
|
|
- links: links
|
|
- http_proxy: http_proxy
|
|
- updated_at: updated_at
|
|
- floating_ip_enabled: floating_ip_enabled
|
|
- fixed_subnet: fixed_subnet
|
|
- master_flavor_id: master_flavor_id
|
|
- uuid: clustertemplate_id
|
|
- no_proxy: no_proxy
|
|
- https_proxy: https_proxy
|
|
- tls_disabled: tls_disabled
|
|
- keypair_id: keypair_id
|
|
- public: public_type
|
|
- labels: labels
|
|
- docker_volume_size: docker_volume_size
|
|
- server_type: server_type
|
|
- external_network_id: external_network_id
|
|
- cluster_distro: cluster_distro
|
|
- image_id: image_id
|
|
- volume_driver: volume_driver
|
|
- registry_enabled: registry_enabled
|
|
- docker_storage_driver: docker_storage_driver
|
|
- apiserver_port: apiserver_port
|
|
- name: name
|
|
- created_at: created_at
|
|
- network_driver: network_driver
|
|
- fixed_network: fixed_network
|
|
- coe: coe
|
|
- flavor_id: flavor_id
|
|
- master_lb_enabled: master_lb_enabled
|
|
- dns_nameserver: dns_nameserver
|
|
- hidden: hidden
|
|
- tags: tags
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/clustertemplate-create-resp.json
|
|
:language: javascript
|
|
|
|
List all cluster templates
|
|
==========================
|
|
|
|
.. rest_method:: GET /v1/clustertemplates
|
|
|
|
List all available cluster templates in Magnum.
|
|
|
|
Response Codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 401
|
|
- 403
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- X-Openstack-Request-Id: request_id
|
|
- clustertemplates: clustertemplate_list
|
|
- insecure_registry: insecure_registry
|
|
- links: links
|
|
- http_proxy: http_proxy
|
|
- updated_at: updated_at
|
|
- floating_ip_enabled: floating_ip_enabled
|
|
- fixed_subnet: fixed_subnet
|
|
- master_flavor_id: master_flavor_id
|
|
- uuid: clustertemplate_id
|
|
- no_proxy: no_proxy
|
|
- https_proxy: https_proxy
|
|
- tls_disabled: tls_disabled
|
|
- keypair_id: keypair_id
|
|
- public: public_type
|
|
- labels: labels
|
|
- docker_volume_size: docker_volume_size
|
|
- server_type: server_type
|
|
- external_network_id: external_network_id
|
|
- cluster_distro: cluster_distro
|
|
- image_id: image_id
|
|
- volume_driver: volume_driver
|
|
- registry_enabled: registry_enabled
|
|
- docker_storage_driver: docker_storage_driver
|
|
- apiserver_port: apiserver_port
|
|
- name: name
|
|
- created_at: created_at
|
|
- network_driver: network_driver
|
|
- fixed_network: fixed_network
|
|
- coe: coe
|
|
- flavor_id: flavor_id
|
|
- master_lb_enabled: master_lb_enabled
|
|
- dns_nameserver: dns_nameserver
|
|
- hidden: hidden
|
|
- tags: tags
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/clustertemplate-get-all-resp.json
|
|
:language: javascript
|
|
|
|
Show details of a cluster template
|
|
==================================
|
|
|
|
.. rest_method:: GET /v1/clustertemplates/{clustertemplate_ident}
|
|
|
|
Get all information of a cluster template in Magnum.
|
|
|
|
Response Codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 401
|
|
- 403
|
|
- 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- clustertemplate_ident: clustertemplate_ident
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- X-Openstack-Request-Id: request_id
|
|
- clustertemplates: clustertemplate_list
|
|
- insecure_registry: insecure_registry
|
|
- links: links
|
|
- http_proxy: http_proxy
|
|
- updated_at: updated_at
|
|
- floating_ip_enabled: floating_ip_enabled
|
|
- fixed_subnet: fixed_subnet
|
|
- master_flavor_id: master_flavor_id
|
|
- uuid: clustertemplate_id
|
|
- no_proxy: no_proxy
|
|
- https_proxy: https_proxy
|
|
- tls_disabled: tls_disabled
|
|
- keypair_id: keypair_id
|
|
- public: public_type
|
|
- labels: labels
|
|
- docker_volume_size: docker_volume_size
|
|
- server_type: server_type
|
|
- external_network_id: external_network_id
|
|
- cluster_distro: cluster_distro
|
|
- image_id: image_id
|
|
- volume_driver: volume_driver
|
|
- registry_enabled: registry_enabled
|
|
- docker_storage_driver: docker_storage_driver
|
|
- apiserver_port: apiserver_port
|
|
- name: name
|
|
- created_at: created_at
|
|
- network_driver: network_driver
|
|
- fixed_network: fixed_network
|
|
- coe: coe
|
|
- flavor_id: flavor_id
|
|
- master_lb_enabled: master_lb_enabled
|
|
- dns_nameserver: dns_nameserver
|
|
- hidden: hidden
|
|
- tags: tags
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/clustertemplate-create-resp.json
|
|
:language: javascript
|
|
|
|
Delete a cluster template
|
|
=========================
|
|
|
|
.. rest_method:: DELETE /v1/clustertemplates/{clustertemplate_ident}
|
|
|
|
Delete a cluster template.
|
|
|
|
Response Codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 204
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 409
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- clustertemplate_ident: clustertemplate_ident
|
|
|
|
Response
|
|
--------
|
|
|
|
This request does not return anything in the response body.
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- X-Openstack-Request-Id: request_id
|
|
|
|
Update information of cluster template
|
|
================================================
|
|
|
|
.. rest_method:: PATCH /v1/clustertemplates/{clustertemplate_ident}
|
|
|
|
Update information of one cluster template attributes using operations
|
|
including: ``add``, ``replace`` or ``remove``. The attributes to ``add`` and
|
|
``replace`` in the form of ``key=value`` while ``remove`` only needs the keys.
|
|
|
|
Response Codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- clustertemplate_ident: clustertemplate_ident
|
|
- path: path
|
|
- value: value
|
|
- op: op
|
|
|
|
Request Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/clustertemplate-update-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
Return new cluster templates with updated attributes.
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- X-Openstack-Request-Id: request_id
|
|
- clustertemplates: clustertemplate_list
|
|
- insecure_registry: insecure_registry
|
|
- links: links
|
|
- http_proxy: http_proxy
|
|
- updated_at: updated_at
|
|
- floating_ip_enabled: floating_ip_enabled
|
|
- fixed_subnet: fixed_subnet
|
|
- master_flavor_id: master_flavor_id
|
|
- uuid: clustertemplate_id
|
|
- no_proxy: no_proxy
|
|
- https_proxy: https_proxy
|
|
- tls_disabled: tls_disabled
|
|
- keypair_id: keypair_id
|
|
- public: public_type
|
|
- labels: labels
|
|
- docker_volume_size: docker_volume_size
|
|
- server_type: server_type
|
|
- external_network_id: external_network_id
|
|
- cluster_distro: cluster_distro
|
|
- image_id: image_id
|
|
- volume_driver: volume_driver
|
|
- registry_enabled: registry_enabled
|
|
- docker_storage_driver: docker_storage_driver
|
|
- apiserver_port: apiserver_port
|
|
- name: name
|
|
- created_at: created_at
|
|
- network_driver: network_driver
|
|
- fixed_network: fixed_network
|
|
- coe: coe
|
|
- flavor_id: flavor_id
|
|
- master_lb_enabled: master_lb_enabled
|
|
- dns_nameserver: dns_nameserver
|
|
- hidden: hidden
|
|
- tags: tags
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/clustertemplate-create-resp.json
|
|
:language: javascript
|