调用该接口为指定产品下设备重新授权License。

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"
}

错误码

HttpCode 错误码 错误信息 描述
400 iot.rtc.service.notSigned The RTC service is not activated. 音视频通信服务未开通。
400 iot.rtc.invalid.product.key invalid product key 无效的产品KEY

访问错误中心查看更多错误码。