V4.0 Reset Device Allocation Status(Deprecated)¶
Reset the allocation status of devices.
This version will be deprecated. It is recommended to use V2.5 Reset Device Allocation Status.
Request Format¶
POST https://{apigw-address}/dps-service/v4.0/pvs/device?action=reprovision
Request Parameters (URI)¶
Name | Location (Path/Query) | Required/Optional | Data Type | Description |
---|---|---|---|---|
orgId | Query | Required | String | The organization ID which the device belongs to. How to get orgId>> |
Request Parameters (Body)¶
Name | Required/Optional | Data Type | Description |
---|---|---|---|
groupId | Required | String | The registration group ID. |
sns | Required | String Array | The list of device SNs that are generated by system and unique in this environment. |
Response Parameters¶
Name | Data Type | Description |
---|---|---|
data | String Array | The list of serial numbers of devices that were successfully reset. |
Error Codes¶
Code | Message | Description |
---|---|---|
35404 | Group/sn not found | The registration group or the device SN does not exist. |
35603 | Unauthorized to access the resource | API authentication failed as the service account does not have a DPS-related role. |
Samples¶
Request Sample¶
url: https://{apigw-address}/dps-service/v4.0/pvs/device?action=reprovision&orgId=yourOrgId
method: POST
requestBody:
{
"groupId": "yourGroupId",
"sns": [
"yourDeviceSn"
]
}
Return Sample¶
{
"code": 0,
"msg": "OK",
"requestId": "b6cfea66-0cb3-44a1-a982-2693b5752d9f",
"data": [
"yourDeviceSn"
]
}