V2.5 Get DPS Device¶

获取 DPS 设备信息。

使用此 API 前，确保已安装 EnOS 2.4 CU2 或更新版本。

请求格式¶

GET https://{apigw-address}/dps-service/v2.5/pvs/device?action=get

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	设备所属的组织 ID。如何获取 orgId 信息>>
sn	Query	必需	String	系统生成的设备 SN 号，环境内唯一。

响应参数¶

名称	数据类型	描述
data	PvsDevice 结构体	DPS 设备的信息。更多信息，参见 PvsDevice 结构体。

PvsDevice 结构体 ¶

名称	数据类型	描述
sn	String	系统生成的设备 SN 号，环境内唯一。
groupId	String	注册组 ID。
regionId	String	设备被分配至的 region ID。
orgId	String	设备被分配至的组织 ID。
productKey	String	设备在 EnOS 管理控制台中对应的 product key。
batchOrder	Integer	设备创建批次编号。
batchTag	StringI18n	设备创建批次标签。国际化名称表示方法 >>
deviceData	Map	设备主数据。
desc	String	设备描述。
status	PvsDeviceStatus 结构体	设备当前状态。更多信息，参见 PvsDeviceStatus 结构体。
reprovisioning	Boolean	`true`：当前设备被重置。 `false`：当前设备未被重置。
allocateErrorMsg	String	设备上一次的分配失败信息。
createBy	String	创建人的用户 ID。
createTime	Long	设备的创建时间。
updateBy	String	更新人的用户 ID。
updateTime	Long	设备的修改时间。
manufacturerOrgId	String	设备预注册的组织 ID。
connectStatus	String	设备的连接状态，包含 `init`、`connected` 和 `failed`。
allocateStatus	String	设备的分配状态，包含 `init` 和 `allocated`。

PvsDeviceStatus 结构体 ¶

名称	数据类型	描述
currentStatus	String	设备当前状态，包含 `init`、`allocated`、`connected`、`finished` 和 `discarded`。
connectedTime	Long	设备的连接时间。
allocatedTime	Long	设备的分配时间。
finishedTime	Long	设备激活完成的时间。
discardedTime	Long	设备废弃的时间。

错误码¶

代码	错误信息	描述
35400	OrgId is required	组织 ID 为空。
35601	Verify not pass/sn not found	设备 SN 号不存在/不合法。

示例¶

请求示例¶

url: https://{apigw-address}/dps-service/v2.5/pvs/device?action=get&orgId=yourOrgId&sn=yourSn
method: GET

返回示例¶

{
  "code": 0,
  "msg": "OK",
  "requestId": "49444f28-0cd2-4c41-978d-bf40bc18feb4",
  "data": {
    "sn": "yourSn",
    "groupId": "yourGroupId",
    "regionId": null,
    "orgId": null,
    "productKey": "yourProductKey",
    "batchOrder": 2,
    "batchTag": {
      "defaultValue": "11",
      "i18nValue": {}
    },
    "deviceData": {
      "date": "2022-10-25T04:42:23.868Z",
      "energyType": "steam",
      "accessCapacity": null,
      "timezone": "+09:00",
      "assetId": "yourAssetId",
      "energyUseLink": "consumption",
      "subGroupList": [],
      "isDtu": null,
      "deviceName": {},
      "deviceSn": "yourDeviceSn",
      "isDtuSub": null
    },
    "desc": "11",
    "status": {
      "currentStatus": "init",
      "connectedTime": null,
      "allocatedTime": null,
      "finishedTime": null,
      "discardedTime": null
    },
    "reprovisioning": true,
    "allocateErrorMsg": "",
    "createBy": "userId1",
    "createTime": 1666845767197,
    "updateBy": "userId1",
    "updateTime": 1666845773571,
    "connectStatus": "init",
    "allocateStatus": "init"
  }
}