Cloudera Manager API v45

Introduced in Cloudera Manager 7.5.4

Cloudera Product Documentation

Introduction

This document describes the Cloudera Manager REST API. All requests and responses are presented in Javascript Object Notation (JSON).

The API resources listed below follow standard Create-Read-Update-Delete (CRUD) semantics where the HTTP request path defines the entity to be acted on and the HTTP method expresses the type of action to perform.

HTTP Method Operation
POST Create entries
GET Read entries
PUT Update or edit entries
DELETE Delete entries

All collections in the API use plural names, 'users', instead of the singular, 'user'. To address a specific user in the system, expand the URL path to include the user identifier. For example, '/users/foo' identifies user 'foo' and '/users/bar' identifies user 'bar'.

Collection POST (create) GET (read) PUT (update) DELETE (delete)
/users Create a new user List all users in the system Bulk update all users Delete all users
/users/foo error Read information about user 'foo' If user 'foo' exists, update their information; otherwise error. Delete user 'foo'

Keep in mind that not all collections support all operations. For example, events in the system are read-only; you cannot create new events with the API.

You can list the entries in a collection using one of two views: 'summary' or 'full'. The default 'summary' view provides the core information about each entry. The 'full' view is more heavyweight and provides a fully expanded view of each entry. The view is controlled by a query parameter called 'view' e.g. 'GET /users?view=full'.

HTTP requests should set the "Content-Type" header to "application/json" for most calls, unless specified otherwise.

Authentication

The Cloudera Manager API uses HTTP basic access authentication. It accepts the same user credentials as the web interface. Different users may have different levels of access, as defined by their roles. (See the user management API calls for more.) With every authenticated request, the server returns a session cookie, which can be subsequently used for authentication.

Error Code

The API returns HTTP code in the 400s and 500s upon errors:

  • 400 — Invalid request parameters; Malformed requests
  • 401 — Authentication failure
  • 403 — Authorization failure
  • 404 — Object not found
  • 500 — Internal API error
  • 503 — Response temporarily unavailable; caller should retry later

See /tools/echoError for a discussion on the body of an error response.

API Usage Tutorial

Tutorial link

API Version

The API can be queried for the latest version it supports. By making a GET request to the '/version' URL, a string will be returned with the highest supported version (for example, "v2").

Note that servers that only support API v1 do not support this call. In that case, a 404 error will be returned, and can be used to detect that the server only supports v1.

The version should be prepended to the path of the REST resources listed below. The documentation of the different resources lists the version which added the particular functionality.

REST Resources

This API supports a Representational State Transfer (REST) model for accessing a set of resources through a fixed set of operations. The following resources are accessible through the RESTful model:

Resources

You may also enjoy the Swagger UI provided for this API.

name path methods description
ActivitiesResource
  • /clusters/{clusterName}/services/{serviceName}/activities
  • /clusters/{clusterName}/services/{serviceName}/activities/{activityId}
  • /clusters/{clusterName}/services/{serviceName}/activities/{activityId}/children
  • /clusters/{clusterName}/services/{serviceName}/activities/{activityId}/metrics
  • /clusters/{clusterName}/services/{serviceName}/activities/{activityId}/similar
  • GET
  • GET
  • GET
  • GET
  • GET
 
AllHostsResource
  • /cm/allHosts/config
  • GET, PUT
 
AuditsResource
  • /audits
  • /audits/stream
  • GET
  • GET
 
AuthRoleMetadatasResource
  • /authRoleMetadatas
  • GET
Returns a list of the auth roles' metadata for the built-in roles.
AuthRolesResource
  • /authRoles
  • /authRoles/metadata
  • /authRoles/{uuid}
  • GET, POST
  • GET
  • DELETE, GET, PUT
 
AuthServiceResource
  • /cm/authService
  • /cm/authService/autoAssignRoles
  • /cm/authService/autoConfigure
  • /cm/authService/commands
  • /cm/authService/config
  • /cm/authService/roleTypes
  • /cm/authService/commands/enterMaintenanceMode
  • /cm/authService/commands/exitMaintenanceMode
  • /cm/authService/commands/restart
  • /cm/authService/commands/start
  • /cm/authService/commands/stop
  • DELETE, GET, PUT
  • PUT
  • PUT
  • GET
  • GET, PUT
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST

The Authentication Service is used to manage Single Sign On capabilities.

This service is not yet available for general use.

The API to control the Authentication Service is basically the same as the API for the MGMT service. Both are not associated with a cluster and represent CM-managed resources.

AuthServiceRoleCommandsResource
  • /cm/authService/roleCommands/restart
  • /cm/authService/roleCommands/start
  • /cm/authService/roleCommands/stop
  • POST
  • POST
  • POST
 
AuthServiceRoleConfigGroupsResource
  • /cm/authService/roleConfigGroups
  • /cm/authService/roleConfigGroups/{roleConfigGroupName}
  • /cm/authService/roleConfigGroups/{roleConfigGroupName}/config
  • /cm/authService/roleConfigGroups/{roleConfigGroupName}/roles
  • GET
  • GET, PUT
  • GET, PUT
  • GET
 
AuthServiceRolesResource
  • /cm/authService/roles
  • /cm/authService/roles/{roleName}
  • /cm/authService/roles/{roleName}/commands
  • /cm/authService/roles/{roleName}/config
  • /cm/authService/roles/{roleName}/commands/enterMaintenanceMode
  • /cm/authService/roles/{roleName}/commands/exitMaintenanceMode
  • /cm/authService/roles/{roleName}/logs/full
  • /cm/authService/roles/{roleName}/logs/stacks
  • /cm/authService/roles/{roleName}/logs/stacksBundle
  • /cm/authService/roles/{roleName}/logs/stderr
  • /cm/authService/roles/{roleName}/logs/stdout
  • GET, POST
  • DELETE, GET
  • GET
  • GET, PUT
  • POST
  • POST
  • GET
  • GET
  • GET
  • GET
  • GET
 
BatchResource
  • /batch
  • POST
Executes a batch of API requests in one database transaction. If any request fails, execution halts and the transaction is rolled back.
CdpResource
  • /cdp/createEnvironment
  • /cdp/remoteContext
  • /cdp/remoteContext/byCluster/{clusterName}
  • /cdp/remoteContext/byContext/{dataContextName}
  • POST
  • POST
  • GET
  • GET
Root resource for the CDPD Api calls.
CertManagerResource
  • /certs/generateCertificate
  • /certs/truststore
  • /certs/truststorePassword
  • POST
  • GET
  • GET
 
ClouderaManagerResource
  • /cm/commands
  • /cm/config
  • /cm/deployment
  • /cm/importClusterTemplate
  • /cm/instances
  • /cm/kerberosInfo
  • /cm/kerberosPrincipals
  • /cm/krb5conf
  • /cm/license
  • /cm/licensedFeatureUsage
  • /cm/log
  • /cm/retrieveKeytab
  • /cm/scmDbInfo
  • /cm/shutdownReadiness
  • /cm/version
  • /cm/commands/addCustomCerts
  • /cm/commands/clustersPerfInspector
  • /cm/commands/collectDiagnosticData
  • /cm/commands/deleteCredentials
  • /cm/commands/generateCmca
  • /cm/commands/generateCredentials
  • /cm/commands/generateCredentialsAdhoc
  • /cm/commands/hostInstall
  • /cm/commands/hostsDecommission
  • /cm/commands/hostsOfflineOrDecommission
  • /cm/commands/hostsPerfInspector
  • /cm/commands/hostsRecommission
  • /cm/commands/hostsRecommissionAndExitMaintenanceMode
  • /cm/commands/hostsRecommissionWithStart
  • /cm/commands/hostsStartRoles
  • /cm/commands/importAdminCredentials
  • /cm/commands/importKerberosPrincipal
  • /cm/commands/inspectHosts
  • /cm/commands/migrateCmcaToDb
  • /cm/commands/refreshParcelRepos
  • /cm/commands/testExternalAuthentication
  • /cm/instances/{cmServerId}
  • /cm/trial/begin
  • /cm/trial/end
  • GET
  • GET, PUT
  • GET, PUT
  • POST
  • GET
  • GET
  • GET
  • GET
  • GET, POST
  • GET
  • GET
  • POST
  • GET
  • GET
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • GET
  • POST
  • POST
 
ClustersResource
  • /clusters
  • /clusters/{clusterName}
  • /clusters/{clusterName}/autoAssignRoles
  • /clusters/{clusterName}/autoConfigure
  • /clusters/{clusterName}/clientConfig
  • /clusters/{clusterName}/commands
  • /clusters/{clusterName}/dfsServices
  • /clusters/{clusterName}/export
  • /clusters/{clusterName}/getOzoneS3GatewayInfo
  • /clusters/{clusterName}/hosts
  • /clusters/{clusterName}/isTlsEnabled
  • /clusters/{clusterName}/kerberosInfo
  • /clusters/{clusterName}/serviceTypes
  • /clusters/{clusterName}/tags
  • /clusters/{clusterName}/upgradeDomains
  • /clusters/{clusterName}/utilization
  • /clusters/{clusterName}/commands/configureAutoTlsServices
  • /clusters/{clusterName}/commands/configureForKerberos
  • /clusters/{clusterName}/commands/deleteCredentials
  • /clusters/{clusterName}/commands/deployClientConfig
  • /clusters/{clusterName}/commands/deployClientConfigsAndRefresh
  • /clusters/{clusterName}/commands/deployClusterClientConfig
  • /clusters/{clusterName}/commands/disableTls
  • /clusters/{clusterName}/commands/enterMaintenanceMode
  • /clusters/{clusterName}/commands/exitMaintenanceMode
  • /clusters/{clusterName}/commands/expireLogs
  • /clusters/{clusterName}/commands/firstRun
  • /clusters/{clusterName}/commands/inspectHosts
  • /clusters/{clusterName}/commands/perfInspector
  • /clusters/{clusterName}/commands/poolsRefresh
  • /clusters/{clusterName}/commands/postClouderaRuntimeUpgrade
  • /clusters/{clusterName}/commands/preUpgradeCheck
  • /clusters/{clusterName}/commands/refresh
  • /clusters/{clusterName}/commands/restart
  • /clusters/{clusterName}/commands/rollingRestart
  • /clusters/{clusterName}/commands/rollingUpgrade
  • /clusters/{clusterName}/commands/start
  • /clusters/{clusterName}/commands/stop
  • /clusters/{clusterName}/commands/upgradeCdh
  • /clusters/{clusterName}/commands/upgradeServices
  • /clusters/{clusterName}/hosts/{hostId}
  • /clusters/{clusterName}/commands/tearDownWorkload/{workloadClusterName}
  • GET, POST
  • DELETE, GET, PUT
  • PUT
  • PUT
  • GET
  • GET
  • GET
  • GET
  • POST
  • DELETE, GET, POST
  • GET
  • GET
  • GET
  • DELETE, GET, PUT
  • GET
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • DELETE
  • POST
The root of the Cloudera API (v5). Provides access to all sub-resources available in version 5 of the API.
CmPeersResource
  • /cm/peers
  • /cm/peers/{peerName}
  • /cm/peers/{peerName}/commands/test
  • GET, POST
  • DELETE, GET, PUT
  • POST
 
CommandsResource
  • /commands/{commandId}
  • /commands/{commandId}/abort
  • /commands/{commandId}/retry
  • /commands/{commandId}/logs/stderr
  • /commands/{commandId}/logs/stdout
  • GET
  • POST
  • POST
  • GET
  • GET
 
ControlPlanesResource
  • /controlPlanes
  • /controlPlanes/{controlPlaneUuid}
  • /controlPlanes/commands/generateCopyDocker
  • /controlPlanes/commands/generateExternalVaultSetup
  • /controlPlanes/commands/installControlPlane
  • /controlPlanes/commands/installEmbeddedControlPlane
  • /controlPlanes/commands/upgradeEmbeddedControlPlane
  • /controlPlanes/fetchResources/manifest.json
  • /controlPlanes/{controlPlaneUuid}/getExperienceCluster
  • /controlPlanes/fetchResources/{commandId}/logContent
  • /controlPlanes/{controlPlaneUuid}/commands/uninstallControlPlane
  • /controlPlanes/{controlPlaneUuid}/commands/updateControlPlaneValuesYaml
  • /controlPlanes/{controlPlaneUuid}/commands/upgradeControlPlane
  • GET
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • GET
  • POST
  • POST
  • POST
  • POST
 
CspResource
  • /csp/uploadCspCert
  • PUT
Upload CA certificates, client certificates and client key for Credential Storage Provider
DashboardsResource
  • /timeseries/dashboards
  • /timeseries/dashboards/{dashboardName}
  • GET, POST
  • DELETE, GET
 
DataContextsResource
  • /dataContexts
  • /dataContexts/{dataContextName}
  • GET, POST
  • DELETE, GET
 
EventsResource
  • /events
  • /events/{eventId}
  • GET
  • GET
 
ExternalAccountsResource
  • /externalAccounts/create
  • /externalAccounts/supportedCategories
  • /externalAccounts/update
  • /externalAccounts/account/{name}
  • /externalAccounts/accountByDisplayName/{displayName}
  • /externalAccounts/delete/{name}
  • /externalAccounts/supportedTypes/{categoryName}
  • /externalAccounts/type/{typeName}
  • /externalAccounts/account/{name}/config
  • /externalAccounts/typeInfo/{typeName}/commandsByName
  • /externalAccounts/account/{name}/commands/{commandName}
  • POST
  • GET
  • PUT
  • GET
  • GET
  • DELETE
  • GET
  • GET
  • GET, PUT
  • GET
  • POST
Manage external accounts used by various Cloudera Manager features, for performing external tasks.
ExternalUserMappingsResource
  • /externalUserMappings
  • /externalUserMappings/{uuid}
  • GET, POST
  • DELETE, GET, PUT
 
HostTemplatesResource
  • /clusters/{clusterName}/hostTemplates
  • /clusters/{clusterName}/hostTemplates/{hostTemplateName}
  • /clusters/{clusterName}/hostTemplates/{hostTemplateName}/commands/applyHostTemplate
  • GET, POST
  • DELETE, GET, PUT
  • POST
 
HostsResource
  • /hosts
  • /hosts/removeHostsFromCluster
  • /hosts/{hostId}
  • /hosts/{hostId}/components
  • /hosts/{hostId}/config
  • /hosts/{hostId}/metrics
  • /hosts/{hostname}/tags
  • /hosts/{hostId}/commands/enterMaintenanceMode
  • /hosts/{hostId}/commands/exitMaintenanceMode
  • /hosts/{hostId}/commands/generateHostCerts
  • /hosts/{hostId}/commands/migrateRoles
  • /hosts/{hostId}/commands/resetHostId
  • DELETE, GET, POST
  • POST
  • DELETE, GET, PUT
  • GET
  • GET, PUT
  • GET
  • DELETE, GET, PUT
  • POST
  • POST
  • POST
  • POST
  • POST
 
ImpalaQueriesResource
  • /clusters/{clusterName}/services/{serviceName}/impalaQueries
  • /clusters/{clusterName}/services/{serviceName}/impalaQueries/attributes
  • /clusters/{clusterName}/services/{serviceName}/impalaQueries/{queryId}
  • /clusters/{clusterName}/services/{serviceName}/impalaQueries/{queryId}/cancel
  • GET
  • GET
  • GET
  • POST
 
MgmtRoleCommandsResource
  • /cm/service/roleCommands/jmapDump
  • /cm/service/roleCommands/jmapHisto
  • /cm/service/roleCommands/jstack
  • /cm/service/roleCommands/lsof
  • /cm/service/roleCommands/restart
  • /cm/service/roleCommands/start
  • /cm/service/roleCommands/stop
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
 
MgmtRoleConfigGroupsResource
  • /cm/service/roleConfigGroups
  • /cm/service/roleConfigGroups/{roleConfigGroupName}
  • /cm/service/roleConfigGroups/{roleConfigGroupName}/config
  • /cm/service/roleConfigGroups/{roleConfigGroupName}/roles
  • GET
  • GET, PUT
  • GET, PUT
  • GET
 
MgmtRolesResource
  • /cm/service/roles
  • /cm/service/roles/{roleName}
  • /cm/service/roles/{roleName}/commands
  • /cm/service/roles/{roleName}/config
  • /cm/service/roles/{roleName}/commands/enterMaintenanceMode
  • /cm/service/roles/{roleName}/commands/exitMaintenanceMode
  • /cm/service/roles/{roleName}/logs/full
  • /cm/service/roles/{roleName}/logs/stacks
  • /cm/service/roles/{roleName}/logs/stacksBundle
  • /cm/service/roles/{roleName}/logs/stderr
  • /cm/service/roles/{roleName}/logs/stdout
  • GET, POST
  • DELETE, GET
  • GET
  • GET, PUT
  • POST
  • POST
  • GET
  • GET
  • GET
  • GET
  • GET
 
MgmtServiceResource
  • /cm/service
  • /cm/service/autoAssignRoles
  • /cm/service/autoConfigure
  • /cm/service/commands
  • /cm/service/config
  • /cm/service/roleTypes
  • /cm/service/commands/enterMaintenanceMode
  • /cm/service/commands/exitMaintenanceMode
  • /cm/service/commands/restart
  • /cm/service/commands/start
  • /cm/service/commands/stop
  • DELETE, GET, PUT
  • PUT
  • PUT
  • GET
  • GET, PUT
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST
 
NameservicesResource
  • /clusters/{clusterName}/services/{serviceName}/nameservices
  • /clusters/{clusterName}/services/{serviceName}/nameservices/{nameservice}
  • /clusters/{clusterName}/services/{serviceName}/nameservices/{nameservice}/metrics
  • GET
  • GET
  • GET
 
ParcelResource
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/activate
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/cancelDistribution
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/cancelDownload
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/deactivate
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/removeDownload
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/startDistribution
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/startDownload
  • /clusters/{clusterName}/parcels/products/{product}/versions/{version}/commands/startRemovalOfDistribution
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
This interface describes a parcel resource and all the operations that can be performed on it. All the commands in this resource are modeled as follows: When you execute a command, for example startDownload, that command simply starts the download and returns right away. This is why they are labeled as a synchronous commands. In order to see the progress of the command a call to readParcel() needs to be made. This will show the current stage and any progress information if the parcel is in a transition stage. Eg. DOWNLOADING, DISTRIBUTING etc. If the command for some reason could not execute properly, an error is returned to the user as part of the synchronous command. A Parcel goes through many stages during its lifecycle. The various stages and their order is described on in ApiParcel
ParcelsResource
  • /clusters/{clusterName}/parcels
  • /clusters/{clusterName}/parcels/usage
  • GET
  • GET
 
ProcessResource
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/process
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/process/configFiles/{configFileName}
  • GET
  • GET
 
ReplicationsResource
  • /clusters/{clusterName}/services/{serviceName}/replications
  • /clusters/{clusterName}/services/{serviceName}/replications/hbaseReplicationSecurityTool
  • /clusters/{clusterName}/services/{serviceName}/replications/hdfsCopyListing
  • /clusters/{clusterName}/services/{serviceName}/replications/hiveReplicationQuery
  • /clusters/{clusterName}/services/{serviceName}/replications/replicationState
  • /clusters/{clusterName}/services/{serviceName}/replications/rescheduleHive3ReplicationMetricsGetter
  • /clusters/{clusterName}/services/{serviceName}/replications/{scheduleId}
  • /clusters/{clusterName}/services/{serviceName}/replications/{scheduleId}/collectDiagnosticData
  • /clusters/{clusterName}/services/{serviceName}/replications/{scheduleId}/history
  • /clusters/{clusterName}/services/{serviceName}/replications/{scheduleId}/run
  • DELETE, GET, POST
  • POST
  • POST
  • POST
  • GET
  • POST
  • DELETE, GET, PUT
  • POST
  • GET
  • POST
 
RoleCommandsResource
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsBootstrapStandBy
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsEnterSafemode
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsFinalizeMetadataUpgrade
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsFormat
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsInitializeAutoFailover
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsInitializeSharedDir
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsLeaveSafemode
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hdfsSaveNamespace
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/hueSyncDb
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/jmapDump
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/jmapHisto
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/jstack
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/lsof
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/refresh
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/restart
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/start
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/stop
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/zooKeeperCleanup
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/zooKeeperInit
  • /clusters/{clusterName}/services/{serviceName}/roleCommands/{commandName}
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
 
RoleConfigGroupsResource
  • /clusters/{clusterName}/services/{serviceName}/roleConfigGroups
  • /clusters/{clusterName}/services/{serviceName}/roleConfigGroups/roles
  • /clusters/{clusterName}/services/{serviceName}/roleConfigGroups/{roleConfigGroupName}
  • /clusters/{clusterName}/services/{serviceName}/roleConfigGroups/{roleConfigGroupName}/config
  • /clusters/{clusterName}/services/{serviceName}/roleConfigGroups/{roleConfigGroupName}/roles
  • GET, POST
  • PUT
  • DELETE, GET, PUT
  • GET, PUT
  • GET, PUT
 
RolesResource
  • /clusters/{clusterName}/services/{serviceName}/roles
  • /clusters/{clusterName}/services/{serviceName}/roles/bulkDelete
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/commands
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/commandsByName
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/config
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/metrics
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/tags
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/commands/enterMaintenanceMode
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/commands/exitMaintenanceMode
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/commands/impalaDiagnostics
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/logs/full
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/logs/stacks
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/logs/stacksBundle
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/logs/stderr
  • /clusters/{clusterName}/services/{serviceName}/roles/{roleName}/logs/stdout
  • GET, POST
  • POST
  • DELETE, GET
  • GET
  • GET
  • GET, PUT
  • GET
  • DELETE, GET, PUT
  • POST
  • POST
  • POST
  • GET
  • GET
  • GET
  • GET
  • GET
 
ServicesResource
  • /clusters/{clusterName}/services
  • /clusters/{clusterName}/services/{serviceName}
  • /clusters/{clusterName}/services/{serviceName}/clientConfig
  • /clusters/{clusterName}/services/{serviceName}/commands
  • /clusters/{clusterName}/services/{serviceName}/commandsByName
  • /clusters/{clusterName}/services/{serviceName}/config
  • /clusters/{clusterName}/services/{serviceName}/impalaUtilization
  • /clusters/{clusterName}/services/{serviceName}/metrics
  • /clusters/{clusterName}/services/{serviceName}/roleTypes
  • /clusters/{clusterName}/services/{serviceName}/tags
  • /clusters/{clusterName}/services/{serviceName}/yarnUtilization
  • /clusters/{clusterName}/services/{serviceName}/commands/copyHdfsFile
  • /clusters/{clusterName}/services/{serviceName}/commands/createHdfsFile
  • /clusters/{clusterName}/services/{serviceName}/commands/createOozieDb
  • /clusters/{clusterName}/services/{serviceName}/commands/createSolrHdfsHomeDir
  • /clusters/{clusterName}/services/{serviceName}/commands/createSqoopUserDir
  • /clusters/{clusterName}/services/{serviceName}/commands/decommission
  • /clusters/{clusterName}/services/{serviceName}/commands/deployClientConfig
  • /clusters/{clusterName}/services/{serviceName}/commands/disableJtHa
  • /clusters/{clusterName}/services/{serviceName}/commands/disableRmHa
  • /clusters/{clusterName}/services/{serviceName}/commands/disableSentryHa
  • /clusters/{clusterName}/services/{serviceName}/commands/enableJtHa
  • /clusters/{clusterName}/services/{serviceName}/commands/enableRmHa
  • /clusters/{clusterName}/services/{serviceName}/commands/enableSentryHa
  • /clusters/{clusterName}/services/{serviceName}/commands/enterMaintenanceMode
  • /clusters/{clusterName}/services/{serviceName}/commands/exitMaintenanceMode
  • /clusters/{clusterName}/services/{serviceName}/commands/exportSentryPermissions
  • /clusters/{clusterName}/services/{serviceName}/commands/firstRun
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseCreateRoot
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseCreateUserDirectory
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationFirstTimeSetupAutomatic
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationFirstTimeSetupForceReady
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationFirstTimeSetupManual
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationFirstTimeSetupManualContinue
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationFirstTimeSetupReset
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationFirstTimeSetupStatus
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationSetup
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseReplicationSetupAdmin
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseShellCommand
  • /clusters/{clusterName}/services/{serviceName}/commands/hbaseUpgrade
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsCreateTmpDir
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsDisableAutoFailover
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsDisableHa
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsDisableNnHa
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsEnableAutoFailover
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsEnableHa
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsEnableNnHa
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsFailover
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsFinalizeRollingUpgrade
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsRollEdits
  • /clusters/{clusterName}/services/{serviceName}/commands/hdfsUpgradeMetadata
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveCreateHiveUserDir
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveCreateHiveWarehouse
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveCreateHiveWarehouseExternal
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveCreateMetastoreDatabase
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveCreateMetastoreDatabaseTables
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveUpdateMetastoreNamenodes
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveUpgradeMetastore
  • /clusters/{clusterName}/services/{serviceName}/commands/hiveValidateMetastoreSchema
  • /clusters/{clusterName}/services/{serviceName}/commands/hueCreateHiveWarehouse
  • /clusters/{clusterName}/services/{serviceName}/commands/hueDumpDb
  • /clusters/{clusterName}/services/{serviceName}/commands/hueLoadDb
  • /clusters/{clusterName}/services/{serviceName}/commands/hueSyncDb
  • /clusters/{clusterName}/services/{serviceName}/commands/impalaCreateCatalogDatabase
  • /clusters/{clusterName}/services/{serviceName}/commands/impalaCreateCatalogDatabaseTables
  • /clusters/{clusterName}/services/{serviceName}/commands/impalaCreateUserDir
  • /clusters/{clusterName}/services/{serviceName}/commands/impalaDisableLlamaHa
  • /clusters/{clusterName}/services/{serviceName}/commands/impalaDisableLlamaRm
  • /clusters/{clusterName}/services/{serviceName}/commands/impalaEnableLlamaHa
  • /clusters/{clusterName}/services/{serviceName}/commands/impalaEnableLlamaRm
  • /clusters/{clusterName}/services/{serviceName}/commands/importMrConfigsIntoYarn
  • /clusters/{clusterName}/services/{serviceName}/commands/initSolr
  • /clusters/{clusterName}/services/{serviceName}/commands/installMrFrameworkJars
  • /clusters/{clusterName}/services/{serviceName}/commands/installOozieShareLib
  • /clusters/{clusterName}/services/{serviceName}/commands/migrateToSentry
  • /clusters/{clusterName}/services/{serviceName}/commands/offline
  • /clusters/{clusterName}/services/{serviceName}/commands/oozieCreateEmbeddedDatabase
  • /clusters/{clusterName}/services/{serviceName}/commands/oozieDisableHa
  • /clusters/{clusterName}/services/{serviceName}/commands/oozieDumpDatabase
  • /clusters/{clusterName}/services/{serviceName}/commands/oozieEnableHa
  • /clusters/{clusterName}/services/{serviceName}/commands/oozieLoadDatabase
  • /clusters/{clusterName}/services/{serviceName}/commands/oozieUpgradeDb
  • /clusters/{clusterName}/services/{serviceName}/commands/recommission
  • /clusters/{clusterName}/services/{serviceName}/commands/recommissionWithStart
  • /clusters/{clusterName}/services/{serviceName}/commands/restart
  • /clusters/{clusterName}/services/{serviceName}/commands/rollingRestart
  • /clusters/{clusterName}/services/{serviceName}/commands/sentryCreateDatabase
  • /clusters/{clusterName}/services/{serviceName}/commands/sentryCreateDatabaseTables
  • /clusters/{clusterName}/services/{serviceName}/commands/sentryUpgradeDatabaseTables
  • /clusters/{clusterName}/services/{serviceName}/commands/solrBootstrapCollections
  • /clusters/{clusterName}/services/{serviceName}/commands/solrBootstrapConfig
  • /clusters/{clusterName}/services/{serviceName}/commands/solrConfigBackup
  • /clusters/{clusterName}/services/{serviceName}/commands/solrMigrateSentryPrivilegesCommand
  • /clusters/{clusterName}/services/{serviceName}/commands/solrReinitializeStateForUpgrade
  • /clusters/{clusterName}/services/{serviceName}/commands/solrValidateMetadata
  • /clusters/{clusterName}/services/{serviceName}/commands/sqoopCreateDatabaseTables
  • /clusters/{clusterName}/services/{serviceName}/commands/sqoopUpgradeDb
  • /clusters/{clusterName}/services/{serviceName}/commands/start
  • /clusters/{clusterName}/services/{serviceName}/commands/stop
  • /clusters/{clusterName}/services/{serviceName}/commands/switchToMr2
  • /clusters/{clusterName}/services/{serviceName}/commands/yarnApplicationDiagnosticsCollection
  • /clusters/{clusterName}/services/{serviceName}/commands/yarnCreateCmContainerUsageInputDirCommand
  • /clusters/{clusterName}/services/{serviceName}/commands/yarnCreateJobHistoryDirCommand
  • /clusters/{clusterName}/services/{serviceName}/commands/yarnFormatStateStore
  • /clusters/{clusterName}/services/{serviceName}/commands/yarnNodeManagerRemoteAppLogDirCommand
  • /clusters/{clusterName}/services/{serviceName}/commands/zooKeeperCleanup
  • /clusters/{clusterName}/services/{serviceName}/commands/zooKeeperInit
  • /clusters/{clusterName}/services/{serviceName}/commands/{commandName}
  • /clusters/{clusterName}/services/{serviceName}/reports/hdfsUsageReport
  • /clusters/{clusterName}/services/{serviceName}/reports/mrUsageReport
  • GET, POST
  • DELETE, GET, PUT
  • GET
  • GET
  • GET
  • GET, PUT
  • GET
  • GET
  • GET
  • DELETE, GET, PUT
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • GET
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • POST
  • GET
  • GET
 
SnapshotsResource
  • /clusters/{clusterName}/services/{serviceName}/snapshots
  • /clusters/{clusterName}/services/{serviceName}/snapshots/policies
  • /clusters/{clusterName}/services/{serviceName}/snapshots/policies/{policyName}
  • /clusters/{clusterName}/services/{serviceName}/snapshots/policies/{policyName}/history
  • POST
  • GET, POST
  • DELETE, GET, PUT
  • GET
Available since API v6. Only available with Cloudera Manager Enterprise Edition.
TagsResource
  • /tags
  • /tags/{tagName}
  • GET
  • GET
 
TimeSeriesResource
  • /timeseries
  • /timeseries/entityTypeAttributes
  • /timeseries/entityTypes
  • /timeseries/schema
  • GET, POST
  • GET
  • GET
  • GET
 
ToolsResource
  • /tools/echo
  • /tools/echoError
  • GET
  • GET
 
UsersResource
  • /users
  • /users/sessions
  • /users/{userName}
  • /users/expireSessions/{userName}
  • GET, POST
  • GET
  • DELETE, GET, PUT
  • POST
 
WatchedDirResource
  • /clusters/{clusterName}/services/{serviceName}/watcheddir
  • /clusters/{clusterName}/services/{serviceName}/watcheddir/{directoryPath}
  • GET, POST
  • DELETE
 
YarnApplicationsResource
  • /clusters/{clusterName}/services/{serviceName}/yarnApplications
  • /clusters/{clusterName}/services/{serviceName}/yarnApplications/attributes
  • /clusters/{clusterName}/services/{serviceName}/yarnApplications/{applicationId}/kill
  • GET
  • GET
  • POST
 

Data Model

JSON

Default Namespace
type description
ApiActivity Represents a user activity, such as a MapReduce job, a Hive query, an Oozie workflow, etc.
ApiActivityList A generic list.
ApiActivityStatus
ApiActivityType
ApiAddCustomCertsArguments Arguments to add custom certificates to the Auto-TLS certificate database
ApiAdhocHBaseSnapshot An HBase snapshot descriptor.
ApiAdhocSnapshot An adhoc snapshot descriptor.
ApiAudit Models audit events from both CM and CM managed services like HDFS, HBase and Hive. Audits for CM managed services are retrieved from Cloudera Navigator server.
ApiAuditList A generic list.
ApiAuthRole This is the model for user role scope in the API since v18. This is used to support granular permissions.
ApiAuthRoleAuthority This represents an authority with a name and description.
ApiAuthRoleList A list of auth roles.
ApiAuthRoleMetadata This is the model for auth role metadata
ApiAuthRoleMetadataList A list of auth roles metadata.
ApiAuthRoleRef An authRoleRef to operate on ApiAuthRole object
ApiBatchRequest A batch request, comprised of one or more request elements.
ApiBatchRequestElement A single element of a batch request, often part of a list with other elements.
ApiBatchResponse A batch response, comprised of one or more response elements.
ApiBatchResponseElement A single element of a batch response, often part of a list with other elements.
ApiBulkCommandList A list of commands.

This list is returned whenever commands are issued in bulk, and contains a second list with information about errors issuing specific commands.

ApiCdhUpgradeArgs Arguments used for the CDH Upgrade command.
ApiCertificateRequest This API class represents a request to retrieve Auto-TLS certificates for a given host. The request contains the host requesting the certificate, a valid token generated by the certmanager utility, and optionally a certificate signing request. Currently, the certificate signing request argument is not supported.
ApiCluster 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).
ApiClusterList A list of clusters.
ApiClusterNameList A list of cluster names.
ApiClusterPerfInspectorArgs Arguments used for the Cluster Performance Inspector
ApiClusterRef A clusterRef references a cluster. To operate on the cluster object, use the cluster API with the clusterName as the parameter.
ApiClusterTemplate Details of cluster template
ApiClusterTemplateClusterSpec Specify type of cluster to create. If one or more ApiDataContextRef are specified, the created cluster upon import will be a cluster with clusterType "COMPUTE".
ApiClusterTemplateConfig Config Details: The config can either have a value or ref or variable.
ApiClusterTemplateHostInfo This contains information about the host or host range on which provided host template will be applied.
ApiClusterTemplateHostTemplate Host templates will contain information about the role config groups that should be applied to a host. This basically means a host will have a role corresponding to each config group.
ApiClusterTemplateInstantiator Details of cluster template
ApiClusterTemplateRole Role info: This will contain information related to a role referred by some configuration. During import type this role must be materizalized.
ApiClusterTemplateRoleConfigGroup Role config group info.
ApiClusterTemplateRoleConfigGroupInfo During import time information related to all the non-base config groups must be provided.
ApiClusterTemplateService Service information
ApiClusterTemplateVariable Variable that is referred in cluster template.
ApiClusterUtilization Utilization report information of a Cluster.
ApiClusterVersion The CDH version of the cluster.
ApiClustersPerfInspectorArgs Arguments used for the Cloudera Manager level performance inspector. Network diagnostics will be run from every host in sourceCluster to every host in targetCluster.
ApiCmPeer Information about a Cloudera Manager peer instance.

The requirement and usage of username and password properties are dependent on the clouderaManagerCreatedUser flag.

When creating peers, if 'clouderaManagerCreatedUser' is true, the username/password should be the credentials of a user with administrator privileges on the remote Cloudera Manager. These credentials are not stored, they are used to connect to the peer and create a user in that peer. The newly created user is stored and used for communication with that peer. If 'clouderaManagerCreatedUser' is false, which is not applicable to REPLICATION peer type, the username/password to the remote Cloudera Manager are directly stored and used for all communications with that peer.

When updating peers, if 'clouderaManagerCreatedUser' is true and username/password are set, a new remote user will be created. If 'clouderaManagerCreatedUser' is false and username/password are set, the stored username/password will be updated.

If 'createUserWithAdminRole' is true and 'clouderaManagerCreatedUser' is true, the created internal user will also be granted admin role.

ApiCmPeerList A list of Cloudera Manager peers.
ApiCmPeerType Enum for CM peer types.
ApiCmServer This is the model for CM server information from v41. The class models the host environment that CM server is installed. Each CM server instance has an entry of CmServer entity and updates it periodically.
ApiCmServerList A generic list.
ApiCollectDiagnosticDataArguments Arguments used for the collectDiagnosticData command.
ApiCommand Provides detailed information about a submitted command.

There are two types of commands: synchronous and asynchronous. Synchronous commands complete immediately, and their results are passed back in the returned command object after the execution of an API call. Outside of that returned object, there is no way to check the result of a synchronous command.

Asynchronous commands have unique non-negative IDs. They may still be running when the API call returns. Clients can check the status of such commands using the API.

ApiCommandList A list of commands.
ApiCommandMetadata Provides metadata information about a command.
ApiCommandMetadataList A list of command metadata.
ApiCommissionState Represents the Commission state of an entity.
ApiComponentInfo This is the model for a component in the host.
ApiConfig Model for a configuration parameter. When an entry's value property is not available, it means the entry is not configured. This means that the default value for the entry, if any, will be used. Setting a value to null also can be used to unset any previously set value for the parameter, reverting to the default value (if any).
ApiConfigList A list of configuration data.
ApiConfigStalenessStatus Represents the configuration staleness status of an entity.
ApiConfigureForKerberosArguments Arguments used to configure a cluster for Kerberos.
ApiControlPlane A Control Plane in a Cloudera Manager instance
ApiControlPlaneList A list of ApiControlPlanes
ApiCreateEnvironment Arguments used to install CDP a Private Cloud Control Plane
ApiCspArguments Arguments to upload CA certificates, client certificates and client key for CSP
ApiDashboard A dashboard definition. Dashboards are composed of tsquery-based charts.
ApiDashboardList A list of dashboard definitions.
ApiDataContext ApiDataContext is the persistent storage/services context exported by the base cluster to be consumed by the compute cluster.
ApiDataContextList List of ApiDataContext
ApiDataContextRef Reference to an ApiDataContext object. More properties can be added to this object when we support mutable datacontexts, but for MVP datacontexts are immutable.
ApiDeployment 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.
ApiDeployment2 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. This model will be used v18 and beyond since users will be represented by ApiUser2 v18 and beyond.
ApiDisableJtHaArguments Arguments used for disable JT HA command.
ApiDisableLlamaHaArguments Arguments used for disable Llama HA command.
ApiDisableNnHaArguments Arguments used for Disable NameNode High Availability command.
ApiDisableOozieHaArguments
ApiDisableRmHaArguments Arguments used for Disable RM HA command.
ApiDisableSentryHaArgs Arguments used for disable Sentry HA API call.
ApiEcho The echoMessage carries a message to be echoed back from the API service.
ApiEnableJtHaArguments Arguments used for enable JT HA command.
ApiEnableLlamaHaArguments Arguments used for enable Llama HA command.
ApiEnableLlamaRmArguments Arguments used for enable Llama RM command.
ApiEnableNnHaArguments Arguments used for Enable NameNode High Availability command.
ApiEnableOozieHaArguments
ApiEnableRmHaArguments Arguments used for enable RM HA command.
ApiEnableSentryHaArgs Arguments used for enable Sentry HA command.
ApiEndPoint This defines a single logical service in the SDX cluster. A single service can expose one or more URLs. This ApiEndPoint groups the URLs logically for configuration, versioning, or any other service specific reason.
ApiEndPointHost A host endPoint for a service.
ApiEntityStatus The single value used by the Cloudera Manager UI to represent the status of the entity. It is computed from a variety of other entity-specific states, not all values apply to all entities. For example, STARTING/STOPPING do not apply to a host.
ApiEntityTag Tag associated with an Entity in a Cloudera Manager instance
ApiEntityType Represents the types of entities.
ApiEvent Events model noteworthy incidents in Cloudera Manager or the managed Hadoop cluster. An event carries its event category, severity, and a string content. They also have generic attributes, which are free-form key value pairs. Important events may be promoted into alerts.
ApiEventAttribute
ApiEventCategory
ApiEventQueryResult A generic list.
ApiEventSeverity
ApiExternalAccount Represents an instantiation of an external account type, referencing a supported external account type, via the typeName field, along with suitable configuration to access an external resource of the provided type. The typeName field must match the name of an external account type.
ApiExternalAccountCategory Type representing an external account category.
ApiExternalAccountCategoryList Represents a list of external account categories.
ApiExternalAccountList Represents a list of external accounts.
ApiExternalAccountType A supported external account type. An external account type represents an external authentication source that is used by Cloudera Manager in its APIs to take suitable actions that require authentication to an external service. An external account type is uniquely identified by a server-generated ID and identifies with a category identifier: e.g. The "AWS" category has an account type "AWS_Access_Key_Authorization"
ApiExternalAccountTypeList Represents a list of external account types.
ApiExternalUserMapping This is the model for external user mapping information in the API, v19 and beyond. These can be of 4 types : LDAP group, SAML, SAML attribute and External Script.

ApiExternalUserMappingList A list of external user mappings.
ApiExternalUserMappingRef An externalUserMappingRef references an externalUserMapping.
ApiExternalUserMappingType Enum for external user mapping types
ApiGenerateCmcaArguments Arguments to generate a Cloudera Manager Certificate Authority (CMCA).
ApiGenerateCopyDockerArgs Arguments used for the command to generate the docker copy script.
ApiGenerateExternalVaultSetupArgs Arguments used for the command to generate the external vault setup template
ApiGenerateHostCertsArguments Arguments to install certificates on a host
ApiHBaseReplicationArguments Replication arguments for HBase service
ApiHBaseReplicationInfo
ApiHBaseReplicationSecurityTool HBase Replication Security Tool Management
ApiHBaseReplicationSetupCommandArgs Command args for HBaseReplicationSetupCommand
ApiHBaseReplicationSetupStatus Contains status info about the HBase replication first time setup
ApiHBaseShellCommand API request to execute generic hbase shell command The payload (command) is passed as it is to hbase shell, so the caller needs to know the exact syntax of the supported hbase shell command, based on underlying hbase version
ApiHBaseSnapshot An HBase snapshot descriptor.
ApiHBaseSnapshotError A HBase snapshot operation error.
ApiHBaseSnapshotPolicyArguments HBase specific snapshot policy arguments.
ApiHBaseSnapshotResult Detailed information about an HBase snapshot command.
ApiHdfsCloudReplicationArguments Replication arguments for HDFS.
ApiHdfsDisableHaArguments Arguments used for the HDFS disable HA command.
ApiHdfsFailoverArguments Arguments used when enabling HDFS automatic failover.
ApiHdfsHaArguments Arguments used for HDFS HA commands.
ApiHdfsReplicationArguments Replication arguments for HDFS.
ApiHdfsReplicationCounter A counter in an HDFS replication job.
ApiHdfsReplicationResult Detailed information about an HDFS replication job.
ApiHdfsSnapshot An HDFS snapshot descriptor.
ApiHdfsSnapshotError An HDFS snapshot operation error.
ApiHdfsSnapshotPolicyArguments HDFS specific snapshot policy arguments.
ApiHdfsSnapshotResult Detailed information about an HDFS snapshot command.
ApiHdfsUpgradeDomainList A map from HDFS upgrade domains to host names, implemented as a list of ApiMapEntryOfHostNameList objects, where the keys are upgrade domain strings and the values are ApiHostNameList objects.
ApiHdfsUsageReport A generic list.
ApiHdfsUsageReportRow
ApiHealthCheck Represents a result from a health test performed by Cloudera Manager for an entity.
ApiHealthSummary Represents of the high-level health status of a subject in the cluster.
ApiHive3ReplicationArguments Replication Arguments for Hive3 schedules / policies
ApiHive3ReplicationMetric
ApiHive3ReplicationMetricsMetadata
ApiHive3ReplicationMetricsProgress
ApiHive3ReplicationMetricsResultRow
ApiHive3ReplicationMetricsStage
ApiHive3ReplicationMetricsStatus
ApiHive3ReplicationQueryResult A generic list.
ApiHive3ReplicationQueryResultRow
ApiHive3ReplicationScheduledExecutionsResultRow
ApiHive3ReplicationScheduledQueriesResultRow
ApiHiveCloudReplicationArguments Replication arguments for Hive services.
ApiHiveOnTezReplicationResult Detailed information about a Hive replication job.
ApiHiveReplicationArguments Replication arguments for Hive services.
ApiHiveReplicationError A Hive replication error.
ApiHiveReplicationResult Detailed information about a Hive replication job.
ApiHiveTable A Hive table identifier.
ApiHiveUDF An hive UDF identifier.
ApiHost This is the model for a host in the system.
ApiHostCertInfo Associates a hostname with its corresponding certificate and private key
ApiHostInstallArguments Arguments to perform installation on one or more hosts
ApiHostList A list of ApiHost objects
ApiHostNameList A list of host names.
ApiHostRef A reference to a host.
ApiHostRefList A list of host references.
ApiHostTemplate 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.
ApiHostTemplateList A list of host templates.
ApiHostsPerfInspectorArgs Arguments used for the Cloudera Manager level performance inspector. Network diagnostics will be run from every host in sourceHostList to every host in targetHostList.
ApiHostsToRemoveArgs Arguments passed to the remove hosts command, every host passed in has the roles in it deleted and the host is removed from the cluster.
ApiImpalaCancelResponse The response from an Impala cancel query response.
ApiImpalaQuery Represents an Impala Query.
ApiImpalaQueryAttribute Metadata about an Impala query attribute.
ApiImpalaQueryAttributeList The list of all the attributes that are applicable to Impala queries.
ApiImpalaQueryDetailsResponse A query details response.
ApiImpalaQueryResponse The response contains a list of queries and warnings.
ApiImpalaRoleDiagnosticsArgs Arguments used for Rolling Restart commands.
ApiImpalaTenantUtilization Utilization report information of a tenant of Impala application.
ApiImpalaTenantUtilizationList A list of impala tenant utilization reports.
ApiImpalaUDF An impala UDF identifier.
ApiImpalaUtilization Utilization report information of a Impala application service.
ApiImpalaUtilizationHistogram Histogram of Impala utilization.
ApiImpalaUtilizationHistogramBin Histogram bin of Impala utilization.
ApiImpalaUtilizationHistogramBinList A generic list.
ApiInstallControlPlaneArgs Arguments used to install CDP a Private Cloud Control Plane
ApiInstallEmbeddedControlPlaneArgs Arguments used to install a Private Cloud Control Plane on embedded kubernetes
ApiJournalNodeArguments Arguments used as part of ApiEnableNnHaArguments to specify JournalNodes.
ApiKerberosInfo Kerberos information of a Cluster or Cloudera Manager.
ApiLicense Information about the Cloudera Manager license.
ApiLicenseFeature Information about the Cloudera Manager license feature details.
ApiLicensedFeatureUsage Information about the number of nodes using which product features.

Usage information is provided for individual clusters, as well as totals across all clusters.

ApiListBase A generic list.
ApiMapEntry Models a map entry, with a key and a value. By forming a list of these entries you can have the equivalent of Map<String, String> (since JAX-B doesn't support maps).
ApiMapEntryOfHostNameList Similar to ApiMapEntry but the value is an ApiHostNameList.
ApiMetric A metric represents a specific metric monitored by the Cloudera Management Services, and a list of values matching a user query.

These fields are available only in the "full" view:

  • displayName
  • description
ApiMetricData A single data point of metric data.
ApiMetricList A list of ApiMetric objects
ApiMetricSchema A metric schema represents the schema for a specific metric monitored by the Cloudera Management Services.
ApiMetricSchemaList A list of ApiMetricSchema objects
ApiMigrateRolesArguments
ApiMr2AppInformation Represents MapReduce2 information for a YARN application.
ApiMrUsageReport A generic list.
ApiMrUsageReportRow
ApiNameservice Provides information about an HDFS nameservice.

Nameservices can be either a stand-alone NameNode, a NameNode paired with a SecondaryNameNode, or a high-availability pair formed by an active and a stand-by NameNode.

The following fields are only available in the object's full view:

  • healthSummary
  • healthChecks
ApiNameserviceList A list of HDFS nameservices.
ApiOsDistribution Definition of an OS distribution.
ApiOsDistributionType Allowed OS distribution types.
ApiOzoneS3GatewayInfo Encapsulates information needed to utilize the s3 Gateway API- namely, the AWS credentials, the rest url of the s3 Gateway and the S3 bucket.
ApiParcel A Parcel encapsulate a specific product and version. For example, (CDH 4.1). A parcel is downloaded, distributed to all the machines of a cluster and then allowed to be activated.

> The available parcels are determined by which cluster they will be running on. For example, a SLES parcel won't show up for a RHEL cluster.

ApiParcelList A list of ApiParcel.
ApiParcelRef A parcelRef references a parcel. Each parcel is identified by its "parcelName" and "parcelVersion", and the "clusterName" of the cluster that is using it. To operate on the parcel object, use the API with the those fields as parameters.
ApiParcelState The ApiParcelState encapsulates the state of a parcel while it is in transition and reports any errors that may have occurred..

The complete progress of a parcel is broken up into two different reporting indicators - progress and count. Progress is the primary indicator that reports the global state of transitions. For example, when downloading, progress and totalProgress will show the current number of bytes downloaded and the total number of bytes needed to be downloaded respectively.

The count and totalCount indicator is used when a state transition affects multiple hosts. The count and totalCount show the current number of hosts completed and the total number of hosts respectively. For example, during distribution, the progress and totalProgress will show how many bytes have been transferred to each host and the count will indicate how many hosts of of totalCount have had parcels unpacked.

Along with the two progress indicators, the ApiParcelState shows both errors and warnings that may have turned up during a state transition.

ApiParcelUsage This object provides a complete view of the usage of parcels in a given cluster - particularly which parcels are in use for which roles.
ApiParcelUsageHost This object is used to represent a host within an ApiParcelUsage.
ApiParcelUsageParcel This object is used to represent a parcel within an ApiParcelUsage.
ApiParcelUsageRack This object is used to represent a rack within an ApiParcelUsage.
ApiParcelUsageRole This object is used to represent a role within an ApiParcelUsage.
ApiPerfInspectorBandwidthArgs Arguments to run bandwidth diagnostics as part of performance inspector. Requires iperf3 package installed on hosts.
ApiPerfInspectorPingArgs Arguments to run ping test.
ApiPrincipalList A list of kerberos principals.
ApiProcess A process represents a unix process to be managed by the Cloudera Manager agents. A process can be a daemon, e.g. if it is associated with a running role. It can also be a one-off process which is expected to start, run and finish.
ApiProductVersion
ApiRemoteDataContext This object contains enough information for a Workload cluster to connect to an SDX cluster. This object contains no secrets.
ApiRemoteRepoUrl A remote repository URL. Cannot be provided as a path parameter because it may contain special characters.
ApiReplicationCommand Information about a replication command.

This object holds all the information a regular ApiCommand object provides, and adds specific information about the results of a replication command.

Depending on the type of the service where the replication was run, a different result property will be populated.

ApiReplicationCommandList A list of replication commands.
ApiReplicationDiagnosticsCollectionArgs Optional arguments for diagnostics collection.
ApiReplicationSchedule A replication job schedule.

Replication jobs have service-specific arguments. This object has methods to retrieve arguments for all supported types of replication, but only one argument type is allowed to be set; the backend will check that the provided argument matches the service type where the replication is being scheduled.

The replication job's arguments should match the underlying service. Refer to each property's documentation to find out which properties correspond to which services.

ApiReplicationScheduleList A list of replication schedules.
ApiReplicationState The state of Hive/HDFS Replication.
ApiRestartClusterArgs Arguments used for Cluster Restart command. Since V11: If both restartOnlyStaleServices and restartServiceNames are specified, a service must be specified in restartServiceNames and also be stale, in order to be restarted.
ApiRole A role represents a specific entity that participate in a service. Examples are JobTrackers, DataNodes, HBase Masters. Each role is assigned a host where it runs on.
ApiRoleConfigGroup A role config group contains roles of the same role type sharing the same configuration. While each role has to belong to a group, a role config group may be empty. There exists a default role config group for each role type. Default groups cannot be removed nor created. The name of a role config group is unique and cannot be changed. The configuration of individual roles may be overridden on role level.
ApiRoleConfigGroupList A list of role config groups.
ApiRoleConfigGroupRef
ApiRoleList A list of roles.
ApiRoleNameList A list of role names.
ApiRoleRef A roleRef references a role. Each role is identified by its "roleName", the "serviceName" for the service it belongs to, and the "clusterName" in which the service resides. To operate on the role object, use the API with the those fields as parameters.
ApiRoleState Represents the configured run state of a role.
ApiRoleTypeConfig Role type configuration information.
ApiRoleTypeList A list of roles types that exists for a given service.
ApiRolesToInclude Roles to include during a cluster rolling restart.
ApiRollEditsArgs Arguments used for the Roll Edits command.
ApiRollingRestartArgs Arguments used for Rolling Restart commands.
ApiRollingRestartClusterArgs Arguments used for Rolling Restart Cluster command.
ApiRollingUpgradeClusterArgs Rolling upgrade arguments used in the CDH Upgrade Command. Part of ApiCdhUpgradeArgs.
ApiRollingUpgradeServicesArgs Arguments used for Rolling Upgrade command.
ApiSchedule Base class for commands that can be scheduled in Cloudera Manager.

Note that schedule IDs are not preserved upon import.

ApiScheduleInterval Represents the unit for the repeat interval for schedules.
ApiScmDbInfo Cloudera Manager server's database information
ApiService A service (such as HDFS, MapReduce, HBase) runs in a cluster. It has roles, which are the actual entities (NameNode, DataNodes, etc.) that perform the service's functions.

HDFS services and health checks

In CDH4, HDFS services may not present any health checks. This will happen if the service has more than one nameservice configured. In those cases, the health information will be available by fetching information about the nameservices instead.

The health summary is still available, and reflects a service-wide summary.

ApiServiceConfig Service and role type configuration.
ApiServiceList A list of services.
ApiServiceRef A serviceRef references a service. It is identified by the "serviceName", "clusterName" (name of the cluster which the service belongs to) and an optional "peerName" (to reference a remote service i.e. services managed by other CM instances). To operate on the service object, use the API with those fields as parameters.
ApiServiceState Represents the configured run state of a service.
ApiServiceTypeList A list of service types that exists for a given cluster.
ApiShutdownReadiness Cloudera Manager server's shutdown readiness
ApiSimpleRollingRestartClusterArgs Basic arguments used for Rolling Restart Cluster commands.
ApiSnapshotCommand Information about snapshot commands.

This object holds all the information a regular ApiCommand object provides, and adds specific information about the results of a snapshot command.

Depending on the type of the service where the snapshot command was run, a different result property will be populated.

ApiSnapshotCommandList A list of snapshot commands.
ApiSnapshotPolicy A snapshot policy.

Snapshot policies have service specific arguments. This object has methods to retrieve arguments for all supported types of snapshots, but only one argument type is allowed to be set; the backend will check that the provided argument matches the type of the service with which the snapshot policy is associated.

ApiSnapshotPolicyList A list of snapshot policies.
ApiTagToEntities API object which groups types of entities as per the associated tag
ApiTagToEntitiesList A list of ApiTagEntities
ApiTenantUtilization Utilization report information of a tenant.
ApiTenantUtilizationList A list of tenant utilization reports.
ApiTestCmExternalAuthArguments
ApiTimeSeries A time series represents a stream of data points. Each data point contains a time and a value. Time series are returned by executing a tsquery.
ApiTimeSeriesAggregateStatistics Statistics related to one time series aggregate data point. It is available from v6 for data points containing aggregate data. It includes further statistics about the data point. An aggregate can be across entities (e.g., fd_open_across_datanodes), over time (e.g., a daily point for the fd_open metric for a specific DataNode), or both (e.g., a daily point for the fd_open_across_datanodes metric). If the data point is for non-aggregate date this will return null.
ApiTimeSeriesCrossEntityMetadata A class holding additional metadata to the ApiTimeSeriesAggregateStatistics class that applies specifically to cross-entity aggregate metrics.
ApiTimeSeriesData A single data point of time series data.
ApiTimeSeriesEntityAttribute A time series entity attribute represents a possible attribute of a time series entity type monitored by the Cloudera Management Services.

Available since API v11.

ApiTimeSeriesEntityAttributeList A list of ApiTimeSeriesEntityAttribute objects
ApiTimeSeriesEntityType Describe a time series entity type and attributes associated with this entity type.

Available since API v11.

ApiTimeSeriesEntityTypeList A list of ApiTimeSeriesEntityType objects
ApiTimeSeriesMetadata Metadata for a time series.
ApiTimeSeriesRequest Request object containing information needed for querying timeseries data. Available since API v11.
ApiTimeSeriesResponse The time series response for a time series query.
ApiTimeSeriesResponseList A generic list.
ApiUninstallControlPlaneArgs Arguments used to uninstall CDP a Private Cloud Control Plane
ApiUpdateControlPlaneValuesYamlArgs Arguments used to get an existing CDP Private Cloud Control Plane's info
ApiUpgradeControlPlaneArgs Arguments used to upgrade a CDP Private Cloud Control Plane
ApiUpgradeEmbeddedControlPlaneArgs Arguments used to upgrade a Private Cloud Control Plane on embedded kubernetes and the associated experience cluster.
ApiUser This is the model for user information in the API prior to v18. Post v18, please refer to ApiUser2.java.

Note that any method that returns user information will not contain any password information. The password property is only used when creating or updating users.

ApiUser2 This is the model for user information in the API, v18 and beyond.

Note that any method that returns user information will not contain any password information. The password property is only used when creating or updating users.

ApiUser2List A list of users.
ApiUser2Ref A userRef references a user.
ApiUserList A list of users.
ApiUserSession This is the model for interactive user session information in the API.

A user may have more than one active session. Each such session will have its own session object.

ApiUserSessionList A list of user sessions.
ApiVersionInfo Version information of Cloudera Manager itself.
ApiWatchedDir
ApiWatchedDirList A list of watched directories.
ApiYarnApplication Represents a Yarn application
ApiYarnApplicationAttribute Metadata about a YARN application attribute.
ApiYarnApplicationAttributeList The list of all attributes that are applicable to YARN applications.
ApiYarnApplicationDiagnosticsCollectionArgs Arguments used for collecting diagnostics data for Yarn applications
ApiYarnApplicationResponse The response contains a list of applications and warnings.
ApiYarnKillResponse The response from an Yarn kill application response.
ApiYarnTenantUtilization Utilization report information of a tenant of Yarn application.
ApiYarnTenantUtilizationList A list of yarn tenant utilization reports.
ApiYarnUtilization Utilization report information of a Yarn application service.
BaseApiSshCmdArguments Contains common arguments for commands which require SSH'ing into one or more hosts.
HBasePeerState
HBaseTableArgs Holds information for an HBase table.
HTTPMethod
HaStatus
Origin
PerfInspectorPolicyType Enum to pick the type of Performance Inspector Diagnostics to run
PolicyStatus
ReplicationOption This will decide how cloud replication will take place
ReplicationStrategy The strategy for distributing the file replication tasks among the mappers of the MR job associated with a replication.
ReplicationType
ScmDbType Enum for Cloudera Manager DB type. Note that DERBY and SQLITE3 are not supported DBs
ShutdownReadinessState Enum for Cloudera Manager shutdown readiness state.
Status
Storage
StreamingOutput
SubStatus
ValidationState
ZooKeeperServerMode The state of the Zookeeper server.