8b830df305
Make space for v2. It should not break too much existing links, only the links to local anchors (like #clusters, #jobs, etc) will be broken, because it is not possible to redirect server-side based on an URL fragment like that. Luckily the generated content ends all in the same HTML page, so the old links will end up in the new top-level index which points to the index for v1.1 API documentation (and later for v2). Not too bad. Change-Id: I9a75e6567798b8d6d3deed8fc66e362ad2d86b5a
254 lines
5.0 KiB
ReStructuredText
254 lines
5.0 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/{project_id}/cluster-templates/{cluster_template_id}
|
|
|
|
Shows details for a cluster template.
|
|
|
|
|
|
Normal response codes: 200
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: url_project_id
|
|
- cluster_template_id: url_cluster_template_id
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: cluster_template_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: object_is_protected
|
|
- shares: object_shares
|
|
- domain_name: domain_name
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: object_is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: cluster_template_id
|
|
- name: cluster_template_name
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/cluster-templates/cluster-templates-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Update cluster templates
|
|
========================
|
|
|
|
.. rest_method:: PUT /v1.1/{project_id}/cluster-templates/{cluster_template_id}
|
|
|
|
Updates a cluster template.
|
|
|
|
Normal response codes:202
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: url_project_id
|
|
- 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: cluster_template_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: object_is_protected
|
|
- shares: object_shares
|
|
- domain_name: domain_name
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: object_is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: cluster_template_id
|
|
- name: cluster_template_name
|
|
|
|
|
|
|
|
|
|
|
|
Delete cluster template
|
|
=======================
|
|
|
|
.. rest_method:: DELETE /v1.1/{project_id}/cluster-templates/{cluster_template_id}
|
|
|
|
Deletes a cluster template.
|
|
|
|
Normal response codes:204
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: url_project_id
|
|
- cluster_template_id: cluster_template_id
|
|
|
|
|
|
|
|
|
|
|
|
|
|
List cluster templates
|
|
======================
|
|
|
|
.. rest_method:: GET /v1.1/{project_id}/cluster-templates
|
|
|
|
Lists available cluster templates.
|
|
|
|
|
|
Normal response codes: 200
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: url_project_id
|
|
- limit: limit
|
|
- marker: marker
|
|
- sort_by: sort_by_cluster_templates
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- markers: markers
|
|
- prev: prev
|
|
- next: next
|
|
- description: cluster_template_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: object_is_protected
|
|
- shares: object_shares
|
|
- domain_name: domain_name
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: object_is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: cluster_template_id
|
|
- name: cluster_template_name
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
.. rest_method:: GET /v1.1/{project_id}/cluster-templates?limit=2
|
|
|
|
.. literalinclude:: samples/cluster-templates/cluster-templates-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Create cluster templates
|
|
========================
|
|
|
|
.. rest_method:: POST /v1.1/{project_id}/cluster-templates
|
|
|
|
Creates a cluster template.
|
|
|
|
Normal response codes:202
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id
|
|
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/cluster-templates/cluster-template-create-request.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: cluster_template_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: object_is_protected
|
|
- shares: object_shares
|
|
- domain_name: domain_name
|
|
- tenant_id: tenant_id
|
|
- node_groups: node_groups
|
|
- is_public: object_is_public
|
|
- hadoop_version: hadoop_version
|
|
- id: cluster_template_id
|
|
- name: cluster_template_name
|
|
|
|
|
|
|
|
|