PushSpeech调用该接口将语料推送到设备_物联网平台(IoT)-阿里云帮助中心

QPS限制

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

说明单个阿里云账号下的所有RAM用户共享该阿里云账号的配额。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	PushSpeech	系统规定参数。取值：PushSpeech。
ProjectCode	String	是	4de2c367**8c585e5992	项目ID，是项目的唯一标识，您可以通过项目管理控制台获取项目ID。
PushMode	String	是	SINGLE_DEVICE	推送模式。 ALL：全量设备推送。 SINGLE_DEVICE：单设备推送。 GROUP_DEVICE：分组设备推送。
SpeechCodeList.N	RepeatList	是	4de2c367**8c585e5992	需要推送的语料ID列表。该参数可以通过QuerySpeechList查询获取。 N为整数，取值范围：1~100，表示每次最多推送100条语料。
IotInstanceId	String	否	iot_instc_pu***_c-v64********	实例ID。您可在物联网平台控制台的实例概览页签，查看当前实例的ID。重要若有ID值，必须传入该ID值，否则调用会失败。若无ID值，则无需传入。实例的更多信息，请参见实例概述。
GroupId	String	否	4de2c367**8c585e5992	分组ID，当推送模式选择为分组设备时，该项必填。您可以在设备管理 > 分组管理中获取分组ID，
IotId	String	否	4de2c367**8c585e5992	设备ID。当推送模式选择为单个设备时，该参数与ProductKey、DeviceName组合二选一必传。说明如果传入该参数，则无需传入ProductKey和DeviceName。IotId作为设备唯一标识符，和ProductKey与DeviceName组合是一一对应的关系。如果您同时传入IotId和ProductKey与DeviceName组合，则以IotId为准。
DeviceName	String	否	light	设备名称。
ProductKey	String	否	a1BwAGV****	产品的唯一标识。

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

返回数据

名称	类型	示例值	描述
Code	String	iot.speechsolution.NotSigned	调用失败时，返回的错误码。更多信息，请参见错误码。
Data	String	4de2c367**8c585e5992	返回的推送任务ID（JobCode），是推送任务的唯一标识。
ErrorMessage	String	speech solution has not been signed	调用失败时，返回的错误信息。
RequestId	String	66FF51D3-*-49F1-B1A2-*	阿里云为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=PushSpeech
&ProjectCode=4de2c367****8c585e5992**
&PushMode=SINGLE_DEVICE
&SpeechCodeList.1=4de2c367****8c585e5992**
&<公共请求参数>

正常返回示例

XML格式

<PushSpeechResponse>
  <RequestId>66FF51D3-***-49F1-B1A2-***</RequestId>
  <Data>4de2c367****8c585e5992**</Data>
  <Success>true</Success>
</PushSpeechResponse>

JSON格式

{
    "RequestId": "66FF51D3-***-49F1-B1A2-***",
    "Data": "4de2c367****8c585e5992**",
    "Success": true
}