# ApiHostTemplate Data Model

A host template belongs to a cluster and contains a set of role config groups for slave roles (such as DataNodes and TaskTrackers) from services in the cluster. At most one role config group per role type can be present in a host template. Host templates can be applied to fresh hosts (those with no roles on them) in order to create a role for each of the role groups on each host.

Properties
name | data type | description
--- | --- | ---
name | string | The name of the host template. Unique across clusters.
clusterRef | ApiClusterRef | Readonly. A reference to the cluster the host template belongs to.
roleConfigGroupRefs | array of ApiRoleConfigGroupRef | The role config groups belonging to this host tempalte.

Example

    {
      "name" : "...",
      "clusterRef" : {
        "clusterName" : "...",
        "displayName" : "..."
      },
      "roleConfigGroupRefs" : [ {
        "roleConfigGroupName" : "..."
      }, {
        "roleConfigGroupName" : "..."
      } ]
    }