更新时间:2023-12-28 GMT+08:00

快速入门

本节通过调用TMS的API创建预定义标签。

通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。

涉及API

当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

  • IAM获取token的API
  • TMS创建预定义标签的API

具体步骤

  1. Token认证,具体操作请参考认证鉴权
  2. 发送“POST https://TMS的Endpoint/v1.0/predefine_tags/action”。

    在Request Header中增加“Content-Type”和“X-Auth-Token”。

    在Request Body中传入参数如下:
    {  
     "action" : "create",  //操作(必填,String)
       "tags" : [ 
                  {
                       "key" : "ENV1",  //键(必填,String)
                       "value" : "DEV1" //值(必填,String)
                    }, 
                  {
                       "key" : "ENV2",
                       "value" : "DEV2"
                   }
                  ]    
    }
    请求消息发送后,返回状态码204,响应体为空。
    • 响应消息包括成功和失败两类情况,本文以响应成功为例进行介绍。
    • 若请求消息响应失败则会返回错误码及对应的错误信息说明,详细错误码信息请参见错误码
    • 响应消息的要素说明及返回值请参考“创建预定义标签”章节。