V2.5 Reset Device Allocation Status¶

重置设备的分配状态。

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

请求格式¶

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

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	设备所属的组织 ID。如何获取 orgId 信息>>

请求参数（Body）¶

名称	必需/可选	数据类型	描述
groupId	必需	String	注册组 ID。
sns	必需	String Array	设备 SN 号列表，由系统生成，环境内不可重复。批量操作的SN必须属于同一个注册组。

响应参数¶

名称	数据类型	描述
data	String Array	成功重置状态的设备 SN 号列表。

错误码¶

代码	错误信息	描述
35404	Group/sn not found	注册组/设备 SN 号不存在。
35603	Unauthorized to access the resource	服务账号没有 DPS 相关权限，接口鉴权失败。
99400	Invalid Argument groupId:groupId is missing	注册组 ID 为空/不合法。

示例¶

请求示例¶

url: https://{apigw-address}/dps-service/v2.5/pvs/device?action=resetAllocationStatus&orgId=yourOrgId
method: POST
requestBody:
{
    "groupId": "yourGroupId",
    "sns": [
        "sn1, sn2"
    ]
}

返回示例¶

{
  "code": 0,
  "msg": "OK",
  "requestId": "b6cfea66-0cb3-44a1-a982-2693b5752d9f",
  "data": [
    "sn1, sn2"
  ]
}