ApiCluster Data Model

A cluster represents a set of interdependent services running on a set of hosts. All services on a given cluster are of the same software version (e.g. CDH4 or CDH5).

Properties
name data type description
name string The name of the cluster.

Immutable since API v6.

Prior to API v6, will contain the display name of the cluster.

displayName string The display name of the cluster that is shown in the UI.

Available since API v6.

version ApiClusterVersion The CDH version of the cluster.
fullVersion string The full CDH version of the cluster. The expected format is three dot separated version numbers, e.g. "4.2.1" or "5.0.0". The full version takes precedence over the version field during cluster creation.

Available since API v6.

maintenanceMode boolean Readonly. Whether the cluster is in maintenance mode. Available since API v2.
maintenanceOwners array of ApiEntityType Readonly. The list of objects that trigger this cluster to be in maintenance mode. Available since API v2.
services array of ApiService Optional. Used during import/export of settings.
parcels array of ApiParcel Optional. Used during import/export of settings. Available since API v4.
clusterUrl string Readonly. Link into the Cloudera Manager web UI for this specific cluster.

Available since API v10.

hostsUrl string Readonly. Link into the Cloudera Manager web UI for host table for this cluster.

Available since API v11.

entityStatus ApiEntityStatus Readonly. The entity status for this cluster. Available since API v11.
uuid string Readonly. The UUID of the cluster.

Available since API v15.

dataContextRefs array of ApiDataContextRef
clusterType string The type of cluster. If unspecified, defaults to either BASE_CLUSTER (if no data contexts are provided) or COMPUTE_CLUSTER (if one or more data contexts are provided). Available since APIv32.
tags array of ApiEntityTag Tags associated with the cluster. Available since V41.

Example

{
  "name" : "...",
  "displayName" : "...",
  "fullVersion" : "...",
  "maintenanceMode" : true,
  "maintenanceOwners" : [ "SERVICE", "CLUSTER" ],
  "services" : [ {
    "name" : "...",
    "type" : "...",
    "clusterRef" : {
      "clusterName" : "...",
      "displayName" : "..."
    },
    "serviceState" : "UNKNOWN",
    "healthSummary" : "BAD",
    "configStalenessStatus" : "STALE",
    "clientConfigStalenessStatus" : "STALE_REFRESHABLE",
    "healthChecks" : [ {
      "name" : "...",
      "summary" : "HISTORY_NOT_AVAILABLE",
      "explanation" : "...",
      "suppressed" : true
    }, {
      "name" : "...",
      "summary" : "HISTORY_NOT_AVAILABLE",
      "explanation" : "...",
      "suppressed" : true
    } ],
    "serviceUrl" : "...",
    "roleInstancesUrl" : "...",
    "maintenanceMode" : true,
    "maintenanceOwners" : [ "HOST", "ROLE" ],
    "config" : {
      "roleTypeConfigs" : [ { }, { } ],
      "items" : [ { }, { } ]
    },
    "roles" : [ {
      "name" : "...",
      "type" : "...",
      "hostRef" : { },
      "serviceRef" : { },
      "roleState" : "HISTORY_NOT_AVAILABLE",
      "commissionState" : "OFFLINED",
      "healthSummary" : "DISABLED",
      "configStalenessStatus" : "STALE_REFRESHABLE",
      "healthChecks" : [ { }, { } ],
      "haStatus" : "STANDBY",
      "roleUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "SERVICE", "CLUSTER" ],
      "config" : { },
      "roleConfigGroupRef" : { },
      "zooKeeperServerMode" : "REPLICATED_LEADER_ELECTION",
      "entityStatus" : "DOWN",
      "tags" : [ { }, { } ]
    }, {
      "name" : "...",
      "type" : "...",
      "hostRef" : { },
      "serviceRef" : { },
      "roleState" : "STOPPING",
      "commissionState" : "UNKNOWN",
      "healthSummary" : "DISABLED",
      "configStalenessStatus" : "STALE_REFRESHABLE",
      "healthChecks" : [ { }, { } ],
      "haStatus" : "STANDBY",
      "roleUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "CLUSTER", "ROLE" ],
      "config" : { },
      "roleConfigGroupRef" : { },
      "zooKeeperServerMode" : "REPLICATED_OBSERVER",
      "entityStatus" : "HISTORY_NOT_AVAILABLE",
      "tags" : [ { }, { } ]
    } ],
    "displayName" : "...",
    "roleConfigGroups" : [ {
      "name" : "...",
      "roleType" : "...",
      "base" : true,
      "config" : { },
      "displayName" : "...",
      "serviceRef" : { }
    }, {
      "name" : "...",
      "roleType" : "...",
      "base" : true,
      "config" : { },
      "displayName" : "...",
      "serviceRef" : { }
    } ],
    "replicationSchedules" : [ {
      "hdfsArguments" : { },
      "hiveArguments" : { },
      "hdfsCloudArguments" : { },
      "ozoneReplicationArguments" : { },
      "history" : [ { }, { } ],
      "active" : true,
      "hiveCloudArguments" : { },
      "hbaseArguments" : { },
      "hive3Arguments" : { },
      "rangerArguments" : { },
      "id" : 12345,
      "displayName" : "...",
      "description" : "...",
      "startTime" : "...",
      "endTime" : "...",
      "interval" : 12345,
      "intervalUnit" : "WEEK",
      "nextRun" : "...",
      "paused" : true,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true
    }, {
      "hdfsArguments" : { },
      "hiveArguments" : { },
      "hdfsCloudArguments" : { },
      "ozoneReplicationArguments" : { },
      "history" : [ { }, { } ],
      "active" : true,
      "hiveCloudArguments" : { },
      "hbaseArguments" : { },
      "hive3Arguments" : { },
      "rangerArguments" : { },
      "id" : 12345,
      "displayName" : "...",
      "description" : "...",
      "startTime" : "...",
      "endTime" : "...",
      "interval" : 12345,
      "intervalUnit" : "MONTH",
      "nextRun" : "...",
      "paused" : true,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true
    } ],
    "snapshotPolicies" : [ {
      "name" : "...",
      "description" : "...",
      "hourlySnapshots" : 12345,
      "dailySnapshots" : 12345,
      "weeklySnapshots" : 12345,
      "monthlySnapshots" : 12345,
      "yearlySnapshots" : 12345,
      "minuteOfHour" : 12345,
      "hoursForHourlySnapshots" : [ 12345, 12345 ],
      "hourOfDay" : 12345,
      "dayOfWeek" : 12345,
      "dayOfMonth" : 12345,
      "monthOfYear" : 12345,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true,
      "hbaseArguments" : { },
      "hdfsArguments" : { },
      "lastCommand" : { },
      "lastSuccessfulCommand" : { },
      "paused" : true
    }, {
      "name" : "...",
      "description" : "...",
      "hourlySnapshots" : 12345,
      "dailySnapshots" : 12345,
      "weeklySnapshots" : 12345,
      "monthlySnapshots" : 12345,
      "yearlySnapshots" : 12345,
      "minuteOfHour" : 12345,
      "hoursForHourlySnapshots" : [ 12345, 12345 ],
      "hourOfDay" : 12345,
      "dayOfWeek" : 12345,
      "dayOfMonth" : 12345,
      "monthOfYear" : 12345,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true,
      "hbaseArguments" : { },
      "hdfsArguments" : { },
      "lastCommand" : { },
      "lastSuccessfulCommand" : { },
      "paused" : true
    } ],
    "entityStatus" : "STOPPING",
    "tags" : [ {
      "name" : "...",
      "value" : "..."
    }, {
      "name" : "...",
      "value" : "..."
    } ],
    "serviceVersion" : "..."
  }, {
    "name" : "...",
    "type" : "...",
    "clusterRef" : {
      "clusterName" : "...",
      "displayName" : "..."
    },
    "serviceState" : "UNKNOWN",
    "healthSummary" : "GOOD",
    "configStalenessStatus" : "STALE_REFRESHABLE",
    "clientConfigStalenessStatus" : "FRESH",
    "healthChecks" : [ {
      "name" : "...",
      "summary" : "CONCERNING",
      "explanation" : "...",
      "suppressed" : true
    }, {
      "name" : "...",
      "summary" : "BAD",
      "explanation" : "...",
      "suppressed" : true
    } ],
    "serviceUrl" : "...",
    "roleInstancesUrl" : "...",
    "maintenanceMode" : true,
    "maintenanceOwners" : [ "HOST", "CLUSTER" ],
    "config" : {
      "roleTypeConfigs" : [ { }, { } ],
      "items" : [ { }, { } ]
    },
    "roles" : [ {
      "name" : "...",
      "type" : "...",
      "hostRef" : { },
      "serviceRef" : { },
      "roleState" : "STARTED",
      "commissionState" : "UNKNOWN",
      "healthSummary" : "GOOD",
      "configStalenessStatus" : "STALE_REFRESHABLE",
      "healthChecks" : [ { }, { } ],
      "haStatus" : "STANDBY",
      "roleUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "CONTROL_PLANE", "CONTROL_PLANE" ],
      "config" : { },
      "roleConfigGroupRef" : { },
      "zooKeeperServerMode" : "UNKNOWN",
      "entityStatus" : "NONE",
      "tags" : [ { }, { } ]
    }, {
      "name" : "...",
      "type" : "...",
      "hostRef" : { },
      "serviceRef" : { },
      "roleState" : "STARTING",
      "commissionState" : "OFFLINED",
      "healthSummary" : "DISABLED",
      "configStalenessStatus" : "STALE_REFRESHABLE",
      "healthChecks" : [ { }, { } ],
      "haStatus" : "ACTIVE",
      "roleUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "ROLE", "HOST" ],
      "config" : { },
      "roleConfigGroupRef" : { },
      "zooKeeperServerMode" : "STANDALONE",
      "entityStatus" : "UNKNOWN_HEALTH",
      "tags" : [ { }, { } ]
    } ],
    "displayName" : "...",
    "roleConfigGroups" : [ {
      "name" : "...",
      "roleType" : "...",
      "base" : true,
      "config" : { },
      "displayName" : "...",
      "serviceRef" : { }
    }, {
      "name" : "...",
      "roleType" : "...",
      "base" : true,
      "config" : { },
      "displayName" : "...",
      "serviceRef" : { }
    } ],
    "replicationSchedules" : [ {
      "hdfsArguments" : { },
      "hiveArguments" : { },
      "hdfsCloudArguments" : { },
      "ozoneReplicationArguments" : { },
      "history" : [ { }, { } ],
      "active" : true,
      "hiveCloudArguments" : { },
      "hbaseArguments" : { },
      "hive3Arguments" : { },
      "rangerArguments" : { },
      "id" : 12345,
      "displayName" : "...",
      "description" : "...",
      "startTime" : "...",
      "endTime" : "...",
      "interval" : 12345,
      "intervalUnit" : "DAY",
      "nextRun" : "...",
      "paused" : true,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true
    }, {
      "hdfsArguments" : { },
      "hiveArguments" : { },
      "hdfsCloudArguments" : { },
      "ozoneReplicationArguments" : { },
      "history" : [ { }, { } ],
      "active" : true,
      "hiveCloudArguments" : { },
      "hbaseArguments" : { },
      "hive3Arguments" : { },
      "rangerArguments" : { },
      "id" : 12345,
      "displayName" : "...",
      "description" : "...",
      "startTime" : "...",
      "endTime" : "...",
      "interval" : 12345,
      "intervalUnit" : "MONTH",
      "nextRun" : "...",
      "paused" : true,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true
    } ],
    "snapshotPolicies" : [ {
      "name" : "...",
      "description" : "...",
      "hourlySnapshots" : 12345,
      "dailySnapshots" : 12345,
      "weeklySnapshots" : 12345,
      "monthlySnapshots" : 12345,
      "yearlySnapshots" : 12345,
      "minuteOfHour" : 12345,
      "hoursForHourlySnapshots" : [ 12345, 12345 ],
      "hourOfDay" : 12345,
      "dayOfWeek" : 12345,
      "dayOfMonth" : 12345,
      "monthOfYear" : 12345,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true,
      "hbaseArguments" : { },
      "hdfsArguments" : { },
      "lastCommand" : { },
      "lastSuccessfulCommand" : { },
      "paused" : true
    }, {
      "name" : "...",
      "description" : "...",
      "hourlySnapshots" : 12345,
      "dailySnapshots" : 12345,
      "weeklySnapshots" : 12345,
      "monthlySnapshots" : 12345,
      "yearlySnapshots" : 12345,
      "minuteOfHour" : 12345,
      "hoursForHourlySnapshots" : [ 12345, 12345 ],
      "hourOfDay" : 12345,
      "dayOfWeek" : 12345,
      "dayOfMonth" : 12345,
      "monthOfYear" : 12345,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true,
      "hbaseArguments" : { },
      "hdfsArguments" : { },
      "lastCommand" : { },
      "lastSuccessfulCommand" : { },
      "paused" : true
    } ],
    "entityStatus" : "HISTORY_NOT_AVAILABLE",
    "tags" : [ {
      "name" : "...",
      "value" : "..."
    }, {
      "name" : "...",
      "value" : "..."
    } ],
    "serviceVersion" : "..."
  } ],
  "parcels" : [ {
    "product" : "...",
    "version" : "...",
    "stage" : "...",
    "state" : {
      "progress" : 12345,
      "totalProgress" : 12345,
      "count" : 12345,
      "totalCount" : 12345,
      "errors" : [ "...", "..." ],
      "warnings" : [ "...", "..." ]
    },
    "clusterRef" : {
      "clusterName" : "...",
      "displayName" : "..."
    },
    "displayName" : "...",
    "description" : "..."
  }, {
    "product" : "...",
    "version" : "...",
    "stage" : "...",
    "state" : {
      "progress" : 12345,
      "totalProgress" : 12345,
      "count" : 12345,
      "totalCount" : 12345,
      "errors" : [ "...", "..." ],
      "warnings" : [ "...", "..." ]
    },
    "clusterRef" : {
      "clusterName" : "...",
      "displayName" : "..."
    },
    "displayName" : "...",
    "description" : "..."
  } ],
  "clusterUrl" : "...",
  "hostsUrl" : "...",
  "entityStatus" : "BAD_HEALTH",
  "uuid" : "...",
  "dataContextRefs" : [ {
    "name" : "..."
  }, {
    "name" : "..."
  } ],
  "clusterType" : "...",
  "tags" : [ {
    "name" : "...",
    "value" : "..."
  }, {
    "name" : "...",
    "value" : "..."
  } ]
}