調(diào)用該接口更新數(shù)據(jù)目的名稱(chēng)、操作類(lèi)型和描述信息。
使用說(shuō)明
調(diào)用接口CreateDestination創(chuàng)建數(shù)據(jù)目的成功后,若有業(yè)務(wù)需要,您可根據(jù)返回的DestinationId更新對(duì)應(yīng)數(shù)據(jù)目的信息。
QPS限制
單個(gè)阿里云賬號(hào)調(diào)用該接口的每秒請(qǐng)求數(shù)(QPS)最大限制為10。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱(chēng) | 類(lèi)型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateDestination |
系統(tǒng)規(guī)定參數(shù)。取值:UpdateDestination。 |
Configuration | String | 是 | {"topic":"/a1POX0c****/device1/user/get","topicType":1} |
數(shù)據(jù)目的對(duì)應(yīng)的配置信息,傳入格式為JSON String。不同規(guī)則動(dòng)作類(lèi)型所需內(nèi)容不同,具體要求和示例說(shuō)明,請(qǐng)參見(jiàn)CreateDestination中Configuration參數(shù)描述。 |
DestinationId | Long | 是 | 1002 |
數(shù)據(jù)目的ID。 您可調(diào)用接口ListDestination,查詢(xún)數(shù)據(jù)源列表,獲取DestinationId。 |
Name | String | 是 | DataPurpose |
數(shù)據(jù)目的名稱(chēng)。 |
Type | String | 是 | REPUBLISH |
數(shù)據(jù)目的操作類(lèi)型,可取值:
|
IotInstanceId | String | 否 | iot-2w**** |
實(shí)例ID。您可在物聯(lián)網(wǎng)平臺(tái)控制臺(tái)的實(shí)例概覽頁(yè)面,查看當(dāng)前實(shí)例的ID。 注意
實(shí)例的更多信息,請(qǐng)參見(jiàn)實(shí)例概述。 |
Description | String | 否 | 數(shù)據(jù)流轉(zhuǎn)至另一個(gè)Topic。 |
數(shù)據(jù)目的描述信息。 |
調(diào)用API時(shí),除了本文介紹的該API的特有請(qǐng)求參數(shù),還需傳入公共請(qǐng)求參數(shù)。公共請(qǐng)求參數(shù)說(shuō)明,請(qǐng)參見(jiàn)公共參數(shù)文檔。
返回?cái)?shù)據(jù)
名稱(chēng) | 類(lèi)型 | 示例值 | 描述 |
---|---|---|---|
Code | String | iot.system.SystemException |
調(diào)用失敗時(shí),返回的錯(cuò)誤碼。更多信息,請(qǐng)參見(jiàn)錯(cuò)誤碼。 |
ErrorMessage | String | 系統(tǒng)異常 |
調(diào)用失敗時(shí),返回的出錯(cuò)信息。 |
RequestId | String | E4C0FF92-2A86-41DB-92D3-73B60310D25E |
阿里云為該請(qǐng)求生成的唯一標(biāo)識(shí)符。 |
Success | Boolean | true |
表示是否調(diào)用成功。
|
示例
請(qǐng)求示例
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=UpdateDestination
&Configuration={"topic":"/a1POX0c****/device1/user/get","topicType":1}
&DestinationId=1002
&Name=DataPurpose
&Type=REPUBLISH
&<公共請(qǐng)求參數(shù)>
正常返回示例
XML
格式
<UpdateDestinationResponse>
<RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
<Success>true</Success>
</UpdateDestinationResponse>
JSON
格式
{
"RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
"Success": true
}