Configuration Microservices

Use the CDAP Configuration Microservices to retrieve the version of CDAP and the configurations of CDAP and HBase. Configurations and their settings are described in the Installation instructions.

All methods or endpoints described in this API have a base URL (typically http://<host>:11015 or https://<host>:10443) that precedes the resource identifier, as described in the Microservices Conventions. These methods return a status code, as listed in the Microservices Status Codes.

CDAP Version

To retrieve the version of CDAP, issue an HTTP GET request:

1 GET /v3/version

CDAP Configurations

To retrieve all the configurations used by CDAP, issue an HTTP GET request:

1 GET /v3/config/cdap[?format=<type>]

Parameter

Description

Parameter

Description

type

Optional format for returned type, either json (default) or xml

The response is a string with the property name, its value, and the source of that value, in the specified format. For example, using the default JSON format, the output would be similar to (showing the first portion, reformatted to fit):

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 [ { "name": "log.process.pipeline.logger.cache.expiration.ms", "value": "300000", "source": "cdap-default.xml" }, { "name": "http.service.exec.threads", "value": "20", "source": "cdap-default.xml" }, { "name": "flow.retry.policy.base.delay.ms", "value": "100", "source": "cdap-default.xml" }, { "name": "dashboard.ssl.bind.port", "value": "9443", "source": "cdap-default.xml" }, ... ]

HBase Configurations

To retrieve all the configurations used by HBase, issue an HTTP GET request:

1 GET /v3/config/hbase[?format=<type>]

Parameter

Description

Parameter

Description

type

Optional format for returned type, either json (default) or xml

The response is a string in the specified format. For example, using the XML format, the output would be similar to (showing the first portion, reformatted to fit):

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 <configuration> <property> <name>dfs.journalnode.rpc-address</name> <value>0.0.0.0:8485</value> <source>hdfs-default.xml</source> </property> <property> <name>io.storefile.bloom.block.size</name> <value>131072</value> <source>hbase-default.xml</source> </property> <property> <name>yarn.ipc.rpc.class</name> <value>org.apache.hadoop.yarn.ipc.HadoopYarnProtoRPC</value> <source>yarn-default.xml</source> </property> <property> <name>mapreduce.job.maxtaskfailures.per.tracker</name> <value>3</value> <source>mapred-default.xml</source> </property> <property> <name>hbase.rest.threads.min</name> <value>2</value> <source>hbase-default.xml</source> </property> ... </configuration>