ApiDeployment Data Model

This objects represents a deployment including all clusters, hosts, services, roles, etc in the system. It can be used to save and restore all settings.

Properties
name data type description
timestamp string Readonly. This timestamp is provided when you request a deployment and is not required (or even read) when creating a deployment. This timestamp is useful if you have multiple deployments saved and want to determine which one to use as a restore point.
clusters array of ApiCluster List of clusters in the system including their services, roles and complete config values.
hosts array of ApiHost List of hosts in the system
users array of ApiUser List of all users in the system
versionInfo ApiVersionInfo Full version information about the running Cloudera Manager instance
managementService ApiService The full configuration of the Cloudera Manager management service including all the management roles and their config values
managerSettings ApiConfigList The full configuration of Cloudera Manager itself including licensing info
allHostsConfig ApiConfigList Configuration parameters that apply to all hosts, unless overridden at the host level. Available since API v3.
peers array of ApiCmPeer The list of peers configured in Cloudera Manager. Available since API v3.
hostTemplates ApiHostTemplateList The list of all host templates in Cloudera Manager.

Example

{
  "timestamp" : "...",
  "clusters" : [ {
    "name" : "...",
    "displayName" : "...",
    "fullVersion" : "...",
    "maintenanceMode" : true,
    "maintenanceOwners" : [ "ROLE", "SERVICE" ],
    "services" : [ {
      "name" : "...",
      "type" : "...",
      "clusterRef" : { },
      "serviceState" : "UNKNOWN",
      "healthSummary" : "HISTORY_NOT_AVAILABLE",
      "configStalenessStatus" : "FRESH",
      "clientConfigStalenessStatus" : "STALE_REFRESHABLE",
      "healthChecks" : [ { }, { } ],
      "serviceUrl" : "...",
      "roleInstancesUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "SERVICE", "SERVICE" ],
      "config" : { },
      "roles" : [ { }, { } ],
      "displayName" : "...",
      "roleConfigGroups" : [ { }, { } ],
      "replicationSchedules" : [ { }, { } ],
      "snapshotPolicies" : [ { }, { } ],
      "entityStatus" : "STARTING"
    }, {
      "name" : "...",
      "type" : "...",
      "clusterRef" : { },
      "serviceState" : "STARTING",
      "healthSummary" : "NOT_AVAILABLE",
      "configStalenessStatus" : "STALE_REFRESHABLE",
      "clientConfigStalenessStatus" : "STALE",
      "healthChecks" : [ { }, { } ],
      "serviceUrl" : "...",
      "roleInstancesUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "HOST", "ROLE" ],
      "config" : { },
      "roles" : [ { }, { } ],
      "displayName" : "...",
      "roleConfigGroups" : [ { }, { } ],
      "replicationSchedules" : [ { }, { } ],
      "snapshotPolicies" : [ { }, { } ],
      "entityStatus" : "UNKNOWN_HEALTH"
    } ],
    "parcels" : [ {
      "product" : "...",
      "version" : "...",
      "stage" : "...",
      "state" : { },
      "clusterRef" : { }
    }, {
      "product" : "...",
      "version" : "...",
      "stage" : "...",
      "state" : { },
      "clusterRef" : { }
    } ],
    "clusterUrl" : "...",
    "hostsUrl" : "...",
    "entityStatus" : "HISTORY_NOT_AVAILABLE",
    "uuid" : "...",
    "dataContextRefs" : [ {
      "name" : "..."
    }, {
      "name" : "..."
    } ],
    "clusterType" : "..."
  }, {
    "name" : "...",
    "displayName" : "...",
    "fullVersion" : "...",
    "maintenanceMode" : true,
    "maintenanceOwners" : [ "SERVICE", "SERVICE" ],
    "services" : [ {
      "name" : "...",
      "type" : "...",
      "clusterRef" : { },
      "serviceState" : "UNKNOWN",
      "healthSummary" : "HISTORY_NOT_AVAILABLE",
      "configStalenessStatus" : "STALE_REFRESHABLE",
      "clientConfigStalenessStatus" : "STALE_REFRESHABLE",
      "healthChecks" : [ { }, { } ],
      "serviceUrl" : "...",
      "roleInstancesUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "SERVICE", "HOST" ],
      "config" : { },
      "roles" : [ { }, { } ],
      "displayName" : "...",
      "roleConfigGroups" : [ { }, { } ],
      "replicationSchedules" : [ { }, { } ],
      "snapshotPolicies" : [ { }, { } ],
      "entityStatus" : "GOOD_HEALTH"
    }, {
      "name" : "...",
      "type" : "...",
      "clusterRef" : { },
      "serviceState" : "NA",
      "healthSummary" : "HISTORY_NOT_AVAILABLE",
      "configStalenessStatus" : "STALE",
      "clientConfigStalenessStatus" : "STALE",
      "healthChecks" : [ { }, { } ],
      "serviceUrl" : "...",
      "roleInstancesUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "SERVICE", "HOST" ],
      "config" : { },
      "roles" : [ { }, { } ],
      "displayName" : "...",
      "roleConfigGroups" : [ { }, { } ],
      "replicationSchedules" : [ { }, { } ],
      "snapshotPolicies" : [ { }, { } ],
      "entityStatus" : "STOPPED"
    } ],
    "parcels" : [ {
      "product" : "...",
      "version" : "...",
      "stage" : "...",
      "state" : { },
      "clusterRef" : { }
    }, {
      "product" : "...",
      "version" : "...",
      "stage" : "...",
      "state" : { },
      "clusterRef" : { }
    } ],
    "clusterUrl" : "...",
    "hostsUrl" : "...",
    "entityStatus" : "DISABLED_HEALTH",
    "uuid" : "...",
    "dataContextRefs" : [ {
      "name" : "..."
    }, {
      "name" : "..."
    } ],
    "clusterType" : "..."
  } ],
  "hosts" : [ {
    "hostId" : "...",
    "ipAddress" : "...",
    "hostname" : "...",
    "rackId" : "...",
    "lastHeartbeat" : "...",
    "roleRefs" : [ {
      "clusterName" : "...",
      "serviceName" : "...",
      "roleName" : "..."
    }, {
      "clusterName" : "...",
      "serviceName" : "...",
      "roleName" : "..."
    } ],
    "healthSummary" : "GOOD",
    "healthChecks" : [ {
      "name" : "...",
      "summary" : "GOOD",
      "explanation" : "...",
      "suppressed" : true
    }, {
      "name" : "...",
      "summary" : "NOT_AVAILABLE",
      "explanation" : "...",
      "suppressed" : true
    } ],
    "hostUrl" : "...",
    "maintenanceMode" : true,
    "commissionState" : "UNKNOWN",
    "maintenanceOwners" : [ "ROLE", "HOST" ],
    "config" : {
      "items" : [ { }, { } ]
    },
    "numCores" : 12345,
    "numPhysicalCores" : 12345,
    "totalPhysMemBytes" : 12345,
    "entityStatus" : "STARTING",
    "clusterRef" : {
      "clusterName" : "...",
      "displayName" : "..."
    }
  }, {
    "hostId" : "...",
    "ipAddress" : "...",
    "hostname" : "...",
    "rackId" : "...",
    "lastHeartbeat" : "...",
    "roleRefs" : [ {
      "clusterName" : "...",
      "serviceName" : "...",
      "roleName" : "..."
    }, {
      "clusterName" : "...",
      "serviceName" : "...",
      "roleName" : "..."
    } ],
    "healthSummary" : "DISABLED",
    "healthChecks" : [ {
      "name" : "...",
      "summary" : "BAD",
      "explanation" : "...",
      "suppressed" : true
    }, {
      "name" : "...",
      "summary" : "DISABLED",
      "explanation" : "...",
      "suppressed" : true
    } ],
    "hostUrl" : "...",
    "maintenanceMode" : true,
    "commissionState" : "OFFLINING",
    "maintenanceOwners" : [ "ROLE", "CLUSTER" ],
    "config" : {
      "items" : [ { }, { } ]
    },
    "numCores" : 12345,
    "numPhysicalCores" : 12345,
    "totalPhysMemBytes" : 12345,
    "entityStatus" : "STARTING",
    "clusterRef" : {
      "clusterName" : "...",
      "displayName" : "..."
    }
  } ],
  "users" : [ {
    "name" : "...",
    "password" : "...",
    "roles" : [ "...", "..." ],
    "pwHash" : "...",
    "pwSalt" : 12345,
    "pwLogin" : true
  }, {
    "name" : "...",
    "password" : "...",
    "roles" : [ "...", "..." ],
    "pwHash" : "...",
    "pwSalt" : 12345,
    "pwLogin" : true
  } ],
  "versionInfo" : {
    "version" : "...",
    "snapshot" : true,
    "buildUser" : "...",
    "buildTimestamp" : "...",
    "gitHash" : "..."
  },
  "managementService" : {
    "name" : "...",
    "type" : "...",
    "clusterRef" : {
      "clusterName" : "...",
      "displayName" : "..."
    },
    "serviceState" : "HISTORY_NOT_AVAILABLE",
    "healthSummary" : "BAD",
    "configStalenessStatus" : "FRESH",
    "clientConfigStalenessStatus" : "STALE",
    "healthChecks" : [ {
      "name" : "...",
      "summary" : "CONCERNING",
      "explanation" : "...",
      "suppressed" : true
    }, {
      "name" : "...",
      "summary" : "HISTORY_NOT_AVAILABLE",
      "explanation" : "...",
      "suppressed" : true
    } ],
    "serviceUrl" : "...",
    "roleInstancesUrl" : "...",
    "maintenanceMode" : true,
    "maintenanceOwners" : [ "CLUSTER", "CLUSTER" ],
    "config" : {
      "roleTypeConfigs" : [ { }, { } ],
      "items" : [ { }, { } ]
    },
    "roles" : [ {
      "name" : "...",
      "type" : "...",
      "hostRef" : { },
      "serviceRef" : { },
      "roleState" : "STOPPED",
      "commissionState" : "DECOMMISSIONING",
      "healthSummary" : "NOT_AVAILABLE",
      "configStalenessStatus" : "STALE_REFRESHABLE",
      "healthChecks" : [ { }, { } ],
      "haStatus" : "ACTIVE",
      "roleUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "ROLE", "ROLE" ],
      "config" : { },
      "roleConfigGroupRef" : { },
      "zooKeeperServerMode" : "STANDALONE",
      "entityStatus" : "UNKNOWN"
    }, {
      "name" : "...",
      "type" : "...",
      "hostRef" : { },
      "serviceRef" : { },
      "roleState" : "BUSY",
      "commissionState" : "OFFLINING",
      "healthSummary" : "HISTORY_NOT_AVAILABLE",
      "configStalenessStatus" : "FRESH",
      "healthChecks" : [ { }, { } ],
      "haStatus" : "STANDBY",
      "roleUrl" : "...",
      "maintenanceMode" : true,
      "maintenanceOwners" : [ "CLUSTER", "HOST" ],
      "config" : { },
      "roleConfigGroupRef" : { },
      "zooKeeperServerMode" : "UNKNOWN",
      "entityStatus" : "STARTING"
    } ],
    "displayName" : "...",
    "roleConfigGroups" : [ {
      "name" : "...",
      "roleType" : "...",
      "base" : true,
      "config" : { },
      "displayName" : "...",
      "serviceRef" : { }
    }, {
      "name" : "...",
      "roleType" : "...",
      "base" : true,
      "config" : { },
      "displayName" : "...",
      "serviceRef" : { }
    } ],
    "replicationSchedules" : [ {
      "hdfsArguments" : { },
      "hiveArguments" : { },
      "hdfsCloudArguments" : { },
      "history" : [ { }, { } ],
      "active" : true,
      "hiveCloudArguments" : { },
      "id" : 12345,
      "displayName" : "...",
      "description" : "...",
      "startTime" : "...",
      "endTime" : "...",
      "interval" : 12345,
      "intervalUnit" : "WEEK",
      "nextRun" : "...",
      "paused" : true,
      "alertOnStart" : true,
      "alertOnSuccess" : true,
      "alertOnFail" : true,
      "alertOnAbort" : true
    }, {
      "hdfsArguments" : { },
      "hiveArguments" : { },
      "hdfsCloudArguments" : { },
      "history" : [ { }, { } ],
      "active" : true,
      "hiveCloudArguments" : { },
      "id" : 12345,
      "displayName" : "...",
      "description" : "...",
      "startTime" : "...",
      "endTime" : "...",
      "interval" : 12345,
      "intervalUnit" : "WEEK",
      "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" : "UNKNOWN"
  },
  "managerSettings" : {
    "items" : [ {
      "name" : "...",
      "value" : "...",
      "required" : true,
      "default" : "...",
      "displayName" : "...",
      "description" : "...",
      "relatedName" : "...",
      "sensitive" : true,
      "validationState" : "OK",
      "validationMessage" : "...",
      "validationWarningsSuppressed" : true
    }, {
      "name" : "...",
      "value" : "...",
      "required" : true,
      "default" : "...",
      "displayName" : "...",
      "description" : "...",
      "relatedName" : "...",
      "sensitive" : true,
      "validationState" : "WARNING",
      "validationMessage" : "...",
      "validationWarningsSuppressed" : true
    } ]
  },
  "allHostsConfig" : {
    "items" : [ {
      "name" : "...",
      "value" : "...",
      "required" : true,
      "default" : "...",
      "displayName" : "...",
      "description" : "...",
      "relatedName" : "...",
      "sensitive" : true,
      "validationState" : "ERROR",
      "validationMessage" : "...",
      "validationWarningsSuppressed" : true
    }, {
      "name" : "...",
      "value" : "...",
      "required" : true,
      "default" : "...",
      "displayName" : "...",
      "description" : "...",
      "relatedName" : "...",
      "sensitive" : true,
      "validationState" : "ERROR",
      "validationMessage" : "...",
      "validationWarningsSuppressed" : true
    } ]
  },
  "peers" : [ {
    "name" : "...",
    "type" : "REPLICATION",
    "url" : "...",
    "username" : "...",
    "password" : "...",
    "clouderaManagerCreatedUser" : true
  }, {
    "name" : "...",
    "type" : "REPLICATION",
    "url" : "...",
    "username" : "...",
    "password" : "...",
    "clouderaManagerCreatedUser" : true
  } ],
  "hostTemplates" : {
    "items" : [ {
      "name" : "...",
      "clusterRef" : { },
      "roleConfigGroupRefs" : [ { }, { } ]
    }, {
      "name" : "...",
      "clusterRef" : { },
      "roleConfigGroupRefs" : [ { }, { } ]
    } ]
  }
}