调用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. | 内部错误。 |
访问错误中心查看更多错误码。