# UpdateProductTopic

调用该接口更新指定的产品自定义Topic类。

# 请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateProductTopic 系统规定参数。取值:UpdateProductTopic。
Operation String PUB 设备对该Topic类的操作权限,取值:PUB:发布。SUB:订阅。ALL:发布和订阅。
TopicId String 821**** 要修改的Topic类的ID。
调用CreateProductTopic接口创建自定义Topic类成功后,返回的TopicId。
TopicShortName String resubmit 设置Topic类的自定义类目名称。Topic类默认包含_productKey_,_deviceName_和_user_三级类目,类目间以正斜线(/)分隔,其格式为:productKey/deviceName/user/topicShortName。
IotInstanceId String 6912917943269**** 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID。
Desc String resubmit a test topic Topic类的描述信息。长度限制为100字符(一个汉字占一个字符)。
EnableProxySubscribe Boolean false Operation为SUB(订阅)或ALL(发布和订阅),可开启代理订阅。取值:true:开启(默认)。false:不开启。开启代理订阅后,设备与物联网平台建连时,物联网平台查询已开启代理订阅的Topic,帮助设备完成订阅。

注意: 当操作权限(Operation)为ALL且开启代理订阅(EnableProxySubscribe=true)时

  • 当设备侧使用MQTT 3.1/3.1.1协议连接平台,设备使用权限为ALL的topic发布消息时,设备会接收到自身发布的消息内容;
  • 当设备侧使用MQTT 5.0协议连接平台,设备使用权限为ALL的topic发布消息时,设备不会接收到自身发布的消息内容。

# 返回数据

名称 类型 示例值 描述
Code String iot.system.SystemException 调用失败时,返回的错误码。
ErrorMessage String 系统异常 调用失败时,返回的出错信息。
RequestId String olmM8Mc9H3DcP7y4kGswzCG6lKHSAndq 平台为该请求生成的唯一标识符。
Success Boolean true 是否调用成功。
true:表示调用成功。
false:表示调用失败。

# 示例

请求示例

http://open.${区域}.fenydata.com/fenydata-java-open/?Action=UpdateProductTopic
&TopicId=821****
&TopicShortName=resubmit
&Operation=PUB
&Desc=resubmit a test topic
&EnableProxySubscribe=false
&<公共请求参数>

正常返回示例

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xml>
  <RequestId>AmlS9XiJLrRrC7YtPNDWNODrb1t6xinc</RequestId>
  <Success>true</Success>
</xml>

JSON格式

{
  "RequestId": "FCC27691-9151-4B93-9622-9C90F30542EC",
  "Success": true
}