功能描述

查询业务下的单个模板详情

请求参数

通用参数

字段 类型 必选 描述
bk_app_code string 应用ID
bk_app_secret string 安全密钥(应用 TOKEN),可以通过 蓝鲸智云开发者中心 -> 点击应用ID -> 基本信息 获取
bk_token string 当前用户登录态,bk_token与bk_username必须一个有效,bk_token可以通过Cookie获取
bk_username string 当前用户用户名,应用免登录态验证白名单中的应用,用此字段指定当前用户

接口参数

字段 类型 必选 描述
bk_biz_id string 模板所属业务ID
template_id string 模板ID
template_source string 流程模板来源,business:默认值,业务流程,common:公共流程
scope string bk_biz_id 检索的作用域。默认为 cmdb_biz,此时检索的是绑定的 CMDB 业务 ID 为 bk_biz_id 的项目;当值为 project 时则检索项目 ID 为 bk_biz_id 的项目

请求参数示例

  1. {
  2. "bk_app_code": "esb_test",
  3. "bk_app_secret": "xxx",
  4. "bk_token": "xxx",
  5. "bk_biz_id": "1",
  6. "template_id": "30",
  7. "template_source": "business"
  8. }

返回结果示例

  1. {
  2. "result": true,
  3. "data": {
  4. "category": "Other",
  5. "edit_time": "2018-04-27 16:24:24 +0800",
  6. "create_time": "2018-04-16 21:43:15 +0800",
  7. "name": "new20180416213944",
  8. "bk_biz_id": "2",
  9. "creator": "admin",
  10. "pipeline_tree": {
  11. "activities": {
  12. "631b6576cc5dfbdcaa4f510ce88a7e67": {
  13. "outgoing": "44ab36ebf4cf119edaf2d20401da87e4",
  14. "incoming": "fb2f3a8b533ca5c67e2440b4164f7632",
  15. "name": "节点_1",
  16. "error_ignorable": false,
  17. "component": {
  18. "code": "job_fast_execute_script",
  19. "data": {
  20. "account": {
  21. "hook": false,
  22. "value": "root"
  23. },
  24. "ip_list": {
  25. "hook": false,
  26. "value": "127.0.0.1"
  27. },
  28. "script_timeout": {
  29. "hook": true,
  30. "value": "${script_timeout}"
  31. },
  32. "content": {
  33. "hook": false,
  34. "value": "${content}"
  35. },
  36. "script_param": {
  37. "hook": false,
  38. "value": "${params}"
  39. },
  40. "script_type": {
  41. "hook": true,
  42. "value": "${script_type}"
  43. }
  44. }
  45. },
  46. "optional": false,
  47. "type": "ServiceActivity",
  48. "id": "631b6576cc5dfbdcaa4f510ce88a7e67",
  49. "loop": null
  50. }
  51. },
  52. "end_event": {
  53. "type": "EmptyEndEvent",
  54. "outgoing": "",
  55. "incoming": "44ab36ebf4cf119edaf2d20401da87e4",
  56. "id": "60c81e383d048d8a3c574d3436e1b82c",
  57. "name": ""
  58. },
  59. "outputs": [],
  60. "flows": {
  61. "fb2f3a8b533ca5c67e2440b4164f7632": {
  62. "is_default": false,
  63. "source": "48afea1016ab70ee37179fa0eb1e1a14",
  64. "id": "fb2f3a8b533ca5c67e2440b4164f7632",
  65. "target": "631b6576cc5dfbdcaa4f510ce88a7e67"
  66. },
  67. "44ab36ebf4cf119edaf2d20401da87e4": {
  68. "is_default": false,
  69. "source": "631b6576cc5dfbdcaa4f510ce88a7e67",
  70. "id": "44ab36ebf4cf119edaf2d20401da87e4",
  71. "target": "60c81e383d048d8a3c574d3436e1b82c"
  72. }
  73. },
  74. "start_event": {
  75. "type": "EmptyStartEvent",
  76. "outgoing": "fb2f3a8b533ca5c67e2440b4164f7632",
  77. "incoming": "",
  78. "id": "48afea1016ab70ee37179fa0eb1e1a14",
  79. "name": ""
  80. },
  81. "constants": {
  82. "${script_type}": {
  83. "source_tag": "job_fast_execute_script.script_type",
  84. "source_info": {
  85. "631b6576cc5dfbdcaa4f510ce88a7e67": [
  86. "script_type"
  87. ]
  88. },
  89. "name": "脚本类型",
  90. "index": 0,
  91. "custom_type": "radio",
  92. "value": "4",
  93. "show_type": "show",
  94. "source_type": "component_inputs",
  95. "key": "${script_type}",
  96. "validation": "^.*$",
  97. "desc": ""
  98. },
  99. "${content}": {
  100. "source_tag": "",
  101. "source_info": {},
  102. "name": "内容",
  103. "index": 2,
  104. "custom_type": "textarea",
  105. "value": "",
  106. "show_type": "show",
  107. "source_type": "custom",
  108. "key": "${content}",
  109. "desc": ""
  110. },
  111. "${script_timeout}": {
  112. "source_tag": "job_fast_execute_script.script_timeout",
  113. "source_info": {
  114. "631b6576cc5dfbdcaa4f510ce88a7e67": [
  115. "script_timeout"
  116. ]
  117. },
  118. "name": "超时时间",
  119. "index": 1,
  120. "custom_type": "input",
  121. "value": "",
  122. "show_type": "show",
  123. "source_type": "component_inputs",
  124. "key": "${script_timeout}",
  125. "validation": "^.*$",
  126. "desc": ""
  127. },
  128. "${params}": {
  129. "source_tag": "",
  130. "source_info": {},
  131. "name": "参数",
  132. "index": 3,
  133. "custom_type": "input",
  134. "value": "",
  135. "show_type": "show",
  136. "source_type": "custom",
  137. "key": "${params}",
  138. "desc": ""
  139. }
  140. },
  141. "gateways": {}
  142. },
  143. "bk_biz_name": "蓝鲸",
  144. "id": 30,
  145. "editor": "admin"
  146. },
  147. }

返回结果参数说明

字段 类型 描述
result bool true/false 查询成功与否
data dict result=true 时模板详情,详细信息见下面说明
message string result=false 时错误信息

data

字段 类型 描述
bk_biz_id string 模板所属业务ID
bk_biz_name string 模板所属业务名称
id int 模板ID
name string 模板名称
category string 模板分类,分类信息见下面说明
creator string 模板创建人
create_time string 模板创建时间
editor string 或者 null 模板编辑人
edit_time string 模板最新编辑时间
pipeline_tree dict 模板任务树信息,详细信息见下面说明

data.category

返回值 描述
OpsTools 运维工具
MonitorAlarm 监控告警
ConfManage 配置管理
DevTools 开发工具
EnterpriseIT 企业IT
OfficeApp 办公应用
Other 其它

data.pipeline_tree

字段 类型 描述
start_event dict 开始节点信息
end_event dict 结束节点信息
activities dict 任务节点(标准插件和子流程)信息
gateways dict 网关节点(并行网关、分支网关和汇聚网关)信息
flows dict 顺序流(节点连线)信息
constants dict 全局变量信息,详情见下面
outputs list 模板输出信息,标记 constants 中的输出字段

data.pipeline_tree.constants KEY

全局变量 KEY,${key} 格式

data.pipeline_tree.constants VALUE

字段 类型 描述
key string 同 KEY
name string 变量名字
index int 变量在模板中的显示顺序
desc string 变量说明
source_type string 变量来源, 取值范围 custom: 自定义变量,component_inputs: 从标准插件输入参数勾选,component_outputs:从标准插件输出结果中勾选
custom_type string source_type=custom 时有效,自定义变量类型, 取值范围 input: 输入框,textarea: 文本框,datetime: 日期时间,int: 整数
source_tag string source_type=component_inputs或component_outputs 时有效,变量的来源标准插件
source_info dict source_type=component_inputs或component_outputs 时有效,变量的来源节点信息