文档首页/ 标签管理服务 TMS/ API参考/ 快速入门
更新时间：2023-12-28 GMT+08:00
查看PDF
分享

快速入门

本节通过调用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，响应体为空。
    • 响应消息包括成功和失败两类情况，本文以响应成功为例进行介绍。
    • 若请求消息响应失败则会返回错误码及对应的错误信息说明，详细错误码信息请参见错误码。
    • 响应消息的要素说明及返回值请参考“创建预定义标签”章节。