检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
tag_value 否 String 参数说明:标签值。 取值范围:长度不超过128,只允许中文、字母、数字、以及_.-等字符的组合。
标签管理 标签介绍:用户可以给相同属性的一类资源打上相同的标签,便于管理。当前支持标签的资源有Device(设备)。 注意:iot_前缀的为系统预留标签,用户不能使用;一个资源最多只能打10个标签。 绑定标签 解绑标签 按标签查询资源 父主题: API
标签共由两部分组成:“标签键”和“标签值”,其中,“标签键”和“标签值”的命名规则如表1所示。 表1 标签命名规则 参数 规则 样例 标签键 不能为空。对于同一个实例,Key值唯一。最大长度36个字符。
使用标签检索资源 为云资源添加标签后,您可以通过本文所述的方法使用标签检索资源。 通过标签管理筛选资源 访问设备接入服务,单击“管理控制台 ”进入设备接入控制台。 在右上角的用户名下选择“标签管理”,进入标签管理服务页面。
删除标签 如果某个标签已经不再适用于您的资源管理,您可以删除资源标签。有三种途径删除资源标签: 在实例详情页删除标签 在标签管理页面单个删除 在标签管理页面批量删除 在实例详情页删除标签 访问设备接入服务,单击“管理控制台”进入设备接入控制台。
添加标签 给IoTDA实例添加标签有以下两种方法。 在实例详情页添加标签 在标签管理页面添加标签 预定义标签的使方法请参考预定义标签的使用方法。 在实例详情页添加标签 访问设备接入服务,单击“管理控制台 ”进入设备接入控制台。
tag_keys 是 Array of strings 参数说明:指定资源要解绑的标签键列表,标签键列表中各项之间不允许重复,不能填写不存在的标签键值 取值范围:标签键长度不超过64,只允许中文、字母、数字、以及_.-等字符的组合。
tag_value 否 String 参数说明:标签值。 取值范围:长度不超过128,只允许中文、字母、数字、以及_.-等字符的组合。 响应参数 无 请求示例 资源绑定标签,将标签绑定到设备id为d4922d8a的设备上。
表3 请求Body参数 参数 是否必选 参数类型 描述 tags 是 Array of Tag objects 参数说明:实例标签。
选择“标签”页签,单击“绑定标签”给设备添加标签。 图14 设备-绑定标签 群组相关API接口 查询设备组列表 添加设备组 查询设备组 修改设备组 删除设备组 管理设备组中的设备 查询设备组设备列表 标签相关API接口 绑定标签 解绑标签 父主题: 设备管理
表3 请求Body参数 参数 是否必选 参数类型 描述 tags 是 Array of Tag objects 参数说明:实例标签。
实例标签管理 标签概述 添加标签 删除标签 使用标签检索资源 父主题: IoTDA实例
tag_value string 标签值 长度不超过128,只允许中文、字母、数字、以及_.-等字符的组合。 sw_version string 软件版本 长度不超过64,只允许字母、数字、下划线(_)、连接符(-)、英文点(.)的组合。
标签 对于拥有大量云资源的用户,可以通过给云资源打标签,快速查找具有某标签的云资源,可对这些资源标签统一进行检视、修改、删除等操作,方便用户对云资源的管理。详情请参见标签概述。 联动规则 联动规则分为端侧规则和云端规则。
tags Array of TagV5DTO objects 设备的标签列表。 表6 TagV5DTO 参数 参数类型 描述 tag_key String 参数说明:标签键,在同一资源下标签键唯一。绑定资源时,如果设置的键已存在,则将覆盖之前的标签值。
表4 TagV5DTO 参数 是否必选 参数类型 描述 tag_key 是 String 参数说明:标签键,在同一资源下标签键唯一。绑定资源时,如果设置的键已存在,则将覆盖之前的标签值。如果设置的键值不存在,则新增标签。 tag_value 否 String 参数说明:标签值。
表3 自定义标签 标签名称 标签值 resource_provider IoTDA 图6 当前告警-amqp告警 图7 添加自定义标签 告警通知可以指定相应的行动规则。
表4 TagV5DTO 参数 是否必选 参数类型 描述 tag_key 是 String 参数说明:标签键,在同一资源下标签键唯一。绑定资源时,如果设置的键已存在,则将覆盖之前的标签值。如果设置的键值不存在,则新增标签。 tag_value 否 String 参数说明:标签值。
表4 TagV5DTO 参数 是否必选 参数类型 描述 tag_key 是 String 参数说明:标签键,在同一资源下标签键唯一。绑定资源时,如果设置的键已存在,则将覆盖之前的标签值。如果设置的键值不存在,则新增标签。 tag_value 否 String 参数说明:标签值。
表4 TagV5DTO 参数 是否必选 参数类型 描述 tag_key 是 String 参数说明:标签键,在同一资源下标签键唯一。绑定资源时,如果设置的键已存在,则将覆盖之前的标签值。如果设置的键值不存在,则新增标签。 tag_value 否 String 参数说明:标签值。