
# 快速入门
本节通过调用CTS创建追踪器接口来创建一个追踪器。
![](https://support.huaweicloud.com/api-cts/public_sys-resources/note_3.0-zh-cn.png)
通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。
#### 涉及API
当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加"X-Auth-Token"到业务接口请求消息头中。
- IAM获取token的API
- CTS创建追踪器的API
 
#### 操作步骤
1. Token认证，具体操作请参考[认证鉴权](https://support.huaweicloud.com/api-cts/cts_api_0004.html)。
2. 发送"POST /v1.0/{project_id}/tracker"。
3. 在Request Header中增加"Content-Type"和"X-Auth-Token"
4. 在Request Body中传入参数如下：
   ```
   POST /v1.0/{project_id}/tracker
   {
    "bucket_name": "obs-f1da",  //选择转储的OBS桶名称（必填，String）
    "is_support_trace_files_encryption": true,  //事件文件转储加密功能开关。（可选，布尔）。
    "kms_id": "13a4207c-7abe-4b68-8510-16b84c3b5504",  //事件文件转储加密所采用的密钥id。( 当"is_support_trace_files_encryption"参数值为“true”时，此参数为必选项。）
    "is_obs_created": true,  //是否支持新建OBS桶。 （可选，布尔）
    "file_prefix_name": "yO8Q",   //标识需要存储于OBS的日志文件前缀。（可选，String）
    "log_file_validate": {
    "is_support_validate": true  //是否打开事件文件校验。（可选，布尔）  
    }
   }
   ```
   请求响应成功后，返回已创建追踪器的信息。
   ```
   {
    "bucket_name": "obs-f1da",
    "file_prefix_name": "yO8Q",
    "is_obs_created": true, 
    "is_support_trace_files_encryption": true, 
    "kms_id": "13a4207c-7abe-4b68-8510-16b84c3b5504",   
    "log_file_validate": {
    "is_support_validate": true
    },
    "tracker_name": "system",  //标识追踪器名称
    "status": "enabled"  //标识追踪器状态。
   }
   ```
   若请求失败，则会返回错误码及对应的错误信息说明，详情请参考：[错误码](https://support.huaweicloud.com/api-cts/ErrorCode.html)。
   
 
