ReBindLicenseDevice_物联网平台(IoT)-阿里云帮助中心

QPS限制

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

说明 RAM用户共享阿里云账号配额。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ReBindLicenseDevice	系统规定参数。取值：ReBindLicenseDevice。
DeviceNameList.N	RepeatList	是	test	待授权License的设备列表，需传入设备对应的deviceName。您可调用接口QueryDevice，查询指定产品下所有设备的DeviceName。
LicenseCode	String	是	LINK_SPEECH_COMMON_LICENSE	License类型，暂时只支持千里传音，可取值：LINK_SPEECH_COMMON_LICENSE。
ProductKey	String	是	a2YwD23***	待授权设备所属产品的ProductKey。您可以在物联网平台控制台或调用接口QueryProductList，查看当前实例下所有产品的信息。
IotInstanceId	String	否	iot-e3***	实例ID。您可在物联网平台控制台的实例概览页面，查看当前实例的ID。重要对于新版公共实例或企业版实例，实例有ID值，必须传入该ID值，否则调用会失败。对于旧版公共实例，实例无ID值，无需传入。实例的更多信息，请参见实例概述。

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

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。更多信息，请参见错误码。
Data	Struct		返回重新绑定结果。
CheckProgressId	String	123***	查询批量授权设备进度的唯一ID。
FailSum	Long	2	授权License失败的设备个数。
Progress	Integer	100	为批量设备授权License的进度百分比，即取值范围为1~100。
ResultCsvFile	String	http://***	重新授权License完成后，授权失败设备文件的URL。
SuccessSum	Long	10	重新授权License成功的设备个数。
ErrorMessage	String	An internal error occurred. Try again later.	调用失败时，返回的错误信息。
RequestId	String	AF71BF1D-B552-47CD-B34B-352557627992	阿里云为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=ReBindLicenseDevice
&DeviceNameList.1=test
&LicenseCode=LINK_SPEECH_COMMON_LICENSE
&ProductKey=a2YwD23***
&<公共请求参数>

正常返回示例

XML格式

<ReBindLicenseDeviceResponse>
  <RequestId>AF71BF1D-B552-47CD-B34B-352557627992</RequestId>
  <Data>
        <CheckProgressId>123***</CheckProgressId>
        <Progress>100</Progress>
        <ResultCsvFile>http://***</ResultCsvFile>
        <FailSum>2</FailSum>
        <SuccessSum>10</SuccessSum>
  </Data>
  <Success>true</Success>
</ReBindLicenseDeviceResponse>

JSON格式

{
    "RequestId": "AF71BF1D-B552-47CD-B34B-352557627992",
    "Data": {
        "CheckProgressId": "123***",
        "Progress": "100",
        "ResultCsvFile": "http://***",
        "FailSum": "2",
        "SuccessSum": "10"
    },
    "Success": "true"
}