CreateDeviceDynamicGroup
创建动态分组，将符合动态分组条件的设备加入分组
服务地址：
华东2（上海）
输入参数
只看必填
IotInstanceId实例ID
GroupDesc分组描述
GroupName分组名称
DynamicGroupExpression动态分组规则
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

限制说明

  • 目前仅华东 2（上海）地域下，企业版实例和新版公共实例，支持创建动态分组。实例详细说明，请参见实例管理。

  • 单个阿里云账号下最多可创建 10 个动态分组。

  • 单个阿里云账号调用该接口的每秒请求数（QPS）最大限制为 1。

    说明 RAM 用户共享阿里云账号配额。

请求参数

字段名称字段详情
IotInstanceIdstring

实例 ID。展开详情

示例值:iot-***
GroupDescstring

分组描述。长度不超过 100 个字符，一个中文占一个字符。

示例值:test参考取值来源:
    QueryDeviceGroupList
    CreateDeviceGroup
GroupNamestring

分组名称。名称长度为 4~30 个字符，可包含中文、英文字母、数字和下划线（_）。一个中文占两个字符。

示例值:grouptest参考取值来源:
    CreateConsumerGroup
    QueryConsumerGroupList
DynamicGroupExpressionstring

动态分组规则，用于查询并动态匹配设备到分组。规则表达式编写方法，请参见类 SQL 语法说明。

示例值:product_key = "a1***" and name LIKE "test%"参考取值来源:
    QueryDeviceGroupInfo

请求说明

调用 API 时，除了本文介绍的该 API 的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

返回参数

字段名称字段详情
Codestring

调用失败时，返回的错误码。更多信息，请参见错误码。

示例值:iot.system.SystemException
ErrorMessagestring

调用失败时，返回的出错信息。

示例值:系统异常
RequestIdstring

阿里云为该请求生成的唯一标识符。

示例值:4D6D7F71-1C94-4160-8511-EFF4B8F0634D
Successboolean

表示是否调用成功。展开详情

示例值:true
Dataobject

调用成功时，返回的分组信息。

变更历史
暂无变更历史