調(diào)用該接口更新解析器名稱和描述。

使用說明

調(diào)用接口CreateParser創(chuàng)建解析器成功后，若有業(yè)務(wù)需求，您可根據(jù)返回的ParserId更新對應(yīng)解析器的名稱和描述。

QPS限制

單個(gè)阿里云賬號調(diào)用該接口的每秒請求數(shù)（QPS）最大限制為10。

說明 RAM用戶共享阿里云賬號配額。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 UpdateParser

系統(tǒng)規(guī)定參數(shù)。取值：UpdateParser。
ParserId Long 是 1001

解析器ID。您可調(diào)用接口ListParser，查詢解析器列表，獲取ParserId。
IotInstanceId String 否 iot-8t***

實(shí)例ID。您可在物聯(lián)網(wǎng)平臺控制臺的實(shí)例概覽頁面，查看當(dāng)前實(shí)例的ID。

重要
  • 若有ID值，必須傳入該ID值，否則調(diào)用會失敗。
  • 若無ID值，則無需傳入。

實(shí)例的更多信息，請參見實(shí)例概述。
Description String 否 轉(zhuǎn)發(fā)數(shù)據(jù)。

解析器描述。
Name String 否 DataParserTwo

解析器名稱，支持中文、英文字母、日文、數(shù)字、下劃線（_）和短劃線（-），長度為1~30個(gè)字符，一個(gè)中文及日文占2個(gè)字符。

調(diào)用API時(shí)，除了本文介紹的該API的特有請求參數(shù)，還需傳入公共請求參數(shù)。公共請求參數(shù)說明，請參見公共參數(shù)文檔。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
Code String iot.system.SystemException

調(diào)用失敗時(shí)，返回的錯(cuò)誤碼。更多信息，請參見錯(cuò)誤碼。
ErrorMessage String 系統(tǒng)異常

調(diào)用失敗時(shí)，返回的出錯(cuò)信息。
RequestId String E4C0FF92-2A86-41DB-92D3-73B60310D25E

阿里云為該請求生成的唯一標(biāo)識符。
Success Boolean true

是否調(diào)用成功。

  • true：調(diào)用成功。
  • false：調(diào)用失敗。

示例

請求示例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=UpdateParser
&ParserId=1001
&Name=DataParserTwo
&<公共請求參數(shù)>

正常返回示例

XML格式

<UpdateParserResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <Success>true</Success>
</UpdateParserResponse>

JSON格式

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "Success": true
}

錯(cuò)誤碼

HttpCode 錯(cuò)誤碼 錯(cuò)誤信息 描述
400 iot.system.SystemException An internal error occurred. Try again later. 系統(tǒng)異常。
400 iot.common.InvalidFormattedParameter The parameter format is invalid. 參數(shù)格式錯(cuò)誤。
400 iot.rule.UpdateRuleFailed An error occurred while upgrading the rule. 更新規(guī)則失敗。

訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。