文档首页/ 数据湖工厂 DLF/ 用户指南/ 参考/ 节点/ Rest Client
更新时间：2022-02-24 GMT+08:00
查看PDF
分享

Rest Client

功能

通过Rest Client节点执行一个华为云内的RESTful请求，目前只支持IAM Token认证鉴权方式的RESTful请求。

参数

用户可参考表1，表2和表3配置Rest Client节点的参数。

表1 属性参数

参数

是否必选

说明

节点名称

是

节点名称，可以包含中文、英文字母、数字、“_”、“-”、“/”、“<”、“>”等各类特殊字符，长度为1～128个字符。

URL地址

是

填写请求主机的IP或域名地址，以及端口号。例如：https://192.160.10.10:8080

HTTP方法

是

选择请求的类型：

  • GET
  • POST
  • PUT
  • DELETE

请求头

否

单击，添加请求消息头，参数说明如下：

  • 参数名称

    选择参数的名称，选项为“Content-Type”、“Accept-Language”、“X-Auth-Token”。

  • 参数值

    填写参数的值，只支持英文字母、数字、“-”、“_”、“/”、“;”，最大长度为64字符。

URL参数

否

填写URL参数，格式为“参数=值”形式的字符串，字符串间以换行符分隔。当“HTTP方法”为“GET”时，显示该配置项。参数说明如下：

  • 参数

    只支持英文字母、数字、“-”、“_”，最大长度为32字符。

  • 值

    只支持英文字母、数字、“-”、“_”、“$”、“{”和“}”，最大长度为64字符。

请求消息体

是

填写Json格式的请求消息体。当“HTTP方法”为“POST”、“PUT”时，显示该配置项。

是否需要判断返回值

否

设置是否判断返回消息的值和预期的一致。当“HTTP方法”为“GET”时，显示该配置项。

  • YES：检查返回消息中的值是否和预期的一致。
  • NO：不检查，请求返回200响应码（表示节点执行成功）。

返回值字段路径

是

填写Json响应消息中某个属性的路径（下称：Json属性路径），每个Rest Client节点都只能配置一个属性的路径。当“是否需要判断返回值”为“YES”时，显示该配置项。

例如，返回结果为：

{         
  "param1": "aaaa",
  "inner": 
    {                   
      "inner":
        {
          "param4": 2014247437
         },
       "param3": "cccc" 
     },
     "status": 200,
     "param2": "bbbb"
}

其中“param4”属性的路径为“inner.inner.param4”。

请求成功标志位

是

填写请求成功标志位，如果响应消息的返回值与请求成功标志位中的某一个匹配，表示节点执行成功。当“是否需要判断返回值”为“YES”时，显示该配置项。

请求成功标志位只支持英文字母、数字、“-”、“_”、“$”、“{”、“}”，多个值使用“;”分隔。

请求失败标志位

否

填写请求失败标志位，如果响应消息的返回值与请求失败标志位中的某一个匹配，表示节点执行失败。当“是否需要判断返回值”为“YES”时，显示该配置项。

请求失败标志位只支持英文字母、数字、“-”、“_”、“$”、“{”、“}”，多个值使用“;”分隔。

请求间隔时间（秒）

是

如果响应消息的返回值与请求成功标志位不匹配，将每隔一段时间查询一次，直到响应消息的返回值与请求成功标志位一致。节点执行的超时时间默认为1小时，如果1小时内查询的结果始终为不匹配，那么节点的状态将置为失败。当“是否需要判断返回值”为“YES”时，显示该配置项。

响应消息体解析为传递参数定义

否

设置作业变量与Json属性路径的对应关系，参数间以换行符分隔。

例如：var4=inner.inner.param4

其中，“var4”为作业变量，作业变量只支持英文字母、数字，最大长度为16字符；“inner.inner.param4”为Json属性路径。

仅该节点的后续节点引用该参数才会生效，引用该参数时，格式为：${var4}。
表2 高级参数

参数

是否必选

说明

节点执行的最长时间

是

设置节点执行的超时时间，如果节点配置了重试，在超时时间内未执行完成，该节点将不会再重试，直接置为失败状态。

失败重试

是

节点执行失败后，是否重新执行节点。

  • 是：重新执行节点，请配置以下参数。
    • 最大重试次数
    • 重试间隔时间（秒）
  • 否：默认值，不重新执行节点。
说明：

如果作业节点配置了重试，并且配置了超时时间，该节点执行超时后将不会再重试，直接置为失败状态。

失败策略

是

节点执行失败后的操作：

  • 终止当前作业执行计划
  • 继续执行下一节点
  • 挂起当前作业执行计划
  • 终止后续节点执行计划
表3 血缘关系

参数

说明

输入

新建

单击“新建”，在“类型”的下拉选项中选择要新建的类型。可以选择DWS，OBS，CSS和DLI类型。

  • DWS
    • 连接名称（必选）：单击，在弹出的“连接名称”窗口选择DWS的数据连接。
    • 数据库（必选）：单击，在弹出的“数据库”窗口选择DWS的数据库。
    • schema（必选）：单击，在弹出的“schema”窗口选择DWS的数据库模式。
    • 表名（必选）：单击，在弹出的“表名”窗口选择DWS的数据表。
  • OBS
    • 路径（必选）：单击，在弹出的“OBS文件浏览”窗口选择OBS路径。
  • CSS
    • 集群名称（必选）：单击，在弹出的“CloudSearch集群”窗口选择CloudSearch集群。
    • 索引名称（必选）：输入CSS类型的索引名称。
  • DLI
    • 连接名称（必选）：单击，在弹出的“连接名称”窗口选择DLI的数据连接。
    • 数据库（必选）：单击，在弹出的“数据库”窗口选择DLI的数据库。
    • 表名（必选）：单击，在弹出的“表名”窗口选择DLI的数据表。

确认

单击“确认”，保存节点输入功能的参数配置。

取消

单击“取消”，取消节点输入功能的参数配置。

编辑

单击，修改节点输入功能的参数配置，修改完成后，请保存。

删除

单击，删除节点输入功能的参数配置。

查看表详情

单击，查看节点输入血缘关系创建数据表的详细信息。

输出

新建

单击“新建”，在“类型”的下拉选项中选择要新建的类型。可以选择DWS，OBS，CSS，DLI类型。

  • DWS
    • 连接名称（必选）：单击，在弹出的“连接名称”窗口选择DWS的数据连接。
    • 数据库（必选）：单击，在弹出的“数据库”窗口选择DWS的数据库。
    • schema（必选）：单击，在弹出的“schema”窗口选择DWS的数据库模式。
    • 表名（必选）：单击，在弹出的“表名”窗口选择DWS的数据表。
  • OBS
    • 路径（必选）：单击，在弹出的“OBS文件浏览”窗口选择OBS路径。
  • CSS
    • 集群名称（必选）：单击，在弹出的“CloudSearch集群”窗口选择CloudSearch集群。
    • 索引名称（必选）：输入CSS类型的索引名称。
  • DLI
    • 连接名称（必选）：单击，在弹出的“连接名称”窗口选择DLI的数据连接。
    • 数据库（必选）：单击，在弹出的“数据库”窗口选择DLI的数据库。
    • 表名（必选）：单击，在弹出的“表名”窗口选择DLI的数据表。

确认

单击“确认”，保存节点输出功能的参数配置。

取消

单击“取消”，取消节点输出功能的参数配置。

编辑

单击，修改节点输出功能的参数配置，修改完成后，请保存。

删除

单击，删除节点输出功能的参数配置。

查看表详情

单击，查看节点输出血缘关系创建数据表的详细信息。
父主题： 节点