CreateDestination_物联网平台_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 限制

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

说明 RAM 用户共享阿里云账号配额。

流控信息

当前云产品API请求速率暂未透出。

授权信息

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

具体说明如下:展开详情

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

请求参数

字段名称字段详情
Configurationstring

数据目的对应的配置信息,传入格式为 JSON String。不同规则动作类型所需内容不同,具体要求和示例请参见本表格下方的参数补充说明。

示例值:{"topic":"/a1POX0c****/device1/user/get","topicType":1}
IotInstanceIdstring

实例 ID。您可在物联网平台控制台的实例概览页面,查看当前实例的 ID展开详情

示例值:iot-2w****
Typestring

数据目的操作类型,可取值:展开详情

示例值:REPUBLISH
Namestring

数据目的名称。

示例值:DataPurpose
Descriptionstring

数据目的描述信息。

示例值:数据流转至数据库。

请求说明

REPUBLISH 类型 Configuration 定义

名称描述
productKey转发至另一个 Topic 所属产品的 ProductKey。

REPUBLISH 类型 Configuration 示例:

{
    "productKey":"hf****3xn"
}

AMQP 类型 Configuration 定义

名称描述
groupId消费组 ID。

AMQP 类型 Configuration 示例:

{
    "groupId":"ZTh1JmuZcUfv44p4z00****"
}

OTS 类型 Configuration 定义

名称描述
instanceName表格存储中用来接收信息的实例名称。
regionName目标实例所在的阿里云地域代码,例如 cn-shanghai。
tableName表格存储中用来接收信息的数据表名称。
role授权角色信息。通过授予物联网平台指定的系统服务角色,您可以授权物联网平台访问您的表格存储。授权角色信息:
{"roleName":"AliyunIOTAccessingOTSRole","roleArn":"acs:ram::${uid}:role/aliyuniotaccessingotsrole"}
${uid}为您的阿里云账号 ID。您可以登录控制台,在账号安全设置页面查看您的账号 ID。
AliyunIOTAccessingOTSRole是访问控制中定义的服务角色。用于授予物联网平台访问表格存储。关于角色的更多信息,请在访问控制 RAM 控制台的角色管理页面进行角色管理。

OTS 类型 Configuration 示例:

{
    "instanceName":"${instanceName}",
    "regionName":"cn-shanghai",
    "tableName":"test_table",
    "role":{
        "roleName":"AliyunIOTAccessingOTSRole",
        "roleArn":"acs:ram::${uid}:role/aliyuniotaccessingotsrole"
    }
}

DATAHUB 类型 Configuration 定义

名称描述
projectName目标 DataHub 中用来接收信息的具体 Project。
topicName目标 DataHub 中用来接收信息的具体 Topic。
regionName目标 DataHub 所在的阿里云地域代码,例如 cn-shanghai。
role授权角色信息。通过授予 IoT 指定的系统服务角色,您可以授权物联网平台访问您的 DataHub。授权角色信息格式:
{"roleArn":"acs:ram::${uid}:role/aliyuniotaccessingdatahubrole","roleName": "AliyunIOTAccessingDataHubRole"}
${uid}为您的阿里云账号 ID。您可以登录控制台,在账号安全设置页面查看您的账号 ID。
AliyunIOTAccessingDataHubRole是访问控制中定义的服务角色。用于授予物联网平台访问 DataHub。关于角色的更多信息,请在访问控制 RAM 控制台的角色管理页面进行角色管理。

DATAHUB 类型 Configuration 示例:

{
    "role":{
        "roleArn": "acs:ram::${uid}:role/aliyuniotaccessingdatahubrole",
        "roleName": "AliyunIOTAccessingDataHubRole"
    },
    "ProjectName": "test_project_name",
    "RegionName": "cn-shanghai",
    "TopicName": "test_topic"
}

MNS 类型 Configuration 定义

名称描述
themeName消息服务中用来接收信息的目标主题名称。
regionName目标消息服务所在的阿里云地域代码,例如 cn-shanghai。
role授权角色信息。通过授予物联网平台指定的系统服务角色,您可以授权物联网平台访问您的消息服务。授权角色信息:
{"roleArn":"acs:ram::${uid}:role/aliyuniotaccessingmnsrole","roleName": "AliyunIOTAccessingMNSRole"}
${uid}为您的阿里云账号 ID。您可以登录控制台,在账号安全设置页面查看您的账号 ID。
AliyunIOTAccessingMNSRole是访问控制中定义的服务角色。用于授予物联网平台访问消息服务。关于角色的更多信息,请在访问控制 RAM 控制台的角色管理页面进行角色管理。

MNS 类型​Configuration​​示例:

{
    "themeName": "test_name",
    "role":{
        "roleArn": "acs:ram::${uid}:role/aliyuniotaccessingmnsrole",
        "roleName": "AliyunIOTAccessingMNSRole"
    },
    "regionName": "cn-shanghai"
}

ONS 类型 Configuration 定义

说明 您需通过调用消息队列 RocketMQ 的 SDK,或在消息队列 RocketMQ 控制台,授权物联网平台访问消息队列 RocketMQ(至少要授予物联网平台发布权限),然后才能够成功创建将 Topic 数据转发至消息队列 RocketMQ 的规则动作。
名称描述
instanceIdRocketMQ 中用来接收消息的目标 Topic 所属的实例 ID。
topicRocketMQ 中用来接收信息的目标 Topic。
regionName目标 RocketMQ 实例所在的阿里云地域代码,例如 cn-shanghai。
目前仅支持同地域内数据流转。
role授权角色信息。通过授予物联网平台指定的系统服务角色,您可以授权物联网平台访问您的消息队列 RocketMQ 服务。授权角色信息:
{"roleArn":"acs:ram::${uid}:role/aliyuniotaccessingmqrole","roleName": "AliyunIOTAccessingMQRole"}
${uid}为您的阿里云账号 ID。您可以登录控制台,在账号安全设置页面查看您的账号 ID。
AliyunIOTAccessingMQRole是访问控制中定义的服务角色。用于授予物联网平台访问消息队列 RocketMQ。关于角色的更多信息,请在访问控制 RAM 控制台的角色管理页面进行角色管理。

ONS 类型 Configuration 示例:

{
    "instanceId": "${MQ_INST_ID}",
    "role":
    {
        "roleArn": "acs:ram::${uid}:role/aliyuniotaccessingmqrole",
        "roleName": "AliyunIOTAccessingMQRole"
    },
    "regionName": "cn-shanghai",
    "topic": "test_topic"
}

FC 类型 Configuration 定义

名称描述
functionName函数服务中用来接收信息的目标函数名称。
serviceName函数服务中用来接收信息的目标服务名称。
regionName目标函数服务实例所在阿里云地域的代码,如 cn-shanghai。
role授权角色信息。通过授予物联网平台指定的系统服务角色,您可以授权物联网平台访问您的函数计算服务。授权角色信息:
{"roleArn":"acs:ram::${uid}:role/aliyuniotaccessingfcrole","roleName": "AliyunIOTAccessingFCRole"}
${uid}为您的阿里云账号 ID。您可以登录控制台,在账号安全设置页面查看您的账号 ID。
AliyunIOTAccessingFCRole是访问控制中定义的服务角色。用于授予物联网平台访问函数计算。关于角色的更多信息,请在访问控制 RAM 控制台的角色管理页面进行角色管理。

FC 类型 Configuration 示例:

{
    "role":
    {
        "roleArn": "acs:ram::${uid}:role/aliyuniotaccessingfcrole",
        "roleName": "AliyunIOTAccessingFCRole"
    },
    "functionName": "${function_name}",
    "serviceName": "${service_name}",
    "regionName": "cn-shanghai"
}

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

返回参数

字段名称字段详情
Codestring

调用失败时,返回的错误码。更多信息,请参见错误码

示例值:iot.system.SystemException
ErrorMessagestring

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

示例值:系统异常
RequestIdstring

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

示例值:E4C0FF92-2A86-41DB-92D3-73B60310D25E
Successboolean

表示是否调用成功。展开详情

示例值:true
Destinationobject

创建成功后,返回的数据目的信息。

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
iot.system.SystemException
An internal error occurred. Try again later.诊断
400
iot.system.IllegalRequest
The request parameter is invalid.诊断
400
iot.ruleng.NullRuleActionConfig
The rule action configuration is empty.诊断
400
iot.ruleng.NullRuleActionType
The specified rule action is invalid or the rule action type is unspecified.诊断
400
iot.ruleng.InvalidRamRole
The RAM role is invalid诊断
400
iot.rule.DestinationCountExceed
The count of destination exceeds the maximum number诊断
400
iot.rule.DestinationNameExisted
The destination name is existed诊断
400
iot.rule.InvalidDestinationName
The destination name is invalid诊断
400
iot.ruleng.RegionNotSupportRuleForwardCloudProduct
The specified region does not support creating rules to publish messages to the specified cloud product诊断
400
iot.ruleng.IncorrectRegionName
The regionName value is incorrect诊断
400
iot.consumer.group.InvalidConsumerGroupId
Illegal consumer group ID诊断
400
iot.ruleng.NullProjectOfDatahub
The project in DataHub is empty诊断
400
iot.ruleng.NotFoundTopicInDataHubProject
This specified topic does not exist in the project in DataHub诊断
400
iot.ruleng.NotFoundVpcInstance
The specified VPC instance does not exist.诊断

变更历史

暂无变更历史

相关示例

物联网平台/规则引擎/云产品流转(新版)/数据目的https://iot.console.aliyun.com/rule/list
2022-07-21