文档首页/ 云审计服务 CTS/ API参考/ 快速入门
更新时间：2024-11-08 GMT+08:00
查看PDF
分享

快速入门

本节通过调用CTS创建追踪器接口来创建一个追踪器。

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

涉及API

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

  • IAM获取token的API
  • CTS创建追踪器的API

操作步骤

  1. Token认证，具体操作请参考认证鉴权。
  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"  //标识追踪器状态。
}

    若请求失败，则会返回错误码及对应的错误信息说明，详情请参考：错误码。