0. 版本说明

本示例基于华为云SDK V3.0版本开发。

1. 示例简介

华为云提供了标签管理服务（TMS）的SDK，您可以直接集成SDK来调用TMS的相关API，从而实现对标签管理的快速操作。 该示例展示了如何通过java版SDK创建预定义标签。

2. 前置条件

• 1、获取华为云开发工具包（SDK），您也可以查看安装JAVA SDK。
• 2、您需要拥有华为云账号以及该账号对应的 Access Key（AK）和 Secret Access Key（SK）请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见 访问密钥 。
• 3、华为云 Java SDK 支持 Java JDK 1.8 及其以上版本。

3. 安装SDK

您可以通过Maven方式获取和安装SDK，您只需要在Java项目的pom.xml文件中加入相应的依赖项即可。 具体的SDK版本号请参见 SDK开发中心 。

                    
                    Copied!
                

<dependencies>
    <dependency>
        <groupId>com.huaweicloud.sdk</groupId>
        <artifactId>huaweicloud-sdk-tms</artifactId>
        <version>3.0.68</version>
    </dependency>
</dependencies>

4.开始使用

创建预定义标签示例代码

                    
                    Copied!
                
public class CreatePredefineTages {
    public static void main(String[] args) {
        // 认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
        // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
        String ak = System.getenv("HUAWEICLOUD_SDK_AK");
        String sk = System.getenv("HUAWEICLOUD_SDK_SK");
        String regionId = "<regionId>";

        ICredential auth = new GlobalCredentials()
            // 测试环境加入此行代码
            // .withIamEndpoint("<iamEndpoint>")
            .withAk(ak)
            .withSk(sk);

        TmsClient client = TmsClient.newBuilder()
            .withCredential(auth)
            .withRegion(TmsRegion.valueOf(regionId))// 测试环境应改为 .withRegion(new Region(regionId, "<endpoint>"))
            .build();

        CreatePredefineTagsRequest request = new CreatePredefineTagsRequest()
            .withBody(new ReqCreatePredefineTag()
                .withAction(ReqCreatePredefineTag.ActionEnum.CREATE)
                .withTags(Collections.singletonList(new PredefineTagRequest()
                    .withKey("key1")
                    .withValue("value1"))));

        try {
            CreatePredefineTagsResponse response = client.createPredefineTags(request);
            System.out.println("Create predefine tag success, http status code is " + response.getHttpStatusCode());
        } catch (ConnectionException | RequestTimeoutException | ServiceResponseException e) {
            System.out.println(e);
        }
    }
}

5. 返回示例

返回体为空，状态码204

                    
                    Copied!
                
Create predefine tag success, http status code is 204

6.接口及参数说明

参见：创建预定义标签

7. 参考

更多示例信息请参考TMS

8. 修订记录