V2.5 Update Device Group¶

更新设备组。

操作权限¶

需授权的服务	所需操作权限
设备管理	Full Access

请求格式¶

POST https://{apigw-address}/connect-service/v2.5/deviceGroups?action=updateGroup

请求参数（URI）¶

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

请求参数（Body）¶

名称	必需/可选	数据类型	描述
groupId	必需	String	设备组ID。在 EnOS 管理控制台中前往设备管理 > 设备组获取设备组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"
}