更新时间:2023-12-22 GMT+08:00
分享

快速入门

本节通过调用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"  //标识追踪器状态。
    } 

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

分享:

    相关文档

    相关产品