修改规则动作

Internal server

error. 服务器内部错误 请联系华为工程师

分析解决。

IOTDA .00002 0

Decrypt IAM token

failed. IAM Token解析失 败

请联系华为工程师 分析解决。

1.11.9 修改规则动作

接口说明

应用服务器可调用此接口修改物联网平台中指定规则动作的配置。

调试

您可以在API Explorer中调试该接口。

URI

请求方法 PUT

URI /v5/iot/{project_id}/routing-rule/actions/{action_id}

传输协议 HTTPS

请求参数

名称 必选/可

选

类型 位置 说明

X-Auth-Token 必选 String Head

er 参数说明：用户Token。通过调用 IAM服务 获取IAM用户Token接口 获取，接口返回的响应消息头中

“X-Subject-Token”就是需要获 取的用户Token。简要的获取方法 样例请参见 Token认证。

Instance-Id 可选 String Head

er 参数说明：实例ID。物理多租下各 实例的唯一标识，一般华为云租户 无需携带该参数，仅在物理多租场 景下从管理面访问API时需要携带 该参数。

project_i

d 必选 String Path 参数说明：项目ID。获取方法请参 见 获取项目ID。

action_id 必选 String Path 参数说明：规则动作ID。

取值范围：长度不超过36，只允许 字母、数字、下划线（_）、连接 符（-）的组合。

channel 可选 String Body 参数说明：规则动作的类型。

取值范围：

● HTTP_FORWARDING：HTTP 服务消息类型。

● DIS_FORWARDING：转发DIS 服务消息类型。

● OBS_FORWARDING：转发 OBS服务消息类型。

● AMQP_FORWARDING：转发 AMQP服务消息类型。

● DMS_KAFKA_FORWARDING：

转发kafka消息类型。

channel_

detail 可选 ChannelDeta

il Object Body 参数说明：通道配置信息。

表1-84 ChannelDetail

名称 必选/可选 类型 说明

http_forwa

rding 可选 HttpForwardi

ng Object 参数说明：http服务器转发消息内容。

当type为HTTP_FORWARDING时，必 填。

名称 必选/可选 类型 说明 dis_forwar

ding 可选 DisForwardin

g Object 参数说明：转发DIS服务消息内容。当 type为DIS_FORWARDING时，必填。

obs_forwa

rding 可选 ObsForwardi

ng Object 参数说明：转发OBS服务消息内容。当 type为OBS_FORWARDING时，必填。

amqp_for

warding 可选 AmqpForwar

ding Object 参数说明：转发AMQP服务消息内容。

当type为AMQP_FORWARDING时，必 填。

dms_kafka _forwardin g

可选 DmsKafkaFor warding Object

参数说明：转发Kafka消息内容。当 type为DMS_KAFKA_FORWARDING 时，必填。

表1-85 HttpForwarding

名称 必选/可选 类型 说明

url 必选 String 参数说明：用于接收满足规则条件数据

的http服务器地址。

cert_id 可选 String 参数说明：证书id，请参见获取证书ID cn_name 可选 String 参数说明：当sni_enable为true时，此

字段需要填写，内容为将要请求的服务 端证书的域名,举例:domain:8443;当 sni_enbale为false时，此字段默认不填 写。

sni_enable 可选 Boolean 参数说明：需要https服务端和客户端 都支持此功能，默认为false，设成true 表明Https的客户端在发起请求时，需 要携带cn_name；https服务端根据 cn_name返回对应的证书；设为false 可关闭此功能。

表1-86 DisForwarding

名称 必选/可选 类型 说明

region_na

me 必选 String 参数说明：DIS服务对应的region区域 project_id 必选 String 参数说明：DIS服务对应的projectId信

息 stream_na

me 可选 String 参数说明：DIS服务对应的通道名称，

stream_id和stream_name两个参数必

名称 必选/可选 类型 说明

stream_id 可选 String 参数说明：DIS服务对应的通道ID，

stream_id和stream_name两个参数必 须携带一个，优先使用stream_id

表1-87 ObsForwarding

名称 必选/可选 类型 说明

region_na

me 必选 String 参数说明：OBS服务对应的region区域 project_id 必选 String 参数说明：OBS服务对应的projectId信

息 bucket_na

me 必选 String 参数说明：OBS服务对应的桶名称

location 可选 String 参数说明：OBS服务对应桶的区域 file_path 可选 String 参数说明：OBS服务中存储通道文件的

自定义目录,多级目录可用(/)进行分 隔，不可以斜杠(/)开头或结尾，不能 包含两个以上相邻的斜杠(/)

取值范围: 英文字母(a-zA-Z)、数字 (0-9)、下划线(_)、中划线(-)、斜杠 (/)和大括号({})，最大字符长度256个 字符。其中大括号只能用于对应模板参 数。

模板参数:

- \{YYYY\} 年 - \{MM\} 月 - \{DD\} 日 - \{HH\} 小时

例如:自定义目录结构为\{YYYY\}/\

{MM\}/\{DD\}/\{HH\},则会在转发数 据时，根据当前时间往对应的目录结构 2021>08>11>09下生成对应的数据。

表1-88 AmqpForwarding

名称 必选/可选 类型 说明

queue_na

me 必选 String 参数说明：用于接收满足规则条件数据

的amqp queue。