调用GetUserLicense查询当前用户账号在物联网络管理平台的合约信息及合约执行情况。这里的“合约”与“执行情况”主要指各项服务的容量与当前使用量。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetUserLicense

系统规定参数。取值:GetUserLicense

返回数据

名称 类型 示例值 描述
Data Struct

各项服务的容量与当前使用量。

GatewayCount Long 100

网关接入服务的用量。

表示当前用户账号已经接入的网关数量。

GatewayDingTalkCount Long 100

钉钉网关接入服务的用量。

GatewayDingTalkLimit Long 100

钉钉网关接入服务的容量。

GatewayFreeLimit Long 100

网关接入服务的免费容量。

表示当前用户账号可以免费接入的网关数量上限,其值必然小于等于 GatewayLimit。

GatewayLimit Long 100

网关接入服务的容量。

表示当前用户账号可以接入的网关数量上限。

GatewayPrePayCount Long 100

网关接入服务的预付费数量。

表示当前用户账号已经接入的预付费网关数量。

GatewayProfessionalCount Long 100

专业网关接入服务的容量。

GatewayProfessionalLimit Long 100

专业网关接入服务的容量。

GatewayTupleCount Long 100

网关安全元组的服务用量。

表示当前用户账号已经申请了的网关安全元组的数量。

GatewayTupleFreeLimit Long 100

网关安全元组的免费服务容量。

表示当前用户账号可以申请的免费网关安全元组的数量,其值必然小于等于GatewayTupleLimit。

GatewayTupleHybridCount Long 100

hybird网关密钥已用数量。

表示当前用户账号已经使用的hybird网关密钥数量。

GatewayTupleHybridLimit Long 100

hybird网关密钥容量。

表示当前用户账号可以使用的hybird网关密钥数量上限。

GatewayTupleLimit Long 100

网关安全元组的服务容量。

表示当前用户账号最多可以申请的网关安全元组的数量。

GatewayTupleSingleChannelCount Long 100

单通道网关已用数量。

表示当前用户账号接入服务的单通道网关数量。

GatewayTupleSingleChannelLimit Long 100

网关单通道密钥配额。

表示当前用户账号网关单通道密钥配额。

GatewayTupleStandardCount Long 100

网关合约密钥-标准规格已用数量。

表示当前用户账号已用的网关合约密钥-标准规格数量。

GatewayTupleStandardLimit Long 100

网关合约密钥-标准规格限额。

表示当前用户账号可以接入网关合约密钥-标准规格容量。

LocalJoinPermissionCount Long 100

专用入网凭证服务的用量。

针对网络运营者类的用户,表示当前用户账号已经创建的专用入网凭证的数量。

LocalJoinPermissionFreeLimit Long 100

专用入网凭证服务的免费容量。

针对网络运营者类的用户,表示当前用户账号可以免费创建的专用入网凭证的数量上限,其值必然小于等于LocalJoinPermissionLimit。

LocalJoinPermissionLimit Long 100

专用入网凭证服务的容量。

针对网络运营者类的用户,表示当前用户账号可以创建的专用入网凭证的数量上限。

NodeCount Long 100

节点接入服务的用量。

表示当前用户账号已经接入的节点数量。

NodeFreeLimit Long 100

节点接入服务的免费容量。

表示当前用户账号可以免费接入的节点数量上限,其值必然小于等于NodeLimit。

NodeLimit Long 100

节点接入服务的容量。

表示当前用户账号可以接入的节点数量上限。

NodeTupleCount Long 100

节点安全元组的服务用量。

表示当前用户账号已经申请了的节点安全元组的数量。

NodeTupleFreeLimit Long 100

节点安全元组的免费服务容量。

表示当前用户账号可以申请的免费节点安全元组的数量,其值必然小于等于NodeTupleLimit。

NodeTupleLimit Long 100

节点(LoRaWAN模组)安全元组的服务容量。

表示当前用户账号最多可以申请的节点安全元组的数量。

NodeTupleRelayCount Long 100

中继密钥已用数量。

表示当前用户账号接入的中继密钥数量。

NodeTupleRelayLimit Long 100

中继密钥配额。

表示当前用户账号中继密钥配额。

NodeTupleStandardCount Long 100

节点合约密钥-标准规格已用数量。

表示当前用户账号已用节点合约密钥-标准规格数量。

NodeTupleStandardLimit Long 100

节点合约密钥-标准规格限额。

表示当前用户账号可以接入节点合约密钥-标准规格容量。

Oui String 0000

LoRaWAN模组、设备制造商类的用户的组织码。改组织码会体现在用户申请到的DevEUI中。

RelayCount Long 100

中继节点已用数量。

表示当前用户已用中级节点数量。

RelayLimit Long 100

中继节点配额。

表示当前用户账号中继节点配额。

RoamingJoinPermissionCount Long 100

泛在入网凭证服务的用量。

针对开发者类的用户,表示当前用户账号已经申请的泛在入网凭证的数量。

RoamingJoinPermissionFreeLimit Long 100

泛在入网凭证服务的免费容量。

针对开发者类的用户,表示当前用户账号可以免费申请的泛在入网凭证的数量上限,其值必然小于等于RoamingJoinPermissionLimit。

RoamingJoinPermissionLimit Long 100

泛在入网凭证服务的容量。

针对开发者(解决方案供应商)类的用户,表示当前用户账号可以申请的泛在入网凭证的数量上限。

RequestId String 89EF6CAA-958F-F32C-BE45-FE003C6DE097

请求ID。

Success Boolean true

是否成功。

示例

请求示例

http(s)://linkwan.cn-shanghai.aliyuncs.com/?Action=GetUserLicense
&<公共请求参数>

正常返回示例

XML格式

<GetUserLicenseResponse>
      <Data>
            <LabGatewayLimit>100</LabGatewayLimit>
            <Oui>0000</Oui>
            <GatewayLimit>100</GatewayLimit>
            <NodeTupleCount>100</NodeTupleCount>
            <RoamingJoinPermissionCount>100</RoamingJoinPermissionCount>
            <LocalJoinPermissionCount>100</LocalJoinPermissionCount>
            <GatewayTupleCount>100</GatewayTupleCount>
            <NodeTupleLimit>100</NodeTupleLimit>
            <LocalJoinPermissionLimit>100</LocalJoinPermissionLimit>
            <NodeCount>100</NodeCount>
            <RoamingJoinPermissionLimit>100</RoamingJoinPermissionLimit>
            <GatewayCount>100</GatewayCount>
            <LabNodeCount>100</LabNodeCount>
            <GatewayTupleLimit>100</GatewayTupleLimit>
            <LabNodeLimit>100</LabNodeLimit>
            <NodeLimit>100</NodeLimit>
            <LabGatewayCount>100</LabGatewayCount>
      </Data>
      <RequestId>89EF6CAA-958F-F32C-BE45-FE003C6DE097</RequestId>
      <Success>true</Success>
</GetUserLicenseResponse>

JSON格式

{
    "RequestId": "89EF6CAA-958F-F32C-BE45-FE003C6DE097",
    "Success": true,
    "Data": {
        "Oui": "0000",
        "GatewayTupleLimit": 100,
        "GatewayTupleCount": 100,
        "NodeTupleLimit": 100,
        "NodeTupleCount": 100,
        "GatewayLimit": 100,
        "GatewayCount": 100,
        "LocalJoinPermissionLimit": 100,
        "LocalJoinPermissionCount": 100,
        "NodeLimit": 100,
        "NodeCount": 100,
        "RoamingJoinPermissionLimit": 100,
        "RoamingJoinPermissionCount": 100,
        "LabGatewayLimit": 100,
        "LabGatewayCount": 100,
        "LabNodeLimit": 100,
        "LabNodeCount": 100
    }
}

错误码

HttpCode 错误码 错误信息 描述
400 ForbiddenByRam User not authorized to operate on the specified resource, or this API does not support RAM. 用户没有执行该操作所需要的RAM权限。
400 ForbiddenByRiskControl This operation cannot be performed because of security risks. 存在安全风险,无法执行该操作
400 NonExistent The specified resource does not exist. 要操作的资源不存在。
400 InternalError The request processing has failed due to some unknown error, exception or failure. 内部错误。

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