This is the documentation for Cloudera Manager 5.0.0.
Documentation for other versions is available at Cloudera Documentation.

Cloudera Manager API

The Cloudera Manager API provides configuration and service life cycle management, service health information and metrics, and allows you to configure Cloudera Manager itself. The API is served on the same host and port as the Cloudera Manager Admin Console, and does not require an extra process or extra configuration. The API supports HTTP Basic Authentication, accepting the same users and credentials as the Cloudera Manager Admin Console.

Obtaining Configuration Files

  1. Obtain the list of a service's roles:



  2. Obtain the list of configuration files a process is using:


  3. Obtain the content of any particular file:

    For example:


Working with Service Properties and Host Properties

To update a service property using the Cloudera Manager APIs, you'll need to know the name of the property, not just the display name. If you know the property's display name but not the property name itself, retrieve the documentation by requesting any configuration object with the query string view=FULL appended to the URL. For example:


Search the results for the display name of the desired property. For example, a search for the display name "HDFS Service Environment Advanced Configuration Snippet (Safety Valve)" shows that the corresponding property name is hdfs_service_env_safety_valve:

   "name" : "hdfs_service_env_safety_valve",
   "require" : false,
   "displayName" : "HDFS Service Environment Advanced Configuration Snippet (Safety Valve)",
   "description" : "For advanced use onlyu, key/value pairs (one on each line) to be inserted into a roles
   environment. Applies to configurations of all roles in this service except client configuration.",
   "relatedName" : "",
   "validationState" : "OK"
Similar to finding service properties, you can also find host properties with the Cloudera Manager APIs. First, get the host IDs for a cluster with the URL http://cm_server_host:7180/api/v6/hosts:
   "hostId" : "2c2e951c-aaf2-4780-a69f-0382181f1821",
   "ipAddress" : "",
   "hostname" : "cm_server_host",
   "rackId" : "/default",
   "hostUrl" : "http://cm_server_host:7180/cmf/hostRedirect/2c2e951c-adf2-4780-a69f-0382181f1821",
   "maintenanceMode" : false,
   "maintenanceOwners" : [ ],
   "commissionState" : "COMMISSIONED",
   "numCores" : 4,
   "totalPhysMemBytes" : 10371174400
Then obtain the host properties by including one of the returned hostIDs in the URL: http://cm_server_host:7180/api/v5/hosts/2c2e951c-adf2-4780-a69f-0382181f1821?view=FULL
See Using the Cloudera Manager Java API for Cluster Automation for an example of how to access the API using the Java binding.
Here are some additional resources for your exploration: