Helium API

原文链接 : http://zeppelin.apache.org/docs/0.7.2/rest-api/rest-helium.html

译文链接 : http://www.apache.wiki/pages/viewpage.action?pageId=10031086

贡献者 : 片刻 ApacheCN Apache中文网

概观

Apache Zeppelin提供了几个REST API,用于交互和远程激活zeppelin功能。所有REST API都可以从以下端点开始http://[zeppelin-server]:[zeppelin-port]/api。需要注意的是Apache的齐柏林飞艇的REST API接收或返回JSON对象,建议你安装一些JSON观众如JSONView

如果您使用Apache Zeppelin并发现需要一个额外的REST API,请提出问题或向我们发送电子邮件

氦REST API列表

所有可用氦气包的清单

| 描述 | 此GET方法返回已配置注册表中的所有可用氦包。 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/all | | 成功代码 | 200 | | 失败代码 | 500 | | 示例JSON响应 |

  1. {
  2. "status": "OK",
  3. "message": "",
  4. "body": {
  5. "zeppelin.clock": [
  6. {
  7. "registry": "local",
  8. "pkg": {
  9. "type": "APPLICATION",
  10. "name": "zeppelin.clock",
  11. "description": "Clock (example)",
  12. "artifact": "zeppelin-examples\/zeppelin-example-clock\/target\/zeppelin-example-clock-0.7.0-SNAPSHOT.jar",
  13. "className": "org.apache.zeppelin.example.app.clock.Clock",
  14. "resources": [
  15. [
  16. ":java.util.Date"
  17. ]
  18. ],
  19. "icon": "icon"
  20. },
  21. "enabled": false
  22. }
  23. ],
  24. "zeppelin-bubblechart": [
  25. {
  26. "registry": "local",
  27. "pkg": {
  28. "type": "VISUALIZATION",
  29. "name": "zeppelin-bubblechart",
  30. "description": "Animated bubble chart",
  31. "artifact": ".\/..\/helium\/zeppelin-bubble",
  32. "icon": "icon"
  33. },
  34. "enabled": true
  35. },
  36. {
  37. "registry": "local",
  38. "pkg": {
  39. "type": "VISUALIZATION",
  40. "name": "zeppelin-bubblechart",
  41. "description": "Animated bubble chart",
  42. "artifact": "zeppelin-bubblechart@0.0.2",
  43. "icon": "icon"
  44. },
  45. "enabled": false
  46. }
  47. ],
  48. "zeppelin_horizontalbar": [
  49. {
  50. "registry": "local",
  51. "pkg": {
  52. "type": "VISUALIZATION",
  53. "name": "zeppelin_horizontalbar",
  54. "description": "Horizontal Bar chart (example)",
  55. "artifact": ".\/zeppelin-examples\/zeppelin-example-horizontalbar",
  56. "icon": "icon"
  57. },
  58. "enabled": true
  59. }
  60. ]
  61. }
  62. }

|

建议氦气应用

| 描述 | 该GET方法返回段落的建议氦气应用。 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/suggest/[Note ID]/[Paragraph ID] | | 成功代码 | 200 | | 失败代码 | 404注释或段落不存在 500 | | 示例JSON响应 |

  1. {
  2. "status": "OK",
  3. "message": "",
  4. "body": {
  5. "available": [
  6. {
  7. "registry": "local",
  8. "pkg": {
  9. "type": "APPLICATION",
  10. "name": "zeppelin.clock",
  11. "description": "Clock (example)",
  12. "artifact": "zeppelin-examples\/zeppelin-example-clock\/target\/zeppelin-example-clock-0.7.0-SNAPSHOT.jar",
  13. "className": "org.apache.zeppelin.example.app.clock.Clock",
  14. "resources": [
  15. [
  16. ":java.util.Date"
  17. ]
  18. ],
  19. "icon": "icon"
  20. },
  21. "enabled": true
  22. }
  23. ]
  24. }
  25. }

|

在一个段落上加载氦气应用程序

| 描述 | 此GET方法在成功时返回氦应用程序ID。 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/load/[Note ID]/[Paragraph ID] | | 成功代码 | 200 | | 失败代码 | 404的注释或段落不存在 500任何其他错误 | | 示例JSON响应 |

  1. {
  2. "status": "OK",
  3. "message": "",
  4. "body": "app2C5FYRZ1E-20170108-0404492068241472zeppelin_clock"
  5. }

|

加载捆绑的可视化脚本

| 描述 | 此GET方法返回捆绑的氦可视化javascript。当提供refresh = true(可选)时,Zeppelin重建包。否则,从缓存提供 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/visualizations/load[?refresh=true] | | 成功代码 | 200回复体是可执行的javascript | | 失败代码 | 200响应体是错误消息字符串以ERROR开头: |

启用包

| 描述 | 这种POST方法可以实现氦气包装。需要输入有效载荷中的工件名称 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/enable/[Package Name] | | 成功代码 | 200 | | 失败代码 | 500 | | 样品输入 |

  1. 飞艇-实例/飞艇-例如时钟/目标/飞艇-例如时钟-0.7.0-SNAPSHOT.jar

| | 示例JSON响应 |

  1. {"status":"OK"}

|

禁用包

| 描述 | 该POST方法禁用氦气包。 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/disable/[Package Name] | | 成功代码 | 200 | | 失败代码 | 500 | | 示例JSON响应 |

  1. {"status":"OK"}

|

获取可视化显示顺序

| 描述 | 此GET方法返回启用的可视化包的显示顺序。 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/visualizationOrder | | 成功代码 | 200 | | 失败代码 | 500 | | 示例JSON响应 | {“status”:”OK”,”body”:[“zeppelin_horizontalbar”,”zeppelin-bubblechart”]} |

设置可视化显示顺序

| 描述 | 此POST方法设置可视化包显示顺序。 | | 网址 | http://[zeppelin-server]:[zeppelin-port]/api/helium/visualizationOrder | | 成功代码 | 200 | | 失败代码 | 500 | | 示例JSON输入 | [“zeppelin-bubblechart”, “zeppelin_horizontalbar”] | | 示例JSON响应 |

  1. {"status":"OK"}

|