ac4cc65cb5
Contains .inc files which have all the contents of the .rst files but are grouped together for easier editing. Contains parameters.yaml, which has all parameters in one file. Contains request and response samples (JSON and XML) that are pointed to from the .inc files. Change-Id: I42d5451300f95774a3ec4df66bc95cb36795844d
240 lines
4.3 KiB
ReStructuredText
240 lines
4.3 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
=================
|
|
Cluster templates
|
|
=================
|
|
|
|
A cluster template configures a Hadoop cluster. A cluster template
|
|
lists node groups with the number of instances in each group. You
|
|
can also define cluster-scoped configurations in a cluster
|
|
template.
|
|
|
|
|
|
Show cluster template details
|
|
=============================
|
|
|
|
.. rest_method:: GET /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}
|
|
|
|
Shows details for a cluster template.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- cluster_template_id: cluster_template_id
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- use_autoconfig: use_autoconfig
|
|
- cluster_configs: cluster_configs
|
|
- created_at: created_at
|
|
- default_image_id: default_image_id
|
|
- updated_at: updated_at
|
|
- plugin_name: plugin_name
|
|
- is_default: is_default
|
|
- is_protected: is_protected
|
|
- shares: shares
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: id
|
|
- name: name
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ../samples/cluster-templates/cluster-templates-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Update cluster templates
|
|
========================
|
|
|
|
.. rest_method:: PUT /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}
|
|
|
|
Updates a cluster template.
|
|
|
|
Error response codes:202,
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- cluster_template_id: cluster_template_id
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: ../samples/cluster-templates/cluster-template-update-request.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- use_autoconfig: use_autoconfig
|
|
- cluster_configs: cluster_configs
|
|
- created_at: created_at
|
|
- default_image_id: default_image_id
|
|
- updated_at: updated_at
|
|
- plugin_name: plugin_name
|
|
- is_default: is_default
|
|
- is_protected: is_protected
|
|
- shares: shares
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: id
|
|
- name: name
|
|
|
|
|
|
|
|
|
|
|
|
Delete cluster template
|
|
=======================
|
|
|
|
.. rest_method:: DELETE /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}
|
|
|
|
Deletes a cluster template.
|
|
|
|
Error response codes:204,
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- cluster_template_id: cluster_template_id
|
|
|
|
|
|
|
|
|
|
|
|
|
|
List cluster templates
|
|
======================
|
|
|
|
.. rest_method:: GET /v1.1/{tenant_id}/cluster-templates
|
|
|
|
Lists available cluster templates.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- use_autoconfig: use_autoconfig
|
|
- cluster_configs: cluster_configs
|
|
- created_at: created_at
|
|
- default_image_id: default_image_id
|
|
- updated_at: updated_at
|
|
- plugin_name: plugin_name
|
|
- is_default: is_default
|
|
- is_protected: is_protected
|
|
- shares: shares
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: id
|
|
- name: name
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ../samples/cluster-templates/cluster-templates-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Create cluster templates
|
|
========================
|
|
|
|
.. rest_method:: POST /v1.1/{tenant_id}/cluster-templates
|
|
|
|
Creates a cluster template.
|
|
|
|
Error response codes:202,
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: ../samples/cluster-templates/cluster-template-create-request.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- use_autoconfig: use_autoconfig
|
|
- cluster_configs: cluster_configs
|
|
- created_at: created_at
|
|
- default_image_id: default_image_id
|
|
- updated_at: updated_at
|
|
- plugin_name: plugin_name
|
|
- is_default: is_default
|
|
- is_protected: is_protected
|
|
- shares: shares
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: id
|
|
- name: name
|
|
|
|
|
|
|
|
|