标签管理-华为云

弹性云服务器 ECS-标签概述:操作场景

操作场景标签是弹性云服务器的标识。为弹性云服务器添加标签，可以方便用户识别和管理拥有的弹性云服务器资源。您可以在创建弹性云服务器时添加标签，也可以在弹性云服务器创建完成后，在云服务器的详情页添加标签，您最多可以给弹性云服务器添加10个标签。创建弹性云服务器时添加的标签，将同步添加至一同创建的EIP和云硬盘（包括系统盘、数据盘）上。如果云服务器使用的是已有EIP，则该标签不会在EIP上标识。如您的组织已经设定弹性云服务器的相关标签策略，则需按照标签策略规则为弹性云服务器添加标签。如果添加的标签不符合标签策略规则，则可能会导致弹性云服务器创建失败，请联系组织管理员了解标签策略详情。云服务器创建成功后，您可以在弹性云服务器、EIP和云硬盘详情页，查看到对应的标签。

弹性云服务器 ECS 标签管理

弹性云服务器 ECS-标签概述:有关标签的基本知识

有关标签的基本知识标签用于标识资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。图1 标签示例图1说明了标签的工作方式。在此示例中，您为每个云资源分配了两个标签，每个标签都包含您定义的一个“键”和一个“值”，一个标签使用键为“所有者”，另一个使用键为“用途”，每个标签都拥有相关的值。您可以根据为云资源添加的标签快速搜索和筛选特定的云资源。例如，您可以为账户中的资源定义一组标签，以跟踪每个云资源的所有者和用途，使资源管理变得更加轻松。

弹性云服务器 ECS 标签管理

云数据库 GAUSSDB-查询项目标签:响应参数

响应参数表2 参数说明参数参数类型描述 tags Array of objects 标签列表。详情请参见表3。表3 tags字段数据结构说明参数参数类型描述 key String 标签键。最大长度36个unicode字符，key不能为空。字符集：0-9，A-Z，a-z，“_”，“-”，中文。 value Array of strings 标签值。最大长度43个unicode字符，可以为空字符串。字符集：0-9，A-Z，a-z，“_”，“.”，“-”，中文。

云数据库 GAUSSDB 标签管理

设备接入 IOTDA-按标签查询资源:请求示例

请求示例按标签查询资源，备查询绑定了指定标签的设备。 POST https://{endpoint}/v5/iot/{project_id}/tags/query-resources { "resource_type" : "device", "tags" : [ { "tag_key" : "testTagName", "tag_value" : "testTagValue" } ] }

设备接入 IOTDA 标签管理

设备接入 IOTDA-按标签查询资源:响应参数

响应参数状态码： 200 表6 响应Body参数参数参数类型描述 resources Array of ResourceDTO objects 资源列表。 page Page object 查询结果的分页信息。表7 ResourceDTO 参数参数类型描述 resource_id String 资源id。例如，要查询的资源类型为device，那么对应的资源id就是device_id。表8 Page 参数参数类型描述 count Long 满足查询条件的记录总数。 marker String 本次分页查询结果中最后一条记录的ID，可在下一次分页查询时使用。

设备接入 IOTDA 标签管理

设备接入 IOTDA-按标签查询资源:请求参数

请求参数表3 请求Header参数参数是否必选参数类型描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用 IAM 服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情。表4 请求Body参数参数是否必选参数类型描述 resource_type 是 String 参数说明：要查询的资源类型，当前支持设备（device）。 tags 是 Array of TagV5DTO objects 参数说明：标签列表，支持按照标签key和value组合查询，传入的多个标签之间是或的关系。表5 TagV5DTO 参数是否必选参数类型描述 tag_key 是 String 参数说明：标签键，在同一资源下标签键唯一。绑定资源时，如果设置的键已存在，则将覆盖之前的标签值。如果设置的键值不存在，则新增标签。取值范围：长度不超过64，只允许中文、字母、数字、以及_.-等字符的组合。 tag_value 否 String 参数说明：标签值。取值范围：长度不超过128，只允许中文、字母、数字、以及_.-等字符的组合。

设备接入 IOTDA 标签管理

设备接入 IOTDA-按标签查询资源:URI

URI POST /v5/iot/{project_id}/tags/query-resources 表1 路径参数参数是否必选参数类型描述 project_id 是 String 参数说明：项目ID。获取方法请参见获取项目ID 。表2 Query参数参数是否必选参数类型描述 limit 否 Integer 参数说明：分页查询时每页显示的记录数。取值范围：1-50的整数，默认值为10。最小值：1 最大值：50 缺省值：10 marker 否 String 参数说明：上一次分页查询结果中最后一条记录的ID，在上一次分页查询时由物联网平台返回获得。分页查询时物联网平台是按marker也就是记录ID降序查询的，越新的数据记录ID也会越大。若填写marker，则本次只查询记录ID小于marker的数据记录。若不填写，则从记录ID最大也就是最新的一条数据开始查询。如果需要依次查询所有数据，则每次查询时必须填写上一次查询响应中的marker值。取值范围：长度为24的十六进制字符串，默认值为ffffffffffffffffffffffff。缺省值：ffffffffffffffffffffffff offset 否 Integer 参数说明：表示从marker后偏移offset条记录开始查询。当offset为0时，表示从marker后第一条记录开始输出。限制offset最大值是出于API性能考虑，您可以搭配marker使用该参数实现翻页，例如每页50条记录，1-11页内都可以直接使用offset跳转到指定页，但到11页后，由于offset限制为500，您需要使用第11页返回的marker作为下次查询的marker，以实现翻页到12-22页。取值范围：0-500的整数，默认为0。最小值：0 最大值：500 缺省值：0

设备接入 IOTDA 标签管理

API网关 APIG-通过标签查询实例列表:请求示例

请求示例根据标签过滤实例列表 { "without_any_tag" : false, "tags" : [ { "key" : "test-key", "values" : [ "test-value" ] } ], "matches" : [ { "key" : "resource_name", "value" : "test-apig" } ] } 根据企业项目id过滤实例列表 { "without_any_tag" : false, "sys_tags" : [ { "key" : "_sys_enterprise_project_id", "values" : [ "0" ] } ], "matches" : [ { "key" : "resource_name", "value" : "test-apig" } ] }

API网关 APIG 专享版-实例标签管理

API网关 APIG-通过标签查询实例列表:响应参数

响应参数状态码： 200 表7 响应Body参数参数参数类型描述 resources Array of TmsResourceResp objects 实例列表 total_count Integer 总记录数表8 TmsResourceResp 参数参数类型描述 resource_id String 实例编号 resouce_detail String 实例详细描述。暂不支持 resource_name String 实例名称 tags Array of TmsKeyValue objects 实例绑定的标签列表数组长度：0 - 20 表9 TmsKeyValue 参数参数类型描述 key String 键。支持可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及以下字符： _ . : = + - @； _sys_开头属于系统标签，租户不能输入最小长度：1 最大长度：128 value String 值。支持可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及以下字符： _ . : / = + - @ 最小长度：0 最大长度：255 状态码： 401 表10 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述状态码： 403 表11 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述状态码： 500 表12 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误描述

API网关 APIG 专享版-实例标签管理

API网关 APIG-通过标签查询实例列表:响应示例

响应示例状态码： 200 返回的实例列表 { "resources" : [ { "resource_id" : "e120108ac331422cb539d8609e9a7bb2", "resouce_detail" : null, "resource_name" : "apig_instance", "tags" : [ { "key" : "test-key", "value" : "test-value" } ] } ], "total_count" : 1 } 状态码： 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" }

API网关 APIG 专享版-实例标签管理

API网关 APIG-通过标签查询实例列表:请求参数

请求参数表3 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。表4 请求Body参数参数是否必选参数类型描述 without_any_tag 否 Boolean 不包含任意一个标签，该字段为true时查询所有不带标签的资源，此时忽略 “tags”字段。该字段为false或者未提供该参数时，该条件不生效。 tags 否 Array of TmsKeyValues objects 包含标签，最多包含20个key，每个key下面的value最多20个。无tag过滤条件时返回全量数据。数组长度：0 - 20 sys_tags 否 Array of TmsKeyValues objects 企业项目.仅op_service权限可以使用此字段做资源实例过滤条件. 无sys_tags时按照tag接口处理，无tag过滤条件时返回全量数据。数组长度：0 - 1 matches 否 Array of TmsMatchesKeyValue objects 搜索字段,key为要匹配的字段,当前限定为resource_name。value为匹配的值。根据key的值确认是否需要模糊匹配，如resource_name需要实现前缀搜索。表5 TmsKeyValues 参数是否必选参数类型描述 key 否 String 键。支持可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及以下字符： _ . : = + - @； _sys_开头属于系统标签，租户不能输入最小长度：1 最大长度：128 values 否 Array of strings 值。支持可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及以下字符： _ . : / = + - @ 表6 TmsMatchesKeyValue 参数是否必选参数类型描述 key 否 String 要匹配的字段 resource_name 表示按照APIG实例的名称去匹配枚举值： resource_name value 否 String 值。支持可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及以下字符： _ . : / = + - @ 最大长度：255

API网关 APIG 专享版-实例标签管理

API网关 APIG-通过标签查询实例列表:URI

URI POST /v2/{project_id}/apigw/resource-instances/filter 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目ID，获取方式请参见获取项目ID。表2 Query参数参数是否必选参数类型描述 offset 否 Long 偏移量，表示从此偏移量开始查询，偏移量小于0时，自动转换为0 缺省值：0 limit 否 Integer 每页显示的条目数量，条目数量小于等于0时，自动转换为20，条目数量大于500时，自动转换为500 最小值：1 最大值：500 缺省值：20

API网关 APIG 专享版-实例标签管理

数据加密服务 DEW-标签概述:标签命名规则

标签命名规则每个标签由一对键值对（Key-Value）组成。每个数据加密服务资源最多可以添加20个标签。对于每个资源，每个标签键（Key）都必须是唯一的，每个标签键（Key）只能有一个值（Value）。标签共由两部分组成：“标签键”和“标签值”，其中，“标签键”和“标签值”的命名规则如表标签参数说明所示。标签以键值对的形式表示，用于标识存储库，便于对存储库进行分类和搜索。此处的标签仅用于存储库的过滤和管理。一个存储库最多添加10个标签。如您的组织已经设定数据加密服务的相关标签策略，则需按照标签策略规则为密钥、凭据等添加标签。标签如果不符合标签策略的规则，则可能会导致密钥、凭据创建失败，请联系组织管理员了解标签策略详情。表1 标签参数说明参数规则样例标签键必填。对于同一个自定义密钥，标签键唯一。长度不超过128个字符。首尾不能包含空格。不能以_sys_开头。可以包含以下字符：中文英文数字空格特殊字符_.:=+-@ cost 标签值可以为空。长度不超过255个字符。可以包含以下字符：中文英文数字空格特殊字符_.:=+-@ 100

数据加密服务 DEW 标签管理

对象存储服务 OBS-设置桶标签

设置桶标签开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketTagging设置桶标签。以下代码展示了如何设置桶标签： // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AC CES S_KEY_ID和SECRET_ACCESS_KEY_ID。 // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html String ak = System.getenv("ACCESS_KEY_ID"); String sk = System.getenv("SECRET_ACCESS_KEY_ID"); String endPoint = "https://your-endpoint"; // 创建ObsClient实例 ObsClient obsClient = new ObsClient(ak, sk, endPoint); BucketTagInfo bucketTagInfo = new BucketTagInfo(); TagSet tagSet = new TagSet(); tagSet.addTag("tag1", "value1"); tagSet.addTag("tag2", "value2"); bucketTagInfo.setTagSet(tagSet); obsClient.setBucketTagging("bucketname", bucketTagInfo); 每个桶支持最多10个标签。标签的Key和Value支持Unicode。父主题：标签管理

对象存储服务 OBS 标签管理

对象存储服务 OBS-删除桶标签(Java SDK):接口约束

接口约束您必须是桶拥有者或拥有删除桶标签的权限，才能删除桶标签。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:DeleteBucketTagging权限，如果使用桶策略则需授予DeleteBucketTagging权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的region以及region与endPoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS 桶标签管理(Java SDK)

云服务器内容精选

标签管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线