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"
}