云服务器内容精选

  • 请求示例 批量添加实例的标签 { "action" : "create", "tags" : [ { "key" : "test-key", "value" : "test-value" } ] } 批量删除实例的标签 { "action" : "delete", "tags" : [ { "key" : "test-key1", "value" : "test-value" }, { "key" : "test-key2" } ] }
  • 响应示例 状态码: 401 Unauthorized { "error_code" : "APIC.7102", "error_msg" : "Incorrect token or token resolution failed" } 状态码: 403 Forbidden { "error_code" : "APIC.7106", "error_msg" : "No permissions to request for the method" } 状态码: 500 Internal Server Error { "error_code" : "APIC.9000" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识:create(创建),delete(删除) tags 是 Array of TmsKeyValue objects 标签列表。 一个实例默认最多支持创建20个标签。 表4 TmsKeyValue 参数 是否必选 参数类型 描述 key 否 String 键。 支持可用 UTF-8 格式表示的字母(包含中文)、数字和空格,以及以下字符: _ . : = + - @; _sys_开头属于系统标签,租户不能输入 value 否 String 值。 支持可用 UTF-8 格式表示的字母(包含中文)、数字和空格,以及以下字符: _ . : / = + - @
  • 响应参数 状态码: 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述
  • 在标签管理页面添加标签 此方法适用于为多个资源统一添加拥有同样标签键的标签。 访问 设备接入服务 ,单击“管理控制台 ”进入设备接入控制台。 在右上角的用户名下选择“标签管理”,进入标签管理服务页面。 图2 标签管理 在“资源标签”页面,勾选资源所在的区域,“资源类型”请选择“IoTDA-Instance”,单击“搜索”。系统列出所选区域下的所有IoTDA实例资源。 在“搜索结果”区域,单击“创建标签键”,输入键(例如:项目),单击“确定”。创建完成后,该标签键会添加至资源标签列表(如图3)。如果列表中没有显示该标签,单击,在下拉列表中勾选创建的标签键。默认该标签键的值为“无标签”,您还需要为每一个资源对应的标签值赋值,完成标签与资源的关联,继续下一步。 图3 实例标签-标签管理服务 单击“编辑”,切换资源标签列表为可编辑状态。 选择设备接入实例资源所在行,输入标签“值”(例如:A)。确认为标签键赋值后,“标签数量”将加1。按照同样方法依次为其他实例添加标签值。 图4 实例标签-输入标签值
  • 标签命名规则 每个标签由一对键值对(Key-Value)组成。 每个IoTDA实例最多可以添加20个标签。 对于每个资源,每个标签键(Key)都必须是唯一的,每个标签键(Key)只能有一个值(Value)。 标签共由两部分组成:“标签键”和“标签值”,其中,“标签键”和“标签值”的命名规则如表1所示。 表1 标签命名规则 参数 规则 样例 标签键 不能为空。对于同一个实例,Key值唯一。最大长度36个字符。 字符集:A-Z,a-z , 0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF) Organization 标签值 每个值最大长度43个字符,可以为空字符串。 字符集:A-Z,a-z , 0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF) Apache 如您的组织已经设定IoTDA的相关标签策略,则需按照标签策略规则为实例添加标签。标签如果不符合标签策略的规则,则可能会导致实例创建失败,请联系组织管理员了解标签策略详情。