批量更新设备组

PATCH

/devices/batch-update

批量将指定设备移动到目标设备组，并自动应用该组的策略。
会同时更新设备的deviceGroupId和policyId，并异步同步到Google。

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{token}}

Body 参数application/json

deviceGroupId

integer <int64>

目标设备组ID

必需

ids

array[integer <int64>]

必需

需要批量更新的设备ID列表

示例

{
    "deviceGroupId": 0,
    "ids": [
        0
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/devices/batch-update' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "deviceGroupId": 0,
    "ids": [
        0
    ]
}'

返回响应

🟢200成功

application/json

批量更新成功

Body

code

integer

可选

示例值:

200

message

string

可选

示例值:

更新成功

data

object

可选

totalCount

integer

总请求设备数量

可选

示例值:

successCount

integer

成功更新数量

可选

示例值:

failedCount

integer

失败数量

可选

示例值:

failedItems

array[integer <int64>]

可选

更新失败的设备ID列表

示例

{
    "code": 200,
    "message": "更新成功",
    "data": {
        "totalCount": 10,
        "successCount": 8,
        "failedCount": 2,
        "failedItems": [
            0
        ]
    }
}

🟠400请求有误

🟠404记录不存在

🔴500服务器错误

修改于 2025-07-15 01:49:43