V4.0 Reset Device Allocation Status（待下线）¶

重置设备的分配状态。

此版本即将下线，推荐使用 V2.5 Reset Device Allocation Status。

请求格式¶

POST https://{apigw-address}/dps-service/v4.0/pvs/device?action=reprovision

请求参数（URI）¶

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

请求参数（Body）¶

名称	必需/可选	数据类型	描述
groupId	必需	String	注册组 ID。
sns	必需	String Array	设备 SN 号列表，由系统生成，环境内不可重复。

响应参数¶

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

错误码¶

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

示例¶

请求示例¶

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

返回示例¶

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