/cm/deployment

Mount Point: /api/v18/cm/deployment

GET

Retrieve full description of the entire Cloudera Manager deployment including all hosts, clusters, services, roles, users, settings, etc.

This object can be used to reconstruct your entire deployment

Note: Only users with sufficient privileges are allowed to call this.

Note: starting with v3, the deployment information contains data about Cloudera Manager peers configured for the instance. This data contains plain text authentication information used to connect to the remote peer.

Parameters

name description type default
view May be one of "export" (default) or "export_redacted". The latter replaces configurations that are sensitive with the word "REDACTED". query export

Response Body

element: deployment

A complete deployment description

PUT

Apply the supplied deployment description to the system. This will create the clusters, services, hosts and other objects specified in the argument. This call does not allow for any merge conflicts. If an entity already exists in the system, this call will fail. You can request, however, that all entities in the system are deleted before instantiating the new ones.

You may specify a complete or partial deployment, e.g. you can provide host info with no clusters. However, if you request that the current deployment be deleted, you are required to specify at least one admin user or this call will fail. This is to protect you from creating a system that cannot be logged into again.

If there are any errors creating (or optionally deleting) a deployment, all changes will be rolled back leaving the system exactly as it was before calling this method. The system will never be left in a state where part of the deployment is created and other parts are not.

If the submitted deployment contains entities that require Cloudera Enterprise license, then the license should be provided to Cloudera Manager before making this API call.

Parameters

name description type default
deleteCurrentDeployment If true, the current deployment is deleted before the specified deployment is applied query false

Request Body

element: deployment

The deployment to create

Response Body

element: deployment

The system deployment info after successfully applying the given deployment.