华为云用户手册

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用 IAM 服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，一般华为云租户无需携带该参数，仅在物理多租场景下从管理面访问API时需要携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID。

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 200 IOTDA.014111 Command request timed out. Check whether the device returns a response within the specified time after receiving the request. 同步命令等待设备回复命令响应超时。 该接口为同步接口，需要设备在收到命令后回复命令响应请检查设备收到请求后是否在指定时间内返回响应给平台。 400 IOTDA.000006 Invalid input data. 请求参数不合法。 请排查请求参数是否符合华为云对应接口文档要求。 400 IOTDA.000008 Invalid input. The request format is invalid. For details, see the error message. 请求的格式不正确，如json非法，mediaType不正确等。 请排查该请求的请求格式是否正确。 400 IOTDA.000009 Invalid input. Invalid time format. 时间的格式不正确。 请排查请求参数中时间的格式是否与对应接口文档中的保持一致。 400 IOTDA.000010 Invalid input. The start time must be earlier than the end time. 请求中的开始时间大于结束时间。 请求中开始时间必须早于结束时间。 400 IOTDA.000011 Invalid input. The specified parameter 'pageNo' is out of range. 请求参数中pageNo超出范围。 请排查请求参数中的pageNo大小是否在对应接口文档限制范围之内。 400 IOTDA.000012 Invalid input. The specified parameter 'pageSize' is out of range. 请求参数中pageSize超出范围。 请排查请求参数中的pageSize大小是否在对应接口文档限制范围之内。 400 IOTDA.000013 Invalid input. The value of 'pageSize' multiplying 'pageNo' exceeds the upper limit. 查询范围超过最大限制。 请检查pageSize和pageNo参数的大小。 400 IOTDA.000014 Invalid input. The specified parameter 'nextToken' is out of range. 请求中nextToken参数超过范围。 请排查请求中的nextToken参数是否在对应接口文档的限制范围之内。 400 IOTDA.000017 Invalid input. The specified parameter 'limit' is out of range. 请求中limit参数超过范围。 请排查请中求的limit参数是否在对应接口文档的限制范围之内。 400 IOTDA.000018 Invalid input. The specified parameter 'marker' is out of range. 请求中marker参数超过范围。 请排查请求中的marker参数是否在对应接口文档的限制范围之内。 400 IOTDA.000030 Failed to register the resource in Stage. Please try again later. 注册资源失败。 请稍后重试或联系华为工程师分析解决。 400 IOTDA.000031 Failed to deregister the resource in Stage. Please try again later. 注销资源失败。 请稍后重试或联系华为工程师分析解决。 400 IOTDA.000032 Failed to update the resource in Stage. Please try again later. 修改资源失败。 请稍后重试或联系华为工程师分析解决。 400 IOTDA.001001 Invalid input for this application. 资源空间参数不合法。 请参考华为云文档创建资源空间的请求参数章节。 400 IOTDA.001004 AppId is not in request header. 该用户有多个资源空间的情况下未携带appId访问接口。 请携带对应的appId。 400 IOTDA.001011 Invalid input. The specified parameter 'app_id' is not carried. 未携带参数app_id。 请在请求参数中携带app_id。 400 IOTDA.001012 Invalid input. The appId already exists. 资源空间ID已存在。 请更换资源空间ID。 400 IOTDA.001013 Invalid input. The source and target instance IDs cannot be the same. 源实例ID与目的实例ID不能相同。 请检查实例ID是否正确。 400 IOTDA.004002 Invalid input. The tag_key %s cannot start with 'iot_'. 标签的tag_key不能以iot_开头。 请修改tag_key后进行操作。 400 IOTDA.004003 Invalid input. The tag_key %s does not exist. 不存在此tag_key的标签。 请确认传递的tag_key参数是否正确或是否存在该标签。 400 IOTDA.004004 Invalid input. This tag key %s already exists. 标签的tag_key重复。 请修改tag_key的值后再操作。 400 IOTDA.005002 Upgrade Failed. Invalid device version. 升级失败，设备版本号不合法。 请确认设备上报版本号是否为空。 400 IOTDA.005003 Upgrade failed. Verify device version failed. 升级失败， 版本号校验失败。 请将设备上报的版本号与软固件包的版本号保持一致。 400 IOTDA.005004 Upgrade failed. The current version cannot be upgraded to the target version. 升级失败，当前版本不能升级到目标版本。 请确认设备上报的版本号与软固件包支持的源版本号是否一致。 400 IOTDA.005005 Upgrade failed. Invalid update status. 升级失败, 更新状态非法。 请确认上报的更新状态是否正确。 400 IOTDA.005006 Upgrade Failed. ErrorCode: %s, description : %s. 升级失败。 请确认上报码流是否正确，ErrorCode可参考文档设备上报升级状态 。 400 IOTDA.005007 Upgrade failed. The format of the device data is invalid. 升级失败， 设备上报的数据格式不合法。 请查阅软固件升级 页面并对设备上报数据格式进行排查。 400 IOTDA.005008 Upgrade failed. Reported progress %d%% is invalid. 升级失败， 上报升级进度不在0-100之内。 请将上报升级进度约束在0-100之内。 400 IOTDA.005009 Upgrade failed. Invalid result_code. 升级失败, result_code不合法。 请查阅设备上报升级状态 页面“paras参数列表”部分并对参数result_code进行检查。 400 IOTDA.005010 Upgrade failed. Waiting for %s timed out. 升级失败，等待超时。 请设备及时回响应，由于设备没有及时回响应，导致任务超时失败。 400 IOTDA.005011 Upgrade failed. Send %s command failed. 升级失败，发送命令失败。 请联系华为工程师分析解决。 400 IOTDA.009002 The resource model does not exist. 资源模型不存在。 请确认请求参数中是否携带resource和event，或者notifyType。 400 IOTDA.009004 The subscription subject does not belong to the current application. 该订阅记录不属于当前应用。 请确认订阅记录和应用间的关系是否正确。 400 IOTDA.009005 Invalid request callback URL. 请求中的callbackurl地址不合法。 请求中的callbackurl参数格式可参考文档订阅推送相关问题 。 400 IOTDA.009006 The subscription subject already exists. 该订阅记录已经存在。 该订阅已存在，无需再重复订阅。 400 IOTDA.009007 The request channel is invalid. 请求中channel参数不合法。 请排查请求中的channel参数是否符合对应规则动作/订阅接口文档channel取值要求。 400 IOTDA.009009 The filter is invalid. filter不合法。 请联系华为工程师分析解决。 400 IOTDA.009010 The resource and event do not match. resource和event不匹配。 请排查请求中resource与event参数是否符合对应规则动作/订阅接口文档中的对应关系要求。 400 IOTDA.010000 Invalid input for this rule. 规则参数不合法。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.010001 The rule name already exists. 规则名称已存在。 请换一个规则名称再重试。 400 IOTDA.010004 Invalid parameter in the rule condition. 规则条件不合法。 请求中SQL语句相关参数可参考文档SQL语句。 400 IOTDA.010005 Invalid parameter in the rule action. 规则动作参数不合法。 请排查请求中action参数是否符合华为云文档要求。 400 IOTDA.010006 Duplicate rule condition ID. 规则条件ID重复。 请重新命名规则条件ID后重试。 400 IOTDA.010007 Duplicate rule action ID. 规则动作ID重复。 请重新命名规则动作ID后重试。 400 IOTDA.010008 The device in the rule condition does not exist. 规则条件中对应的设备不存在。 请检查请求参数是否正确或设备在平台是否已经存在。 400 IOTDA.010009 The device in the rule action does not exist. 规则动作中对应的设备不存在。 请检查请求参数是否正确或设备在平台是否已经存在。 400 IOTDA.010010 The device information in the rule condition does not exist. 规则条件中对应的设备信息不存在。 请检查请求参数是否正确或设备在平台是否已经存在。 400 IOTDA.010011 The device information in the rule action does not exist. 规则动作中对应的设备信息不存在。 请检查请求参数是否正确或设备在平台是否已经存在。 400 IOTDA.010012 The tag in the rule condition does not exist. 规则条件中对应的标签不存在。 请检查请求参数是否正确或标签在平台是否已经存在。 400 IOTDA.010013 Invalid rule parameter. 规则参数不合法。 请对请求参数进行校验。 400 IOTDA.010014 Invalid input. The rule action of the DEVICE_ALARM type can be created only in the condition of the DEVICE_DATA type. DEVICE_ALARM类型的规则动作只允许创建在DEVICE_DATA类型的条件中。 请在创建的DEVICE_ALARM类型的规则动作时，将条件类型设置为DEVICE_DATA规则条件。 400 IOTDA.010015 Max rules (10) reached. 用户下规则数量超过上限。 请删除多余的规则后再注册。 400 IOTDA.010016 Invalid input. Only one DEVICE_ALARM rule can be created. DEVICE_ALARM类型规则只允许创建一个。 DEVICE_ALARM类型规则已存在，无需重复注册。 400 IOTDA.010017 Invalid input. The rule condition of the DEVICE_DATA type cannot contain both product_id and device_id. 在DEVICE_DATA类型的规则条件中不能同时存在product_id与device_id。 请确认DEVICE_DATA类型的规则条件中只存在device_id或product_id。 400 IOTDA.010018 Invalid input. Both device_id and product_id in the rule condition of the DEVICE_DATA type are empty. 在DEVICE_DATA类型的规则条件中product_id与device_id同时为空。 请确认DEVICE_DATA类型的规则条件中device_id或product_id仅有一个为空。 400 IOTDA.010019 The rule with the same condition already exists. 该规则条件的规则已经存在。 规则已存在， 无需重复注册。 400 IOTDA.010021 Invalid app_id. app_id不合法。 请确认请求中的app_id是否正确。 400 IOTDA.010022 The rule has no action and cannot be enabled. 该规则没有规则动作， 无法激活。 请通过修改规则的接口为该规则添加规则动作。 400 IOTDA.010023 Duplicate channeldetail in the rule action. 规则动作中的channeldetail重复。 规则已存在，无需重复注册或者删除无用规则后重试。 400 IOTDA.010024 Invalid input. Invalid address. 地址非法。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.010025 Invalid input. Invalid username or password. 用户名或密码不合法。 请排查请求参数username与password是否符合华为云文档要求。 400 IOTDA.010026 Invalid input. The streamId or streamName is empty. 通道ID或通道名不存在。 请排查请求参数streamId与streamName是否符合华为云文档要求。 400 IOTDA.010027 Invalid input. Failed to query the channel. 查询通道失败。 请排查请求参数是否与实际云服务产品参数一致。 400 IOTDA.010028 Invalid input. Invalid log_group_id or log_stream_id. 日志组ID或日志流ID不合法。 请排查请求参数log_group_id与log_stream_id是否符合华为云文档要求。 400 IOTDA.010029 Invalid input. Invalid func_urn. 函数的URN不合法。 请排查请求参数func_urn是否符合华为云文档要求。 400 IOTDA.010030 Invalid input. Connect to the database failed. 流转数据库连接失败。 请排查请求数据库连接参数是否符合华为云文档要求。 400 IOTDA.010031 Invalid input. The table name does not exist. 流转数据库表格不存在。 请排查请求table_name是否符合华为云文档要求。 400 IOTDA.010032 Invalid input. The suffix of the krb_file file is .conf, and the suffix of the keytab_file file is .keytab in the request. 请求krb_file文件后缀名是.conf 并且 请求keytab_file文件后缀名是.keytab。 请排查请求krb_file与keytab_file是否符合华为云文档要求。 400 IOTDA.010033 Invalid input. The credential file does not exist. Kerberos服务凭证不存在。 请排查配置凭证文件是否符合华为云文档要求。 400 IOTDA.010034 Invalid input. Connect to the cloud service failed. 连接云服务失败。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.010035 Invalid input. Max time range (24 hours) exceeded. 超出时间查询范围，最大范围是24小时。 请修改参数后重试。 400 IOTDA.010036 Invalid input. The query time dimension is invalid. 查询时间维度无效。 请修改参数后重试。 400 IOTDA.010038 Invalid input. Connect to database failed due to invalid database info. 动作中的数据库信息不合法。 请排查流转数据库信息是否符合华为云文档要求。 400 IOTDA.010039 Invalid input. Repeated column in the action database. 动作中存在多个转发字段流转到目标数据库的同一个字段。 请排查转存配置中的转发字段是否符合华为云文档要求。 400 IOTDA.010040 Invalid input. Column in the action does not match that in the database. 动作中目标存储字段和流转数据库中的字段不匹配。 请排查流转数据库是否存在转存配置中的目标存储字段。 400 IOTDA.010042 The number of rules in a project has reached the upper limit. 规则数量已经达到上限。 请删除多余的规则后重试。 400 IOTDA.010044 Invalid input. The stack policy already exists. 已存在相同积压策略配置。 积压策略配置已存在，无需重复创建或者删除对应配置后重试。 400 IOTDA.010045 Invalid input. The %s parameter is invalid. 积压策略配置参数不合法。 请排查对应积压策略配置参数是否符合华为云控制台输入要求。 400 IOTDA.010047 Invalid input. The flow control policy is duplicated. 已存在相同流控策略配置。 流控策略配置已存在，无需重复创建或者删除对应配置后重试。 400 IOTDA.010048 Invalid input. The %s parameter is invalid. 流控策略配置参数不合法。 请排查对应流控策略配置参数是否符合华为云控制台输入要求。 400 IOTDA.010050 Invalid input. Invalid address or the topic does not exist. 地址非法或者主题不存在。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.013000 The product does not exist or does not belong to the application. 产品不存在或产品不在指定资源空间下。 请排查请求参数是否正确或产品是否已经在指定资源空间下注册(不指定资源空间时，会在默认资源空间下查找产品)。 400 IOTDA.013001 The serviceType of the product does not exist. 产品服务类型不存在。 请排查该产品是否有服务类型，若没有，可调用修改产品接口添加服务类型。 400 IOTDA.013002 The properties of deviceServiceCapability do not exist. 产品的属性不存在。 请排查该产品是否有属性信息，若没有，可调用修改产品接口添加属性。 400 IOTDA.013003 Operation not allowed. The product is unavailable. 未知的产品类型。 请排查设备是否关联产品， 若没有，可调用修改设备信息接口添加产品ID。 400 IOTDA.013005 The productName has been used in the same application. 该资源空间下产品名已被使用。 请更换产品名重新操作。 400 IOTDA.013008 The product ID has been used in the same application. 该资源空间下productId已被使用。 请更换productId后重试。 400 IOTDA.013010 Invalid input. The content in the product service capability is duplicate. Check the content %s. 产品模型内容有重复的命名信息。 产品模型内容定义重复，请检查。 400 IOTDA.013012 Invalid input. The size of product profile content has reached or exceeded limit. 产品模型内容大小超过了限制。 请将定义的产品模型内容限制在指定范围内。 400 IOTDA.013015 Invalid input. The number of content items %s in the product has reached the limit %s. 无效的输入，产品中的字段超过了限制。 检查产品中的字段数。 400 IOTDA.013501 Invalid input. Invalid topic_short_name. If the value of operation_type is not SUBSCRIBE, the value of topic_short_name cannot contain the number sign (#) or plus sign (+). topic_short_name参数不合法。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.013502 Invalid input. The topic_short_name is duplicated under the same product. 相同产品下topic_short_name参数重复。 请重新填写topic_short_name后重试。 400 IOTDA.014001 Invalid input. The externalId parameter already exists. externalId参数已经存在。 请更换externalId参数后重试。 400 IOTDA.014002 Invalid input. The type of externalId must be String. externalId参数的类型必须是String类型。 请将externalId参数的类型改成String类型。 400 IOTDA.014008 Invalid input. Duplicated nodeId. nodeId已被使用。 请更换nodeId后再重试。 400 IOTDA.014009 Invalid input. Duplicated deviceName. 该资源空间下deviceName已被使用。 请更换deviceName后再重试。 400 IOTDA.014010 Invalid input. The secretDevice cannot be empty when authType is SECRET. 当authType是SECRET时, secretDevice不能为空。 请修改参数后重试。 400 IOTDA.014011 Invalid input. The secretEncryptionType cannot be empty when authType is MQTT. 当authType为MQTT时，secretEncryptionType不能为空。 请修改参数后重试。 400 IOTDA.014012 Invalid input. The pskDevice cannot be empty when authType is PSK. authType为PSK时，pskDevice不能为空。 请修改参数后重试。 400 IOTDA.014013 Invalid input. The SecureAccess (isSecure) must be true. isSecure参数值必须为true。 请将isSecure参数设置成true。 400 IOTDA.014017 Invalid input. The serviceType does not exist. serviceType参数不存在。 请检查serviceType参数与所属产品的serviceType是否相同。 400 IOTDA.014023 Gateway and sensor authentication types are inconsistent. 网关和子设备的认证类型不一致。 请保证网关和子设备的认证类型一致。 400 IOTDA.014025 Invalid input. Invalid serviceId. serviceId不合法。 请排查请求参数serviceId是否符合华为云文档要求。 400 IOTDA.014027 Invalid input. The initialization cannot be empty when mode is INITIALIZATION. mode为INITIALIZATION时initialization参数不能为空。 请联系华为工程师分析解决。 400 IOTDA.014028 Invalid input. The gateway is not online. 网关不在线。 请将网关设备接入后再重试。 400 IOTDA.014031 Invalid input. The device already exists. 设备已存在。 设备ID已存在，请更换参数后再重试，如deviceId。 400 IOTDA.014033 Invalid input. When the product protocol is CoAP, the password must be in hexadecimal format. 产品协议为CoAP时，密码必须为十六进制字符。 请将密码格式改为十六进制的字符。 400 IOTDA.014034 Invalid input. The serviceId or eventType does not match. serviceId或eventType不匹配。 请检查请求参数serviceId与eventType是否与profile中定义的相同。 400 IOTDA.014035 Invalid input. The size of extension_info has reached or exceeded 1 KB. extension_info字段大小超过1K。 请将extension_info参数的大小限制在1K以内。 400 IOTDA.014043 Invalid input. The gateway does not exist. 网关不存在。 请检查请求参数中的gateway_id是否已经在平台注册。 400 IOTDA.014051 Invalid input. The device does not exist or does not belong to the application. 设备不存在或者设备不在指定的资源空间下。 请排查请求参数是否有误并确认是否有在资源空间注册该设备。 400 IOTDA.014100 Invalid command status. 无效的命令状态。 请联系华为工程师解决。 400 IOTDA.014104 The device command cannot be canceled because it has been canceled, executed, or expired. 设备命令已被取消，到期或执行， 无法取消。 请联系华为工程师解决。 400 IOTDA.014105 Invalid parameter 'mode'. mode参数不合法。 请重新确认mode参数填写是否正确，mode值仅可以为null、PASSIVE或者ACTIVE。 400 IOTDA.014107 Invalid input. Invalid parameter 'lifeCycle'. lifeCycle参数不合法。 请联系华为工程师解决。 400 IOTDA.014108 Invalid parameter 'command_name'. command_name参数不合法。 请检查service_id,command_name参数是否与profile中的相一致。 400 IOTDA.014110 Invalid input. The format of parameter 'commandBody' is not JSON. commandBody参数格式不是json格式。 请确认请求中对应的参数paras是json格式。 400 IOTDA.014112 Send to device failed because the device does not subscribe to the topic. 发送到设备失败，设备没有订阅该主题。 请确认设备是否订阅正确的topic。 400 IOTDA.014113 Invalid input. The size of paras has exceeded the upper limit. paras参数大小超过最大值。 请减小请求中paras参数长度。 400 IOTDA.014114 The API does not support MQTT devices. 此接口不支持MQTT协议类型的设备。 请更换为NB设备或使用支持MQTT协议的接口。 400 IOTDA.014115 The API does not support NB-IoT devices. 此接口暂不支持NB-IoT设备。 对于NB-IoT设备，请使用下发异步设备命令接口。 400 IOTDA.014116 Invalid input. The size of request body has exceeded the upper limit. 下发的请求体大小超过最大值。 请减小下发的请求体大小。 400 IOTDA.014130 Invalid input. The messageId of the device is not unique. 请求下发给设备的message_id不唯一，与之前创建的message_id重复。 message_id需要确保唯一，请修改message_id参数。 400 IOTDA.014150 Invalid input. The topic has no permission. 非法的输入，该topic没有订阅的权限。 请检查topic参数，确保topic输入正确且该topic在产品中具备订阅权限或者全部权限。 400 IOTDA.014151 Invalid input. The topic-related parameters in the request are duplicate. 非法的输入， topic相关的参数重复。 请确保请求体中topic字段与topic_full_name字段只有一个被输入。 400 IOTDA.014201 Invalid input. The batch task name already exists. 该任务名已存在。 请更换任务名后重试。 400 IOTDA.014203 Invalid input. The document parameter is invalid. errorMsg : %s. 文档中的参数不合法。 请查阅创建批量任务 页面“请求参数”部分并对参数document进行检查。 400 IOTDA.014204 Invalid input. The targets and targets_filter cannot both be empty. targets和targets_filter参数不能全部为空。 请保证其中一个参数不为空。 400 IOTDA.014205 Invalid input. The key of targets_filter only supports %s. targets_filter参数的key只支持指定类型。 请查阅创建批量任务 页面“请求参数”部分并对参数targets_filter进行检查。 400 IOTDA.014207 Invalid input. The start time cannot be earlier than the current time, and the latest start time cannot exceed %s days. 开始时间不能早于当前时间，最晚启动事件不能超过指定天数。 请查阅创建批量任务 页面“请求参数”部分并对参数schedule_time进行检查。 400 IOTDA.014208 Invalid input. retry_count and retry_interval depend on each other and must be assigned at the same time. retry_count和retry_interval参数互相依赖，并且必须同时分配。 请保证retry_count和retry_interval参数同时不为空。 400 IOTDA.014209 Invalid input. The task cannot be stopped because it is completed or being stopped. 任务不能停止，因为任务已经完成或者正在停止中。 请确认任务是否处于已完成或停止状态。 400 IOTDA.014210 Invalid input. The parameter 'targets_filter' does not support multiple keys. targets_filter参数只支持一个key。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.014216 Invalid input. The task cannot retry because the task has succeeded, stopped, being stopped or is waiting. 任务不能重试，因为任务已经成功、停止、正在停止或者等待中。 请确认任务是否处于成功、停止、正在停止或者等待中。 400 IOTDA.014219 Invalid input. The target is not in the task. 目标不在该任务中。 请确认该目标是否在该任务中。 400 IOTDA.014300 Operation not allowed. The number of certificates has reached the upper limit (%s). 证书数量达到上限。 证书数量已达到上限，请删除无用证书后重试，单租户下证书上限：100。 400 IOTDA.014301 Invalid certificate content. 证书内容不合法。 请检查证书内容是否符合X509格式要求，证书内容解析参考证书内容解析。 400 IOTDA.014302 Invalid input. The certificate (certificate_id: %s) already exists. 证书已存在。 您已上传相同内容证书，无需重复上传。 400 IOTDA.014303 Operation not allowed. Upload certificate failed. 证书上传失败。 请联系华为工程师分析解决。 400 IOTDA.014304 Operation not allowed. Delete certificate failed. 证书删除失败。 请联系华为工程师分析解决。 400 IOTDA.014305 Operation not allowed. Query certificate failed. 证书查询失败。 请联系华为工程师分析解决。 400 IOTDA.014307 Operation not allowed. The certificate failed to verify the verifyCode. 证书验证码校验失败。 校验证书的cn_name与当前CA证书的校验码不一致，请核对后重新生成校验证书认证。 400 IOTDA.014308 Operation not allowed. The certificate failed to verify the path. 校验证书路径失败。 校验证书路径与当前CA证书路径不一致，请确保两者是由同一个CA机构颁发。 400 IOTDA.014309 The certificate is expired or about to expire. The expiry date must be seven days later than current date. 证书即将过期或已过期。 请重新申请有效证书。 400 IOTDA.014310 The size of the certificate file cannot be larger than 1 MB and the file name must match the pattern ^[.a-zA-Z0-9_-]{1,255}$. 证书文件不能大于1MB且文件名必须符合^[.a-zA-Z0-9_-]{1,255}$正则。 请重新上传符合条件的证书。 400 IOTDA.014311 The certificate is in use and cannot be deleted. 该证书正在使用中无法删除。 请解除证书关联后再删除。 400 IOTDA.014312 Invalid input. The certificate scene does not exist. 证书场景不存在。 请确认请求参数是否正确。 400 IOTDA.014313 Invalid input. The certificate scene already exists. 证书场景已存在。 请确认请求参数是否正确。 400 IOTDA.014314 Invalid input. The server certificate does not exist. 服务器证书不存在。 请确认请求参数是否正确。 400 IOTDA.014315 Invalid input. The CA certificate does not exist. CA证书不存在。 请确认请求参数是否正确。 400 IOTDA.014316 Invalid input. Failed to parse the private key and certificate. 私钥与证书解析失败。 请检查私钥与证书是否合法是否匹配。 400 IOTDA.014318 Invalid input. The CA certificate not bind provisioning-template. CA证书未绑定模板。 请绑定模板后重试。 400 IOTDA.014320 Invalid input. The provisioning-template is not exist. 指定模板不存在。 请确认指定模板是否存在后重试。 400 IOTDA.014322 Invalid input. The same CA certificate has been bound provisioning-template in another application. 其他应用下已有相同CA证书绑定了模板。 请解绑其他应用下的证书模板后重试。 400 IOTDA.014602 Invalid input. The batch task file name already exists. 批量任务文件名已存在。 请更换文件名后重试。 400 IOTDA.014603 Invalid input. The size of the batch task file exceeds the upper limit. 批量任务文件的大小超过最大限制。 单个批量任务文件的大小最大限制为4M。 400 IOTDA.014604 Invalid input. The number of lines in the batch task file exceeds the upper limit. 批量任务文件行数超过最大限制。 单个批量文件行数最大限制为30000行。 400 IOTDA.014605 Invalid input. The resource-suffix of the batch task file is wrong. 批量任务文件后缀名错误。 请查阅上传批量任务文件页面“请求参数”部分并对参数file进行检查。 400 IOTDA.014606 Invalid input. Invalid batch task file name. 批量任务文件名不合法。 请查阅上传批量任务文件页面“请求参数”部分并对参数file进行检查。 400 IOTDA.014608 Invalid input. The content of batch task file is invalid. 批量任务文件内容不合法。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.014900 Invalid input. The search SQL contains unknown field.%s. 搜索SQL语句包含不识别的字段名。 请检查搜索SQL语句，修正不合法的字段，然后重试。 400 IOTDA.014901 Invalid input.The SQL statement contains invalid parameters.%s. 搜索SQL语句包含不合法的参数，或者数据类型与运算符不匹配。 请检查搜索SQL语句，修正不合法的参数，然后重试。 400 IOTDA.014902 Invalid input.The search SQL is invalid.%s. 搜索SQL语法错误。 请检查搜索SQL语句，参考文档使用正确的语法，然后重试。 400 IOTDA.015100 Invalid input. proxy_name is already exists. 设备代理名已存在。 请更换参数proxy_name后再重试。 400 IOTDA.015200 Invalid input. policy_name is already exists. 设备策略名已存在。 请更换参数policy_name后再重试。 400 IOTDA.015203 Invalid input. The bind target not exist or does not belong to the application. 绑定对象不存在或者绑定对象与设备策略不在同一资源空间下。 请排查请求参数是否有误并确认目标对象是否在对应资源空间下。 400 IOTDA.015205 Invalid input. The target has been bound to the device-policy. 目标对象已经绑定该设备策略。 目标对象已经绑定该设备策略，无需再绑定。 400 IOTDA.015206 Invalid input. The device-policy id does not exist. 设备策略id不存在。 设备策略id不存在，请检查参数是否有误。 400 IOTDA.015300 Invalid input. template_name is already exists. 模板名已存在。 请更换参数template_name后再重试。 400 IOTDA.015304 Invalid input. The parameter defined in the template does not exist. 证书信息不存在模板引用参数 请检查设备证书信息是否齐全。 400 IOTDA.015305 Invalid input. The field [template_body.resources.device.product_id] does not exist. 指定的产品id不存在。 请排查请求参数是否有误并确认产品id是否存在。 400 IOTDA.016000 Invalid input, The queue name already exist in the same spUserName. 队列名称在该用户下已存在。 请更换队列名称后重试。 400 IOTDA.016004 Invalid queue name. 队列名称不合法。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.016005 Invalid AMQP access configuration. amqp对接配置不合法。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.016006 Invalid HTTP access configuration. http对接配置不合法。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.016008 The integration configuration already exists. 对接配置已存在。 请排查请求参数是否符合华为云文档要求。 400 IOTDA.019304 Invalid input. Invalid obs info. obs信息无效。 请确认请求参数region_name、bucket_name、object_key是否正确。 400 IOTDA.019305 Invalid input. The format of the upgrade package is incorrect. 升级包格式不正确。 请参考华为云文档软固件包上传中升级包格式限制。 400 IOTDA.019306 Invalid input. The upgrade package size exceeds the limit. 升级包大小超过限制。 请参考华为云文档软固件包上传中升级包大小限制。 400 IOTDA.019600 Invalid input. The bridge name is duplicated. 网桥名称重复。 请确认是否已经创建了相同名称的网桥。 400 IOTDA.019603 Invalid input. The bridge ID is duplicated. 网桥ID重复。 请确认是否已经创建了相同ID的网桥。 400 IOTDA.019702 The tunnel has already closed. 隧道已关闭。 隧道已关闭，请重新创建隧道。 400 IOTDA.019708 Failed to deliver tunnel information to the device. 下发隧道配置通知给设备失败。 请确认设备运行正常且订阅了接收隧道通知的主题。 400 IOTDA.021304 The number of device log configurations exceeds the upper limit. 设备日志配置数量超过用户最大配额。 请关闭部分设备设备日志收集，然后再重新开启。 400 IOTDA.021310 Invalid input. The authorizer name is duplicated. 自定义鉴权名称重复。 请确认是否已经创建了相同名称的自定义鉴权器。 401 IOTDA.000002 Authentication failed. 鉴权失败。 请排查请求中的鉴权参数是否携带正确。 401 IOTDA.000025 SP user authentication failed. SP Token鉴权失败。 请检查sp token是否正确。 401 IOTDA.000026 Stage user authentication failed. stage token鉴权失败。 请检查stage token是否正确。 401 IOTDA.001003 Incorrect AppId or secret. 资源空间与密钥不匹配。 请排查该密钥是否正确。 401 IOTDA.014032 Invalid input. The time does not match. 时间不匹配。 请联系华为工程师解决。 401 IOTDA.019704 Invalid tunnel access token. tunnel_access_token不合法。 请确认请求参数是否正确。 401 IOTDA.019705 The tunnel access token is expired. tunnel_access_token已过期。 请重新创建隧道后重试。 403 IOTDA.000004 Invalid access token. 非法token。 请排查请求中的token是否正常。 403 IOTDA.000005 Refresh access token failed. 刷新token失败。 请排查请求中的refreshToken是否正确。 403 IOTDA.000015 The account is frozen. 账户已被冻结。 联系账户负责人进行解冻。 403 IOTDA.000021 Operation not allowed. User not found by IAM token or the authorized user has not subscribed to IoTDA. 没有找到IAM Token所对应的用户信息或该用户没有订阅 设备接入服务 （IOTDA）。 请排查IAM Token所在用户是否订阅了设备接入服务(IOTDA)。 403 IOTDA.000022 Operation not allowed. The user does not have the permission. 该用户没有权限。 请排查该用户是否有权限访问。 403 IOTDA.000023 Request frequency reached the upper limit %s. 请求已经达到限制速率。 请降低请求频率, 该请求速率已达到限制。 403 IOTDA.000024 Operation not allowed. Only one token is allowed in the request header. 请求头只能放置一个Token域。 请删除多余的token头域。 403 IOTDA.000028 System is being maintained. The configuration cannot be modified. 系统正在维护，请稍后重试。 请稍后重试。 403 IOTDA.000033 Operation not allowed. The current instance does not support the parameter. 当前实例规格不支持此功能参数。 请排查请求参数是否符合华为云文档要求。 403 IOTDA.000034 Operation not allowed. The user does not have the permission. 该用户没有权限。 请排查该用户是否有权限访问。 403 IOTDA.001000 The application does not exist. 该资源空间不存在。 请确定是否已在平台创建资源空间并检查资源空间ID是否正确。 403 IOTDA.001002 Operation not allowed. You do not have the permissions required to access the application. 该应用没有权限访问。 请检查该应用是否已被授权。 403 IOTDA.001005 Operation not allowed. The parameter 'app_id' is not carried, and the authorized user has more than one application. Include the parameter 'app_id', or contact Huawei technical support engineers to merge application data. 该用户下有多个应用的情况下未携带appId访问接口。 请携带对应的appId或联系华为工程师合并应用数据。 403 IOTDA.001006 Operation not allowed. Application not found by authorized user or the authorized user has no application. 用户下没有资源空间或资源空间与用户不匹配。 请排查用户下是否有资源空间或是否有指定的资源空间。 403 IOTDA.001007 Operation not allowed. The application does not belong to the authorized user. 资源空间与用户信息不匹配。 请排查该用户下是否有指定的资源空间。 403 IOTDA.001008 Operation not allowed. The app name already exists. 资源空间名称已存在。 请更换资源空间名称。 403 IOTDA.001009 Operation not allowed. The maximum number of applications has been reached. 资源空间数量已达到上限。 该用户资源空间数量已达到上限，请删掉多余的资源空间后再注册。 403 IOTDA.001010 Operation not allowed. The default app cannot be deleted. 禁止删除默认资源空间。 请修改参数后重试。 403 IOTDA.001014 Operation not allowed. The application does not belong to the authorized instance. 资源空间与实例信息不匹配。 请排查该实例下是否有指定的资源空间。 403 IOTDA.003002 Operation not allowed. The group name already exists. 设备组名称已被使用。 请更换设备组名称后重试，该设备组名称已被使用。 403 IOTDA.003003 Operation not allowed. Max groups (1,000) reached. 设备组数量已达到最大上限1000个。 请删除多余设备组后重试，该设备组数量已达上限。 403 IOTDA.003004 Operation not allowed. Max group depths (5) reached. 该设备组深度已达上限（5），不允许再次注册子设备组。 请更换深度较小的父设备组的ID进行注册，该群组深度已达上限，不允许再注册子群组。 403 IOTDA.003005 Operation not allowed. The device already exists in the group. 该设备在设备组中已存在。 该设备在设备组中已存在，无需再次添加。 403 IOTDA.003006 Operation not allowed. The device does not exist in the group. 该设备在设备组中不存在。 该设备在设备组中不存在，无需删除。 403 IOTDA.003007 Operation not allowed. Max devices (20,000) reached for the group. 设备组中的设备数量达到最大限制20000。 请删除多余设备或更换群组。 403 IOTDA.003008 Operation not allowed. A device can be added to up to 10 groups. 一个设备最多只能添加到10个设备组中。 请将该设备从多余的群组中删除后重试，该设备所在群组已达到最大限制。 403 IOTDA.003009 Operation not allowed. The parent group contains child groups. Delete the child groups and try again. 该设备组为其他设备组的父设备组，若想删除此群组，需先删除其子设备组。 如需删除该设备组，请先删除该群组下的所有子设备组后再执行该操作。 403 IOTDA.003010 Operation not allowed. The group contains devices and cannot be deleted. 该群组下存在设备，禁止删除。 如需删除，请先确保该设备组下的设备无用，删除该设备组下的所有设备后再删除该设备组。 403 IOTDA.003011 Operation not allowed. The group and device do not belong to the same application. 群组和设备不属于同一个资源空间。 请使用相同资源空间下的群组和设备进行操作。 403 IOTDA.004001 Operation not allowed. Max bindable tags (10) reached for the device. 设备绑定的标签数量超过最大限制10。 请删除多余的标签再进行绑定，该设备已绑定标签数达到最大限制。 403 IOTDA.005000 Operation not allowed. Only one task can be started for a device at a time. 一个设备同时只能开启一个任务。 请手动操作任务结束或者等待当前任务完成后再开启另一个任务。 403 IOTDA.005001 Operation not allowed. The protocol of the device does not support upgrade. 该设备的协议类型不支持升级。 请提交工单 联系华为工程师分析解决。 403 IOTDA.009001 Max application subscription records reached. 应用订阅记录数达到上限。 请删除多余订阅记录，该应用订阅数量已达到上限。 403 IOTDA.009008 The maximum number of queries has been reached. 查询数量超过最大限制。 请排查请求参数是否符合华为云文档要求。 403 IOTDA.010003 The number of rules has reached the upper limit. 规则数量已达到上限。 请删除多余的规则后重试。 403 IOTDA.010037 The rule cannot be deleted because actions exist in the rule. 规则中已存在动作，不能删除规则。 请先删除规则动作，再删除规则。 403 IOTDA.010049 Operation not allowed. Total number of flow control policies exceeds the upper limit (4). 流控策略配置数量超过最大限制4。 请删除多余的流控策略配置后重新创建。 403 IOTDA.013004 Operation not allowed. You have no write permission. 您没有可写的权限。 请排查您的产品属性是否是可写的，若不是，可调用修改产品的接口将属性改成可写。 403 IOTDA.013006 The number of products in the application has reached the upper limit. 该资源空间下产品数量达到上限（1000）。 请删除无用的产品后重试。 403 IOTDA.013007 Operation not allowed. The product is in use and cannot be deleted. 产品已被使用，禁止删除。 删除产品需先删除该产品下设备，如需删除，请确保该产品没有关联设备，再重试删除操作。 403 IOTDA.013009 Operation not allowed. The value of default_value must be writable. default_value必须属于可写属性。 请通过修改产品的接口将该属性设置成可写。 403 IOTDA.013011 Operation not allowed. The number of assets properties has reached the upper limit (%s). 产品资产属性定义个数超过上限。 请删除无用的资产属性定义。 403 IOTDA.013013 Operation not allowed. The protocol type cannot be changed to CoAP. 产品协议类型不支持修改为CoAP。 请重新创建CoAP协议类型产品。 403 IOTDA.013503 Operation not allowed. The number of topics in a product exceeds the upper limit (%s). 一个产品下的主题数量超过最大限制。 请删除无用的主题后再重试。 403 IOTDA.014003 Operation not allowed. The number of frozen devices has reached the upper limit. 冻结设备的数量已达到上限。 请将非必须冻结的设备解冻后再次冻结该设备或联系华为工程师处理。 403 IOTDA.014004 Operation not allowed. This device is online. 该操作只允许设备在“离线”状态下执行。 请使设备调整为“离线”状态，再重试操作。 403 IOTDA.014005 Operation not allowed. This device is not active. 该操作只允许在设备激活后执行。 请先将设备激活。 403 IOTDA.014006 Operation not allowed. The secret cannot be reset. 密码无法被重置。 NB设备未使用密钥，无需重置密钥。 403 IOTDA.014007 Operation not allowed. The PSK cannot be reset. PSK无法被重置。 请修改参数后重试。 403 IOTDA.014015 Operation not allowed. The number of concurrent location service requests has exceeded the upper limit. 位置服务请求的并发超过上限。 请降低接口调用频率。 403 IOTDA.014016 Operation not allowed. The device is not online. 该操作只允许设备在线后执行。 请将设备接入后再重试。 403 IOTDA.014018 Operation not allowed. The device has been frozen and cannot be operated. 该设备是冻结状态，不允许操作。 请将设备解冻后再重试。 403 IOTDA.014019 Operation not allowed. The number of devices of the user has reached the upper limit. 用户下的设备数量达到上限。 请删除无用设备或联系华为工程师分析解决。 403 IOTDA.014020 Operation not allowed. The number of devices bound to this application has reached the upper limit. 资源空间下的设备数量超过最大上限。 请删除无用设备或联系华为工程师分析解决。 403 IOTDA.014021 Operation not allowed. The number of devices has reached the upper limit of the package. 套餐下的设备数量超过最大上限。 请删除无用设备或联系华为工程师分析解决。 403 IOTDA.014022 Operation not allowed. The number of license resources has reached the upper limit. 许可证资源数量已达到上限。 请联系华为工程师分析解决。 403 IOTDA.014024 Operation not allowed. The device already has an endpoint. 该网关已关联子设备，无法直接删除。 删除网关前，必须删除其关联的子设备，如需删除，请确保子设备无用或关联至其他网关，再重试网关删除操作。 403 IOTDA.014026 Operation not allowed. The number of non-security devices has reached the upper limit. 非安全设备的数量已达到上限。 请删除无用的非安全设备或联系华为工程师分析解决。 403 IOTDA.014029 Operation not allowed. The timeout parameter cannot be modified when the device has been activated. 设备激活后不能修改timeout参数。 取消timeout参数的修改或在未激活的设备下操作。 403 IOTDA.014036 Operation not allowed. The device service capabilities are not defined in the product. 该设备的产品未定义设备服务能力。 请使用修改产品接口将该产品添加设备服务能力。 403 IOTDA.014037 Operation not allowed. Max device depths (2 levels) reached. 该设备深度已达到上限（2）。 当前网关最多支持二级子设备。 403 IOTDA.014038 Operation not allowed. Only gateways or directly connected devices are supported. 该操作只支持网关或者直连设备。 请选择直连设备或者网关设备进行操作。 403 IOTDA.014039 Operation not allowed. The device has already been frozen. 该设备是冻结状态，无法操作。 请解冻设备后再进行操作。 403 IOTDA.014040 Operation not allowed. The device is not frozen and cannot be unfrozen. 该设备不是冻结状态，无法解冻。 只能对冻结状态的设备进行解冻操作。 403 IOTDA.014041 Operation not allowed. The device does not belong to the currently connected gateway. 该设备不属于当前连接的网关。 请选择当前连接网关下的子设备进行操作。 403 IOTDA.014101 The number of commands reached the upper limit. 该资源空间下的缓存命令数量达到上限。 请等待缓存命令下发后再下发新命令,或增大缓存命令数。 403 IOTDA.014106 Invalid CommandBody for the MQTT protocol. 适用于mqtt协议的CommandBody不正确。 命令下发接口参数必须为json格式，请确认下发的参数是否正确。 403 IOTDA.014109 Operation not allowed. The command status is not 'PENDING'. 不允许操作，命令的状态不是PENDING。 请联系华为工程师解决。 403 IOTDA.014133 Operation not allowed. The topic has no 'SUBSCRIBE' permission. 操作不允许，该主题没有SUBSCRIBE权限。 请联系华为工程师解决。 403 IOTDA.014202 Operation not allowed. The number of unfinished tasks has reached the upper limit (%s). 未完成的任务数量达到上限。 执行中的批量任务数量已经超出规格限制，请停止未完成任务再重试。 403 IOTDA.014206 Operation not allowed. The number of targets has reached the upper limit (%s). targets数量超过上限。 请排查请求参数是否符合华为云文档要求。 403 IOTDA.014217 Operation not allowed. The target cannot retry because the task of target has succeeded, is waiting or is processing. 目标不能重试，因为目标的任务已经成功、等待中或者正在执行中。 请确认该目标任务是否已经成功、等待中或者正在执行中。 403 IOTDA.014218 Operation not allowed. The target cannot stop because the task of target has succeeded, failed or stopped. 目标不能停止，因为目标的任务已经成功，失败或者停止。 请确认该目标任务是否已经成功，失败或者停止。 403 IOTDA.014220 Operation not allowed. The task type is not supported. 不支持该任务类型。 请确认任务类型是否支持该操作。 403 IOTDA.014221 Invalid input. The task cannot be deleted because it is not completed. 任务不能删除，因为任务没有完成。 请检查任务状态是否为成功，失败，部分成功或已停止。 403 IOTDA.014319 Operation not allowed. The CA certificate state is not verified, please verify the certificate first. CA证书状态是未验证，请先校验CA证书。 请验证CA证书后重试。 403 IOTDA.014601 Operation not allowed. The number of batch task files of the current user exceeds the upper limit. 当前用户下的批量任务文件数达到上限。 请删除多余文件后重试。 403 IOTDA.014607 Operation not allowed. The batch task file is in use and cannot be deleted. 该批量任务文件正在使用，不能被删除。 请等待任务完成后再操作。 403 IOTDA.015101 Operation not allowed. The device already exists in the other device-proxy. 设备已存在于其他设备代理中，不允许添加到当前设备代理。 请更换代理设备后重试。 403 IOTDA.015102 Operation not allowed. The endpoint device is not allowed to be added to device-proxy. 子设备不允许添加至设备代理中。 子设备不允许添加至代理中，请更换设备后重试。 403 IOTDA.015104 Operation not allowed. The number of device-proxy has reached the upper limit (10). 设备代理数量已达到最大上限。 请删除多余代理设备后重试。 403 IOTDA.015201 Operation not allowed. The number of device-policy has reached the upper limit (%s). 设备策略数量已经达到上限。 请删除多余的设备策略后再重试。 403 IOTDA.015204 Operation not allowed. The number of policies bound to the target reaches the upper limit. 目标对象绑定的设备策略数量达到上限。 请为目标对象解绑无用的设备策略后重试。 403 IOTDA.015303 Operation not allowed. The provisioning-template is associated by certificate. 模板被证书关联中，不允许删除。 请在设备CA证书中解除关联后重试。 403 IOTDA.015306 Operation not allowed. The number of provisioning-template has reached the upper limit (10). 模板数量达到上限。 请删除不需要的模板后重试。 403 IOTDA.016001 Operation not allowed, The number of queues exceeds the limit for each spUserName. 队列数量已达到用户最大配额。 单个租户只能创建100个AMQP队列。 403 IOTDA.016003 Operation not allowed. The queue is in use. 该队列已被使用。 请取消该队列相应的订阅后再进行操作。 403 IOTDA.016009 Operation not allowed. The number of queues exceeds the system limit. 队列数量已达到系统最大配额。 请联系华为工程师分析解决。 403 IOTDA.019303 Operation not allowed. The number of packages for the user has reached the upper limit. 用户下的升级包数量达到上限。 请删除无用升级包。 403 IOTDA.019601 Operation not allowed. The number of bridges in the system has reached the upper limit. 租户下的网桥数已经达到最大值。 请确认租户下的网桥数量是否已经为20个。 403 IOTDA.019701 Operation not allowed. The device does not belong to the authorized user. 设备不属于该用户。 设备不属于该用户，请确认设备ID是否正确。 403 IOTDA.019703 The open tunnel cannot be deleted. 处于打开状态的隧道不能被删除。 请先关闭设备隧道后再进行删除。 403 IOTDA.019706 Operation not allowed. The number of tunnels for a device has reached the upper limit. 单设备的隧道个数已达到限制值。 请删除老的设备隧道后再进行重试。 403 IOTDA.019707 Operation not allowed. The number of device tunnels for a user has reached the upper limit. 租户的设备隧道个数已达到限制值。 请删除老的设备隧道后再进行重试。 403 IOTDA.021311 Operation not allowed. The number of authorizer has reached the upper limit(10). 租户下的自定义鉴权数已经达到最大值。 请确认租户下的自定义鉴权数是否已经为10个。 403 IOTDA.021313 The function does not exist. 该函数在FunctionGraph不存在。 请确认该函数是否在FunctionGraph是否已经创建。 404 IOTDA.000016 Target not found. 未找到目标。 请联系华为工程师分析解决。 404 IOTDA.000029 Invalid input. The path does not exist. 请求路径不存在。 请检查请求路径是否正确。 404 IOTDA.003000 The group does not exist. 群组不存在。 请确认是否有该设备组或设备组参数是否携带正确。 404 IOTDA.003001 The parent group does not exist. 父级设备组不存在。 请确认是否有该设备组或设备组参数是否携带正确。 404 IOTDA.004000 The resource does not exist. 资源不存在。 请确认请求参数是否正确。如deviceId， resourceId等。 404 IOTDA.009003 The subscription subject cannot be found. 查询不到该订阅记录。 请确认请求中的参数是否与待操作的订阅匹配。 404 IOTDA.010002 The rule does not exist. 该规则不存在。 请确认平台是否存在该规则或请求参数是否正确。 404 IOTDA.010020 The rule action does not exist. 规则动作不存在。 请确认平台是否存在该规则动作或请求参数是否正确。 404 IOTDA.010043 The stack policy does not exist. 积压策略配置不存在。 请确认平台是否存在对应积压策略配置或请求参数是否正确。 404 IOTDA.010046 The flow control policy does not exist. 流控策略配置不存在。 请确认平台是否存在对应流控策略配置或请求参数是否正确。 404 IOTDA.013014 The product does not exist. 产品不存在。 请排查请求参数是否正确或产品是否已经在平台注册。 404 IOTDA.013500 The topic does not exist. 该主题不存在。 请联系华为工程师解。 404 IOTDA.014000 The device does not exist. 设备不存在。 请排查请求参数是否有误并确认是否有在平台注册该设备。 404 IOTDA.014014 The IMSI does not exist. IMSI参数值不能为空。 请输入非空IMSI值后重试。 404 IOTDA.014042 The device access information does not exist. 设备接入信息不存在。 请检查设备是否接入平台并激活。 404 IOTDA.014103 The device command does not exist. 设备命令不存在。 请确认请求参数是否正确。 404 IOTDA.014131 The message does not exist. 该消息不存在。 请联系华为工程师解决。 404 IOTDA.014200 The batch task does not exist. 该任务不存在。 请排查请求参数中的task_id是否有效。 404 IOTDA.014306 The certificate does not exist. 证书不存在。 目标证书id不存在，请确认请求参数是否正确。 404 IOTDA.014600 The batch task file does not exist. 批量任务不存在。 请确认请求参数是否正确。 404 IOTDA.015105 device-proxy not exist or does not belong to the application. 设备代理不存在或者代理不在指定的资源空间下。 请排查请求参数是否有误并确认是否有在资源空间注册该设备代理。 404 IOTDA.015202 Invalid input. device-policy not exist or does not belong to the application. 设备策略不存在或者设备策略不在指定的资源空间下。 请排查请求参数是否有误并确认是否有在资源空间创建该设备策略。 404 IOTDA.015301 provisioning-template does not exist. 指定模板不存在。 请排查请求参数是否有误并确认资源是否存在。 404 IOTDA.016002 The queue ID does not exist. 队列ID不存在。 请确认请求参数是否正确。 404 IOTDA.019300 The package does not exist. 升级包不存在。 请确认是否有该升级包或请求参数package_id是否携带正确。 404 IOTDA.019602 Invalid input. The bridge does not exist. 指定网桥不存在。 请确认该网桥是否已经创建。 404 IOTDA.019700 Invalid input. The tunnel does not exist. 隧道不存在。 请确认是否有隧道创建成功并且隧道ID填写正确。 404 IOTDA.021312 The authorizer does not exist. 该自定义鉴权不存在。 请确认该自定义鉴权是否已经创建。 405 IOTDA.000003 The request method is not supported. 不支持该请求方式。 请排查请求方式是否与文档中的保持一致。 405 IOTDA.000019 Method not allowed. http请求中的请求方法不正确。 请排查请求方式是否与文档中的保持一致。 406 IOTDA.000037 Invalid input. The Accept is missing or not supported in the request header. 请求头中缺少或携带了不支持的Accept。 请排查请求头中是否携带了正确的Accept。 409 IOTDA.014030 The version of the serviceId %s conflicts with another one. 该serviceId的版本号冲突。 请使用正确的版本号进行配置。 409 IOTDA.014047 Device status update conflicts occur. 设备状态更新冲突。 请检查是否重复发送请求或网关设备已下线。 415 IOTDA.000036 Invalid input. The Content-Type is missing or not supported in the request header. 请求头中缺少或携带了不支持的Content-Type。 请排查请求头中是否携带了正确的Content-Type。 429 IOTDA.014102 Congestion occurs. The network is under flow control. 发生拥堵， 并且当前网络受到流量控制。 请联系华为工程师解决。 500 IOTDA.000001 Internal server error. 服务器内部错误。 请联系华为工程师分析解决。 500 IOTDA.000007 The data in database is abnormal. 数据库中的数据不正常。 请联系华为工程师分析解决。 500 IOTDA.000020 Decrypt IAM token failed. IAM Token解析失败。 请联系华为工程师分析解决。 父主题： 附录

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 device_proxies Array of QueryDeviceProxySimplify objects 代理设备列表 page Page object 查询结果的分页信息。 表5 QueryDeviceProxySimplify 参数 参数类型 描述 proxy_id String 参数说明：设备代理ID。用来唯一标识一个代理规则 proxy_name String 参数说明：设备代理名称 effective_time_range EffectiveTimeRangeResponseDTO object 参数说明：规则有效期 app_id String 参数说明：资源空间ID。 表6 EffectiveTimeRangeResponseDTO 参数 参数类型 描述 start_time String 设备代理开始生效的时间，使用UTC时区，格式：yyyyMMdd'T'HHmmss'Z' end_time String 设备代理失效的时间，必须大于start_time，使用UTC时区，格式：yyyyMMdd'T'HHmmss'Z' 表7 Page 参数 参数类型 描述 count Long 满足查询条件的记录总数。 marker String 本次分页查询结果中最后一条记录的ID，可在下一次分页查询时使用。

响应示例 状态码： 200 OK { "device_proxies" : [ { "proxy_id" : "04ed32dc1b0025b52fe3c01a27c2babc", "proxy_name" : "testProxyName", "app_id" : "jeQDJQZltU8iKgFFoW060F5SGZka", "effective_time_range" : { "start_time" : "20200812T121212Z", "end_time" : "20210812T121212Z" } } ], "page" : { "count" : 1, "marker" : "66178add3b98944277731d0a" } }

URI GET /v5/iot/{project_id}/device-proxies 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID 。 表2 Query参数 参数 是否必选 参数类型 描述 app_id 否 String 参数说明：资源空间ID。此参数为非必选参数，存在多资源空间的用户需要使用该接口时，可以携带该参数查询指定资源空间下的设备代理列表，不携带该参数则会查询该用户下所有设备代理。 取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 proxy_name 否 String 参数说明：设备代理名称。 取值范围：长度不超过64，只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。 最小长度：1 最大长度：64 limit 否 Integer 参数说明：分页查询时每页显示的记录数。 取值范围：1-50的整数，默认值为10。 最小值：1 最大值：50 缺省值：10 marker 否 String 参数说明：上一次分页查询结果中最后一条记录的ID，在上一次分页查询时由 物联网平台 返回获得。分页查询时物联网平台是按marker也就是记录ID降序查询的，越新的数据记录ID也会越大。若填写marker，则本次只查询记录ID小于marker的数据记录。若不填写，则从记录ID最大也就是最新的一条数据开始查询。如果需要依次查询所有数据，则每次查询时必须填写上一次查询响应中的marker值。 取值范围：长度为24的十六进制字符串，默认值为ffffffffffffffffffffffff。 缺省值：ffffffffffffffffffffffff offset 否 Integer 参数说明：表示从marker后偏移offset条记录开始查询。默认为0，取值范围为0-500的整数。当offset为0时，表示从marker后第一条记录开始输出。限制offset最大值是出于API性能考虑，您可以搭配marker使用该参数实现翻页，例如每页50条记录，1-11页内都可以直接使用offset跳转到指定页，但到11页后，由于offset限制为500，您需要使用第11页返回的marker作为下次查询的marker，以实现翻页到12-22页。 取值范围：0-500的整数，默认为0。 最小值：0 最大值：500 缺省值：0

示例 Topic: $oc/devices/{device_id}/sys/events/up 数据格式： { "object_device_id": "{object_device_id}", "services": [{ "service_id": "$file_manager", "event_type": "get_upload_url", "event_time": "20151212T121212Z", "paras": { "file_name": "a.jpg", "file_attributes": { "hash_code": "58059181f378062f9b446e884362a526", "size": 1024 } } }] }

修订记录 发布日期 修订记录 2024-06-25 第四十一次正式发布 新增 创建设备策略 查询设备策略列表 删除设备策略 查询设备策略详情 更新设备策略信息 绑定设备策略 解绑设备策略 查询设备策略绑定的目标列表 创建预调配模板 查询预调配模板列表 删除预调配模板 查询预调配模板详情 更新指定id的预调配模板信息 创建自定义鉴权 查询自定义鉴权列表 删除自定义鉴权 查询自定义鉴权详情 更新指定id的自定义鉴权 2024-05-30 第四十次正式发布 新增 创建网桥 查询网桥列表 删除网桥 重置网桥密钥 更新CA证书 2024-04-26 第三十九次正式发布 新增 创建设备代理 查询设备代理列表 查询设备代理详情 修改设备代理 删除设备代理 2024-04-11 第三十八次正式发布 新增 新建数据流转积压策略 查询数据流转积压策略列表 修改数据流转积压策略 查询数据流转积压策略 删除数据流转积压策略 新建数据流转流控策略 查询数据流转流控策略列表 修改数据流转流控策略 查询数据流转流控策略 删除数据流转流控策略 2024-03-29 第三十七次正式发布 新增 更新资源空间 修改 创建批量任务、查询批量任务列表、查询批量任务接口，新增task_mode参数用于软固件升级任务支持网关模式，task_ext_info参数用于支持添加批量任务的额外扩展信息。 2024-03-13 第三十六次正式发布 修改 上传设备CA证书、获取设备CA证书列表接口新增返回参数，provision_enable参数用于确认该CA证书是否开启自注册能力，template_id参数为开启自注册能力后关联的模板ID。 2024-02-27 第三十五次正式发布 修改 创建规则、查询规则列表、修改规则、查询规则接口，调整ActionSmnForwarding结构中的message_content参数为非必选参数，调整message_title参数的取值范围，新增message_template_name参数用于提供选择 SMN 模板的能力。 2024-01-05 第三十四次正式发布 修改 生成接入凭证：新增参数force_disconnect，用于生成接入凭证时供用户选择是否强制断开北向MQTT/AMQP的连接。 2023-12-06 第三十三次正式发布 修改 重置设备密钥：新增参数secret_type，用于设置/更新设备辅密钥。 重置设备指纹：新增参数fingerprint_type，用于设置/更新设备辅指纹。 查询设备、创建设备、修改设备：新增响应参数secondary_secret、secondary_fingerprint，用于查询出设备的辅指纹/辅密钥。 2023-11-15 第三十二次正式发布 修改创建规则动作、修改规则动作、查询规则动作列表、查询规则动作接口。 调整dms_kafka_forwarding结构中的mechanism参数枚举值，新增security_protocol参数用以完整的支持kafka的安全认证能力。 新增http_forwarding结构中的signature_enable、token参数，用以提供HTTP推送多样化的安全认证能力。 2023-10-23 第三十一次正式发布 修改 查询产品列表，新增product_name入参，支持产品名称检索能力。 2023-07-21 第三十次正式发布 新增 删除批量任务 创建设备隧道 查询设备所有隧道 查询设备隧道 关闭设备隧道 删除设备隧道 2023-06-17 第二十九次正式发布 新增 重试批量任务 停止批量任务 修改 设备同步命令、修改设备属性接口，增加响应参数error_code、error_msg，用以支持返回同步操作时设备的异常行为，如超时未响应。 2023-05-13 第二十八次正式发布 修改 添加设备组、修改设备组、查询设备组列表、查询设备组接口，新增group_type、dynamic_group_rule参数，用以支持动态设备组能力。 2023-04-19 第二十七次正式发布 新增 下发广播消息接口。 修改 创建批量任务、查询批量任务列表、查询批量任务，修改task_type参数，增加支持"updateDevices"枚举值，用以支持批量更新设备任务。 2023-03-29 第二十六次正式发布 修改 创建规则、修改规则、查询规则列表、查询规则接口，新增device_linkage_status_condition参数，用于支持设备状态变化的联动规则条件。 2023-02-24 第二十五次正式发布 新增 创建OTA升级包 查询OTA升级包列表 查询OTA升级包详情 删除OTA升级包 修改 修改查询设备接口，新增响应参数connection_status_update_time、active_time参数用以查询设备的连接状态变更时间和激活时间。 2023-02-07 第二十四次正式发布 修改 创建规则动作、修改规则动作、查询规则动作列表、查询规则动作接口，新增dms_rocketmq_forwarding、mrs_kafka_forwarding、roma_forwarding、influxdb_forwarding参数用以支持对rocketmq、kafka、roma、influxdb的消息流转能力。 2022-12-14 第二十三次正式发布 新增 灵活搜索设备列表接口。 修改 修改创建规则、修改规则、查询规则列表、查询规则接口，新增rule_type参数的枚举值"DEVICE_SIDE"，用以支持设备端测规则联动的能力。 2022-09-20 第二十二次正式发布 修改下发设备消息、查询设备消息接口，新增properties参数用于支持MQTT5.0特性能力。 2022-03-21 第二十一次正式发布 新增 重置设备指纹接口。 2021-06-18 第二十次正式发布 修改 修改应用侧API接口参数的类型： 去除长度描述。 对象参数增加“Object”。 2021-05-28 第十九次正式发布 修改 修改应用侧API接口请求参数描述，增加参数说明和取值范围。 2021-02-08 第十八次正式发布 新增 设备添加通知、设备更新通知接口中，增加device_sdk_version字段类型。 2020-12-21 第十七次正式发布 修改 查询设备、修改设备接口中，补充secret字段和timeout字段说明。 2020-12-07 第十六次正式发布 新增 查询规则条件列表、创建规则触发条件、查询规则条件、修改规则触发条件接口中，增加resource字段类型。 2020-11-03 第十五次正式发布 新增 查询规则动作列表、创建规则动作、查询规则动作、修改规则动作、删除规则动作接口中，增加规则动作的类型。 2020-10-30 第十四次正式发布 修改 原规则管理接口删除了响应参数DATA_FORWARDING、EDGE，仅支持设备联动规则，并更名为设备联动规则。如需数据转发功能，可使用接口数据流转规则管理。 2020-09-17 第十三次正式发布 新增 网关新增子设备请求 网关新增子设备请求响应 网关删除子设备请求 网关删除子设备请求响应 2020-09-11 第十二次正式发布 新增 查询AMQP列表 创建AMQP队列 查询单个AMQP队列 删除AMQP队列 生成接入凭证 流转数据 数据流转规则管理 2020-08-21 第十一次正式发布 新增 下发异步设备命令 查询指定id的命令 补充错误码中文描述和处理建议。 2020-08-18 第十次正式发布 修改 设备上报获取文件上传URL请求、平台下发文件上传临时URL、设备上报获取文件下载URL请求、平台下发文件下载临时URL接口中，增加扩展参数file_attribute。 新增 设备属性上报和网关批量设备属性上报接口中，event_time字段，时间格式支持毫秒级别。 2020-08-10 第九次正式发布 新增 创建批量任务task_type参数中，新增freezeDevices和unfreezeDevices字段，支持批量冻结设备、批量解冻设备。 2020-07-17 第八次正式发布 新增 查询资源空间列表 创建资源空间 查询资源空间 删除资源空间 2020-06-28 第六次正式发布 新增 在冻结设备和解冻设备中，补充IOTDA.014038和IOTDA.014039错误码，以及错误码描述信息。 补充IOTDA.000022错误码描述信息。 补充文档修订记录。 2020-06-24 第五次正式发布 新增 冻结设备 解冻设备 查询批量任务文件列表 上传批量任务文件 删除批量任务文件 模组AT指令参考 2020-06-08 第四次正式发布 修改 批量任务，删除freezeDevices和unfreezeDevices参数。 新增通过 API Explorer 中直接运行调试该接口。 修改X-Auth-Token参数的描述信息。 创建设备，修改app_id参数的描述信息。 2020-06-02 第三次正式发布 新增 设备上报获取文件上传URL请求 平台下发文件上传临时URL 设备上报文件上传结果 设备上报获取文件下载URL请求 平台下发文件下载临时URL 设备上报文件下载结果 2020-05-26 第二次正式发布 修改 设备侧获取平台的设备影子数据，修改request_id的描述。 2020-03-03 第一次正式发布 应用侧API参考 设备侧MQTT/MQ TTS 接口参考

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 message_id String 设备消息ID，用于唯一标识一条消息，在下发设备消息时由物联网平台分配获得。 name String 消息名称,在下发消息时由用户指定。 message Object 消息内容。 encoding String 消息内容编码格式，取值范围none|base64,默认值none, base64格式仅支持透传。 payload_format String 有效负载格式，在消息内容编码格式为none时有效，取值范围standard|raw，默认值standard（平台封装的标准格式），取值为raw时直接将消息内容作为有效负载下发。 topic String 消息topic properties PropertiesDTO object 消息下行到设备的属性参数。 status String 消息状态，包含PENDING，DELIVERED，FAILED和TIMEOUT，PENDING指设备不在线，消息被缓存起来，等设备上线之后下发； DELIVERED指消息发送成功；FAILED消息发送失败；TIMEOUT指消息在平台默认时间内（1天）还没有下发送给设备，则平台会将消息设置为超时，状态为TIMEOUT。 error_info ErrorInfoDTO object 消息下发失败信息。 created_time String 消息的创建时间，"yyyyMMdd'T'HHmmss'Z'"格式的UTC字符串。 finished_time String 消息结束时间, "yyyyMMdd'T'HHmmss'Z'"格式的UTC字符串，包含消息转换到DELIVERED和TIMEOUT两个状态的时间。 表4 PropertiesDTO 参数 参数类型 描述 correlation_data String 参数说明：MQTT 5.0版本请求和响应模式中的相关数据，可选。用户可以通过该参数配置MQTT协议请求和响应模式中的相关数据。 取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。 response_topic String 参数说明：MQTT 5.0版本请求和响应模式中的响应主题，可选。用户可以通过该参数配置MQTT协议请求和响应模式中的响应主题。 取值范围：长度不超过128, 只允许字母、数字、以及_-?=$#+/等字符的组合。 最大长度：128 user_properties Array of UserPropDTO objects 参数说明：用户自定义属性，可选。用户可以通过该参数配置用户自定义属性。可以配置的最大自定义属性数量为20。 表5 UserPropDTO 参数 参数类型 描述 prop_key String 参数说明：用户自定义属性键。 取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。 prop_value String 参数说明：用户自定义属性值。 取值范围：长度不超过128，只允许中文、字母、数字、以及_? '#().,&%@!-等字符的组合。 表6 ErrorInfoDTO 参数 参数类型 描述 error_code String 参数说明：异常信息错误码，包含IOTDA.014016和IOTDA.014112。IOTDA.014016表示设备不在线；IOTDA.014112表示设备没有订阅topic。 error_msg String 参数说明：异常信息说明，包含设备不在线和设备没有订阅topic说明。

响应示例 状态码： 200 OK { "message_id" : "b1224afb-e9f0-4916-8220-b6bab568e888", "name" : "message_name", "message" : "string", "topic" : "string", "status" : "PENDING", "created_time" : "20151212T121212Z", "finished_time" : "20151212T121212Z" }

URI GET /v5/iot/{project_id}/devices/{device_id}/messages/{message_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID 。 device_id 是 String 参数说明：下发消息的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。 message_id 是 String 参数说明：下发消息的消息ID，用于唯一标识一个消息，在消息下发时由物联网平台分配获得。 取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。 最小长度：1 最大长度：36

URI DELETE /v5/iot/{project_id}/batchtasks/{task_id} 表1 路径参数 参数 是否必选 参数类型 描述 task_id 是 String 参数说明：批量任务ID，创建批量任务时由物联网平台分配获得。 取值范围：长度不超过24，只允许小写字母a到f、数字的组合。 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID 。

响应示例 状态码： 201 Created { "action_id" : "1a7ffc5c-d89c-44dd-8265-b1653d951ce1", "rule_id" : "1a7ffc5c-d89c-44dd-8265-b1653d951ce0", "app_id" : "1a7ffc5cd89c44dd8265b1653d951ce0", "channel" : "HTTP_FORWARDING", "channel_detail" : { "http_forwarding" : { "url" : "http://host:port/callbackurltest" } } }

请求示例 创建规则动作，推送至http服务器。 POST https://{endpoint}/v5/iot/{project_id}/routing-rule/actions { "rule_id" : "1a7ffc5c-d89c-44dd-8265-b1653d951ce0", "channel" : "HTTP_FORWARDING", "channel_detail" : { "http_forwarding" : { "url" : "http://host:port/callbackurltest" } } } 创建规则动作，推送至obs。 POST https://{endpoint}/v5/iot/{project_id}/routing-rule/actions { "rule_id" : "1a7ffc5c-d89c-44dd-8265-b1653d951ce0", "channel" : "OBS_FORWARDING", "channel_detail" : { "obs_forwarding" : { "file_path" : "yourPath", "project_id" : "yourProjectId", "bucket_name" : "yourBucket_name", "region_name" : "yourRegion" } } } 创建规则动作，推送至amqp队列。 POST https://{endpoint}/v5/iot/{project_id}/routing-rule/actions { "rule_id" : "1a7ffc5c-d89c-44dd-8265-b1653d951ce0", "channel" : "AMQP_FORWARDING", "channel_detail" : { "amqp_forwarding" : { "queue_name" : "yourQueueName" } } } 创建规则动作，推送至mysql数据库。 POST https://{endpoint}/v5/iot/{project_id}/routing-rule/actions { "rule_id" : "1a7ffc5c-d89c-44dd-8265-b1653d951ce0", "channel" : "MYSQL_FORWARDING", "channel_detail" : { "mysql_forwarding" : { "address" : { "ip" : "yourIp", "port" : 3306 }, "username" : "userName", "password" : "passworld", "db_name" : "yourDBName", "table_name" : "yourTableName", "enable_ssl" : true, "column_mappings" : [ { "column_name" : "serviceId", "json_key" : "notify_data.body.services[0].service_id" } ] } } }

响应示例 状态码： 201 Created { "app_id" : "jeQDJQZltU8iKgFFoW060F5SGZka", "topic_full_name" : "$oc/broadcast/test", "message_id" : "b1224afb-e9f0-4916-8220-b6bab568e888", "created_time" : "20151212T121212Z" }

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 app_id String 参数说明：资源空间ID。 topic_full_name String 参数说明：接收广播消息的完整Topic名称 最大长度：128 message_id String 消息id，由物联网平台生成，用于标识该消息。 created_time String 消息的创建时间，"yyyyMMdd'T'HHmmss'Z'"格式的UTC字符串。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。

示例 Topic: $oc/devices/{device_id}/sys/events/up 数据格式： { "object_device_id": "{object_device_id}", "services": [{ "service_id": "$ota", "event_type": "version_report", "event_time": "20151212T121212Z", "paras": { "sw_version": "v1.0", "fw_version": "v1.0" } }] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 policy_id String 参数说明：数据流转积压策略id，用于唯一标识一个数据流转积压策略，在创建数据流转积压策略时由物联网平台分配获得。 policy_name String 参数说明：数据流转积压策略名称。 取值范围：长度不超过256，只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。 最小长度：1 最大长度：256 description String 参数说明：用户自定义的数据流转积压策略描述。 取值范围：长度不超过256，只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。 最小长度：1 最大长度：256 backlog_size Integer 参数说明：数据积压大小。单位为B（字节），取值范围为0~1073741823的整数，默认为1073741823（即1GB）。当backlog_size为0时，表示不积压。若同时配置了backlog_size和backlog_time两个维度，则以最先达到阈值的维度为准。 最小值：0 最大值：1073741823 缺省值：1073741823 backlog_time Integer 参数说明：数据积压时间。单位为s（秒），取值范围为0~86399的整数，默认为86399（即1天）。当backlog_time为0时，表示不积压。若同时配置了backlog_size和backlog_time两个维度，则以最先达到阈值的维度为准。 最小值：0 最大值：86399 缺省值：86399

URI GET /v5/iot/{project_id}/routing-rule/backlog-policy/{policy_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID 。 policy_id 是 String 参数说明：数据流转积压策略id，用于唯一标识一个数据流转积压策略，在创建数据流转积压策略时由物联网平台分配获得。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，一般华为云租户无需携带该参数，仅在物理多租场景下从管理面访问API时需要携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 devices Array of SearchDevice objects 搜索设备结果列表。 count Long 满足查询条件的记录总数(只有条件为select count(*)/count(1)时单独返回)。 表5 SearchDevice 参数 参数类型 描述 app_id String 资源空间ID。 最大长度：36 app_name String 资源空间名称。 device_id String 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "_" + "node_id"拼接而成。 最大长度：256 node_id String 设备标识码，通常使用IMEI、MAC地址或Serial No作为node_id。 最大长度：64 gateway_id String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 最大长度：256 device_name String 设备名称。 最大长度：256 node_type String 设备节点类型。 ENDPOINT：非直连设备。 GATEWAY：直连设备或网关。 UNKNOWN：未知。 fw_version String 设备的固件版本。 最大长度：256 sw_version String 设备的软件版本。 最大长度：256 device_sdk_version String 设备的sdk信息。 最大长度：256 product_id String 设备关联的产品ID，用于唯一标识一个产品模型。 product_name String 设备关联的产品名称。 groups Object 设备组列表。 status String 设备的状态。 ONLINE：设备在线。 OFFLINE：设备离线。 ABNORMAL：设备异常。 INACTIVE：设备未激活。 FROZEN：设备冻结。 tags Object 设备的标签列表。 marker String 搜索结果记录Id。

响应示例 状态码： 200 OK { "devices" : [ { "app_id" : "jeQDJQZltU8iKgFFoW060F5SGZka", "marker" : "5c8f3d2d3df1f10d803adbda", "device_id" : "d4922d8a-6c8e-4396-852c-164aefa6638f", "node_id" : "ABC123456789", "gateway_id" : "d4922d8a-6c8e-4396-852c-164aefa6638f", "device_name" : "dianadevice", "node_type" : "ENDPOINT", "fw_version" : "1.1.0", "sw_version" : "1.1.0", "device_sdk_version" : "1.1.0", "product_id" : "b640f4c203b7910fc3cbd446ed437cbd", "status" : "INACTIVE", "tags" : [ { "tag_key" : "testTagName", "tag_value" : "testTagValue" } ] } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。 表3 请求Body参数 参数 是否必选 参数类型 描述 sql 是 String 搜索sql语句，具体使用方法见类SQL语法使用说明章节 最小长度：1 最大长度：400

Token认证 Token是服务端生成的一串字符串，作为客户端进行请求的一个令牌。第一次登录后，服务器生成一个Token并将此Token返回给客户端，以后客户端只需带上这个Token前来请求数据即可，无需再次带上用户名和密码。Token有效期是24小时，从客户端获取开始算起（24小时是相对时间），需要使用同一个Token鉴权时，建议缓存起来使用，避免频繁调用。在Token过期前，务必刷新Token或重新 获取Token ，否则Token过期后会在服务端鉴权失败。 如果您重新获取Token，不影响已有Token有效性。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 调用获取IAM用户Token（使用密码）接口获取Token，调用样例如下： POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "projectname" } } } } 注：“username”即IAM用户名、“password”即登录华为云密码、“domainname”即账号名，“projectname”即项目，您可以参考我的凭证页面获取。 图1 API凭证-获取凭证信息 接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值为获取到的Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/{project_id}/products/{product_id} Content-Type: application/json X-Auth-Token: ABCDEFJ....

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见： AK/SK签名认证操作指导。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。