Getting Started

This section describes how to create predefined tags by invoking the TMS API.

The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.

Involved APIs

If you use a token for authentication, you must obtain the user's token and add X-Auth-Token to the request header of the IMS API when making an API call.

IAM API used to obtain the token
TMS API used to create predefined tags

Procedure

Obtain the token by referring to Authentication.
Send POST https://TMS endpoint/v1.0/predefine_tags/action.
Add Content-Type and X-Auth-Token to the request header.
Specify the following parameters in the request body:
```
{  
 "action": "Create", //Operation (mandatory, string)
   "tags" : [ 
              {
                   "key": "ENV1",  //Key (mandatory, string)
                   "value": "DEV1" //Value (mandatory, string)
                }, 
              {
                   "key" : "ENV2",
                   "value" : "DEV2"
               }
              ]    
}
```
After the request is sent, the status code 204 is returned and the response body is empty.
- The response message may be a success or a failure. This document takes the successful response as an example.
- If the request fails, an error code and error information are returned. For details, see Error Codes.
- For details about the elements and return values of response messages, see Creating and Deleting Predefined Tags.