The following example shows creating an instance of the Files View, name FILES, version view called "MyFiles".

Transcription

1 View API This section describes basic usage of the View REST API. Browse for detailed usage information and examples. Get List of Deployed Views Creating a View Instance: Files View Creating a View Instance: Capacity Scheduler View Get List of Deployed Views 1. Gets the list of all deployed views GET /api/v1/views Once you have a list of views, you can drill-into a view and see the available versions. GET /api/v1/views/files 3. You can go a level deeper and see more information about that specific version for the view, such as the parameters and the archive name, and a list of all instances of the view for that specific view version. GET /api/v1/views/files/versions/0.1.0 Creating a View Instance: Files View The following example shows creating an instance of the Files View, name FILES, version view called "MyFiles". 1. Create the view instance. POST /api/v1/views/files/versions/0.1.0/instances/myfiles [ "ViewInstanceInfo" : "properties" : "dataworker.defaultfs" : "webhdfs://your.namenode.host:50070" ] CREATED When creating your view instance, be sure to provide all view instance properties, otherwise you will receive a 500 required with a message explaining the properties that are required. Restart Ambari Server to pick-up the view instance and UI resources.

2 ambari-server restart 3. Confirm the newly created view instance is available. GET /api/v1/views/files/versions/0.1.0 " "ViewVersionInfo" : "archive" : "/var/lib/ambari-server/resources/views/work/files0.1.0", "label" : "Files", "masker_class" : null, "parameters" : [ "name" : "dataworker.defaultfs", "description" : "FileSystem URI",, "name" : "dataworker.username", "description" : "The username (defaults to ViewContext username)", "required" : false, ], "view_name" : "FILES", "permissions" : [ ], "instances" : [ " MyFiles", "ViewInstanceInfo" : "instance_name" : "MyFiles", "view_name" : "FILES" ] 4. Browse to the view instance directly. or

3 Creating a View Instance: Capacity Scheduler View The following example shows creating an instance of the Capacity Scheduler View, name CAPACITY-SCHEDULER, version view called "CS_1", using the label "Capacity Scheduler". 1. Create the view instance. POST /api/v1/views/capacity-scheduler/versions/0.1.0/instances/cs_1 [ "ViewInstanceInfo" : "label" : "Capacity Scheduler", "properties" : "ambari.server.url" : " "ambari.server.username" : "admin", "ambari.server.password" : "admin" ] CREATED When creating your view instance, be sure to provide all view instance properties, otherwise you will receive a 500 required with a message explaining the properties that are required. Restart Ambari Server to pick-up the view instance and UI resources. ambari-server restart 3. Confirm the newly created view instance is available.

4 GET /api/v1/views/capacity-scheduler/versions/0.1.0 " "ViewVersionInfo" : "archive" : "/var/lib/ambari-server/resources/views/work/capacity-scheduler0.1.0", "label" : "Capacity Scheduler", "masker_class" : null, "parameters" : [ "name" : "ambari.server.url", "description" : "Target Ambari Server REST API cluster URL (for example: "name" : "ambari.server.username", "description" : "Target Ambari administrator username (for example: admin)",, "name" : "ambari.server.password", "description" : "Target Ambari administrator password (for example: admin)", ], "view_name" : "CAPACITY-SCHEDULER", "permissions" : [ ], "instances" : [ " "ViewInstanceInfo" : "instance_name" : "CS_1", "view_name" : "CAPACITY-SCHEDULER" ] 4. Browse to the view instance directly.

5 or