V2.5 Update Device Group¶
更新设备组。
请求格式¶
POST https://{apigw-address}/connect-service/v2.5/deviceGroups?action=updateGroup
请求参数(URI)¶
名称 | 位置(Path/Query) | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|---|
orgId | Query | 必需 | String | 资产所属的组织 ID。如何获取 orgId 信息>> |
请求参数(Body)¶
名称 | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|
groupId | 必需 | String | 设备组ID |
name | 可选 | StringI18n | 待更新的设备组名称。其结构参见 国际化名称结构体。 |
desc | 可选 | String | 固件描述 |
返回参数¶
名称 | 数据类型 | 描述 |
---|---|---|
code | Number | 响应码 |
msg | String | 对状态码的解释和说明。请求成功为 “OK”。 |
requestId | String | 每次请求获取的ID,用于唯一标识一次API请求。 |
data | String | 更新的设备组信息。 |
示例¶
请求示例¶
url: https://{apigw-address}/connect-service/v2.5/deviceGroups?action=updateGroup&orgId=yourOrgId&groupId=yourGroupId
method: POST
requestBody:
{
"name": {
"defaultValue": "groupName",
"i18nValue": {
"en_US": "name",
"zh_CN": "中文名",
"es_ES": "nombre",
"ja_JP": "名前"
}
},
"desc": "groupDescription"
}
返回示例¶
{
"code": 0,
"msg": "OK",
"requestId": "fbb06269-b8fc-4674-aca7-2f5503e61259",
"data": "yourGroupId"
}