CreateSceneRule_物联网平台_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

限制条件

单阿里云账号调用该接口的每秒请求数(QPS)最大限制为 10。

说明 RAM 用户共享主账号配额。

流控信息

请求速率为10/1(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
iot:CreateSceneRule
Create
全部资源
*

请求参数

字段名称字段详情
IotInstanceIdstring

实例 ID。公共实例不传此参数,企业版实例需传入。

示例值:iot_instc_pu****_c*-v64********
RuleNamestring

场景联动规则名称。支持中文、大小写英文字母、数字、下划线(_)和短划线(-),长度限制为 1~30 个字符。

示例值:test参考取值来源:
    GetSceneRule
    QuerySceneRule
RuleContentstring

场景联动规则内容。格式详情请参见场景联动规则编写说明

示例值:{"action":[{"params":{"content":"${metadata.formattedTime}: 收到定时消息","title":"钉钉机器人通知","webHook":"https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxx"},"uri":"action/dingtalk/robot"}],"trigger":{"params":{"cron":"0 * * * * ? 2020","cronType":"quartz_cron"},"uri":"trigger/timer"},"type":"IFTTT"}
RuleDescriptionstring

场景联动规则描述。长度不超过 100 个字符。

示例值:定时发送消息到钉钉机器人

请求说明

调用 API 时,除了本文介绍的该 API 的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档

返回参数

字段名称字段详情
Codestring

接口返回码。Success 表示成功,其它表示错误码。详情请参见错误码

示例值:Success
ErrorMessagestring

调用失败时,返回的出错信息。

示例值:request parameter error
RequestIdstring

阿里云为该请求生成的唯一标识符。

示例值:C9D9C91B-1B3B-4D84-BE58-68E7B2A989EA
Successboolean

表示是否调用成功。true 表示调用成功,false 表示调用失败。

示例值:true
RuleIdstring

场景联动规则 ID。

示例值:f041397879ad4d89822811d741******

返回示例

变更历史

暂无变更历史

相关示例

物联网平台-规则引擎-场景联动(https://iot.console.aliyun.com/rule/simple)
2022-05-24