# 创建追踪器 - CreateTracker #### 功能介绍 云审计服务开通后系统会自动创建一个追踪器，用来关联系统记录的所有操作。目前，一个云账户在一个Region下支持创建一个管理类追踪器和多个数据类追踪器。云审计服务支持在管理控制台查询近7天内的操作记录。如需保存更长时间的操作记录，您可以在创建追踪器之后通过对象存储服务（Object Storage Service，以下简称OBS）将操作记录实时保存至OBS桶中。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-cts/cts_api_0006.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cts/cts_api_1001.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cts:tracker:create | Write | - | - | - | - lts:topics:list - lts:topics:create - lts:groups:list - lts:groups:create - obs:bucket:CreateBucket - obs:bucket:HeadBucket - obs:bucket:GetLifecycleConfiguration - obs:bucket:PutLifecycleConfiguration - obs:bucket:GetBucketAcl - obs:bucket:PutBucketAcl - kms:cmk:list | #### URI POST /v3/{project_id}/tracker 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID，参见[获取账号ID和项目ID](https://support.huaweicloud.com/api-cts/cts_api_0005.html)章节。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tracker_type | 是 | String | 标识追踪器类型。 目前支持系统追踪器类型有管理类追踪器(system)和数据类追踪器(data)。 数据类追踪器和管理类追踪器共同参数有：is_lts_enabled, obs_info, is_support_validate; 管理类追踪器参数：is_support_trace_files_encryption, kms_id; 数据类追踪器参数：tracker_name, data_bucket。 | | tracker_name | 是 | String | 标识追踪器名称。 当"tracker_type"参数值为"system"时该参数为默认值"system"。 当"tracker_type"参数值为"data"时该参数需要指定追踪器名称"。 | | is_lts_enabled | 否 | Boolean | 是否开启转储到LTS。 | | is_organization_tracker | 否 | Boolean | 是否应用到我的组织。 只针对管理类追踪器。设置为true时，ORG组织下所有成员当前区域的审计日志会转储到该追踪器配置的OBS桶或者LTS日志流，但是事件列表界面不支持查看其它组织成员的审计日志。 | | management_event_selector | 否 | [ManagementEventSelector] object | 管理类事件选择器。 | | obs_info | 否 | [TrackerObsInfo] object | 转储桶配置 | | is_support_trace_files_encryption | 否 | Boolean | 事件文件转储加密功能开关。 当"tracker_type"参数值为"system"时该参数值有效。 该参数必须与kms_id参数同时使用。 | | kms_id | 否 | String | 事件文件转储加密所采用的密钥id（从KMS获取）。 当"tracker_type"参数值为"system"时该参数值有效。 当"is_support_trace_files_encryption"参数值为"是"时，此参数为必选项。 | | is_support_validate | 否 | Boolean | 事件文件转储时是否打开事件文件校验。 | | data_bucket | 否 | [DataBucket] object | 追踪桶配置信息。 当"tracker_type"参数值为"data"时该参数值有效。 | | agency_name | 否 | String | 云服务委托名称。 参数值为"cts_admin_trust"时，创建追踪器会自动创建云服务委托：cts_admin_trust。 | 表3ManagementEventSelector | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | exclude_service | 否 | Array of strings | 标识不转储的云服务名称。 目前只支持设置为KMS，表示屏蔽KMS服务的createDatakey事件。 | 表4TrackerObsInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | bucket_name | 否 | String | 标识OBS桶名称。由数字或字母开头，支持小写字母、数字、"-"、"."，长度为3～63个字符。 | | file_prefix_name | 否 | String | 标识需要存储于OBS的日志文件前缀，0-9，a-z，A-Z，'-'，'.'，'_'长度为0～64字符。 | | is_obs_created | 否 | Boolean | 是否支持新建OBS桶。 值为"true"时，表示新创建OBS桶存储事件文件； 值为"false"时，选择已存在的OBS桶存储事件文件。 | | bucket_lifecycle | 否 | Integer | 标识配置桶内对象存储周期。 当"tracker_type"参数值为"data"时该参数值有效。 | | compress_type | 否 | String | 压缩类型。包括不压缩（json），压缩（gzip）两种状态。默认为gzip格式。 | | is_sort_by_service | 否 | Boolean | 路径按云服务划分，打开后转储文件路径中将增加云服务名。默认为true。 | 表5DataBucket | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | data_bucket_name | 否 | String | 数据类追踪器追踪对象的桶名。 - 当启用或者停用数据类追踪器时，该参数为必选。 - 管理类追踪器无此参数。 - 追踪器一旦创建，追踪桶无法修改。 | | data_event | 否 | Array of strings | 数据类追踪器追踪的操作类型。 - 当启用或者停用数据类追踪器时，该参数为必选。 - 管理类追踪器无此参数。 - READ OBS对象读取操作；WRITE OBS对象写操作。 | #### 响应参数 **状态码：201** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 追踪器唯一标识。 | | create_time | Long | 追踪器创建时间戳。 | | kms_id | String | 事件文件转储加密所采用的密钥id（从KMS获取）。当"tracker_type"参数值为"system"和"is_support_trace_files_encryption"参数值为"是"时，此参数为必选项。 | | is_support_validate | Boolean | 是否打开事件文件校验。 | | is_organization_tracker | Boolean | 是否应用到我的组织。 只针对管理类追踪器。设置为true时，ORG组织下所有成员当前区域的审计日志会转储到该追踪器配置的OBS桶或者LTS日志流，但是事件列表界面不支持查看其它组织成员的审计日志。 | | management_event_selector | [ManagementEventSelector] object | 管理类事件选择器。 | | lts | [Lts] object | 转储LTS | | tracker_type | String | 标识追踪器类型。 目前支持系统追踪器类型有管理类追踪器（system）和数据类追踪器（data）。 | | domain_id | String | 账号ID，参见《云审计服务API参考》"获取账号ID和项目ID"章节。 | | project_id | String | 项目ID。 | | tracker_name | String | 标识追踪器名称，当前版本默认为"system"。 | | status | String | 标识追踪器状态，包括正常（enabled），停止（disabled）和异常（error）三种状态，状态为异常时需通过明细（detail）字段说明错误来源。 | | detail | String | 该参数仅在追踪器状态异常时返回，用于标识追踪器异常的原因，包括桶策略异常（bucketPolicyError），桶不存在（noBucket）和欠费或冻结（arrears）三种原因。 | | is_support_trace_files_encryption | Boolean | 事件文件转储加密功能开关。 该参数必须与kms_id参数同时使用。 当前环境仅"tracker_type"参数值为"system"时支持该功能。 | | obs_info | [ObsInfo] object | 事件转储桶信息。 | | data_bucket | [DataBucketQuery] object | 数据类事件追踪桶信息。 当"tracker_type"参数值为"data"时有效。 | | agency_name | String | 云服务委托名称。 参数值为"cts_admin_trust"时，创建追踪器会自动创建云服务委托：cts_admin_trust。 | 表7ManagementEventSelector | 参数 | 参数类型 | 描述 | |:---|:---|:---| | exclude_service | Array of strings | 标识不转储的云服务名称。 目前只支持设置为KMS，表示屏蔽KMS服务的createDatakey事件。 | 表8Lts | 参数 | 参数类型 | 描述 | |:---|:---|:---| | is_lts_enabled | Boolean | 是否开启转储到LTS。 | | log_group_name | String | 云审计服务在日志服务中创建的日志组名称。 | | log_topic_name | String | 云审计服务在日志服务中创建的日志主题名称。 | 表9ObsInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | bucket_name | String | 标识OBS桶名称。由数字或字母开头，支持小写字母、数字、"-"、"."，长度为3～63个字符。 | | file_prefix_name | String | 标识需要存储于OBS的日志文件前缀，0-9，a-z，A-Z，'-'，'.'，'_'长度为0～64字符。 | | is_obs_created | Boolean | 标识配置桶是否由追踪器自动创建。 | | is_authorized_bucket | Boolean | 标识配置桶是否已经授权给CTS服务账号。 | | bucket_lifecycle | Long | 标识配置桶内对象存储周期。 当"tracker_type"参数值为"data"时该参数值有效。 | | compress_type | String | 压缩类型。包括不压缩（json），压缩（gzip）两种状态。默认为gzip格式。 | | is_sort_by_service | Boolean | 路径按云服务划分，打开后转储文件路径中将增加云服务名。默认为true。 | 表10DataBucketQuery | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data_bucket_name | String | 标识OBS桶名称。由数字或字母开头，支持小写字母、数字、"-"、"."，长度为3～63个字符。 | | data_event | Array of strings | 数据类追踪器追踪对象的桶名。 - 当启用或者停用数据类追踪器时，该参数为必选。 - 管理类追踪器无此参数。 - 追踪器一旦创建，追踪桶无法修改。 - READ OBS对象读取操作；WRITE OBS对象写操作。 | **状态码：400** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码标识，CTS.XXX。 | | error_msg | String | 错误描述。 | **状态码：401** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码标识，CTS.XXX。 | | error_msg | String | 错误描述。 | **状态码：403** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码标识，CTS.XXX。 | | error_msg | String | 错误描述。 | **状态码：404** 表14响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码标识，CTS.XXX。 | | error_msg | String | 错误描述。 | **状态码：500** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码标识，CTS.XXX。 | | error_msg | String | 错误描述。 | **状态码：503** 表16响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码标识，CTS.XXX。 | | error_msg | String | 错误描述。 | #### 请求示例 - 管理类追踪器创建样例。 ``` POST https://{endpoint}/v3/{project_id}/tracker { "tracker_type" : "system", "tracker_name" : "system", "agency_name" : "cts_admin_trust", "obs_info" : { "is_obs_created" : false, "bucket_name" : "test-data-tracker", "file_prefix_name" : "11" }, "is_lts_enabled" : true, "is_support_trace_files_encryption" : true, "kms_id" : "13a4207c-7abe-4b68-8510-16b84c3b5504", "is_support_validate" : true } ``` - 数据类追踪器创建样例。 ``` POST https://{endpoint}/v3/{project_id}/tracker { "tracker_type" : "data", "tracker_name" : "data-tracker-name", "agency_name" : "cts_admin_trust", "obs_info" : { "is_obs_created" : false, "bucket_name" : "save-trace-bucket", "file_prefix_name" : "11", "bucket_lifecycle" : 30 }, "is_lts_enabled" : true, "data_bucket" : { "data_event" : [ "READ", "WRITE" ], "data_bucket_name" : "cstest0423" } } ``` #### 响应示例 **状态码：201** 请求成功。 ``` { "id" : "2e6fa9b8-8c6e-456d-b5d3-77be972d220b", "create_time" : 1587958482923, "domain_id" : "aexxxxxxxx4d4fb4bexxxxxxx791fbf", "is_support_trace_files_encryption" : true, "kms_id" : "13a4207c-7abe-4b68-8510-16b84c3b5504", "agency_name" : "cts_admin_trust", "obs_info" : { "is_obs_created" : false, "bucket_name" : "test-bucket", "is_authorized_bucket" : false, "file_prefix_name" : "11", "bucket_lifecycle" : 30 }, "project_id" : "bb1xxxxxxxxe4f498cbxxxxxxxx35634", "lts" : { "is_lts_enabled" : true, "log_group_name" : "CTS", "log_topic_name" : "system-trace" }, "is_support_validate" : true, "tracker_name" : "system", "tracker_type" : "system", "status" : "enabled" } ``` #### SDK代码示例 SDK代码示例如下。 - [Java] - 管理类追踪器创建样例。 ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cts.v3.region.CtsRegion; import com.huaweicloud.sdk.cts.v3.*; import com.huaweicloud.sdk.cts.v3.model.*; public class CreateTrackerSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CtsClient client = CtsClient.newBuilder() .withCredential(auth) .withRegion(CtsRegion.valueOf("")) .build(); CreateTrackerRequest request = new CreateTrackerRequest(); CreateTrackerRequestBody body = new CreateTrackerRequestBody(); TrackerObsInfo obsInfobody = new TrackerObsInfo(); obsInfobody.withBucketName("test-data-tracker") .withFilePrefixName("11") .withIsObsCreated(false); body.withIsSupportValidate(true); body.withKmsId("13a4207c-7abe-4b68-8510-16b84c3b5504"); body.withIsSupportTraceFilesEncryption(true); body.withObsInfo(obsInfobody); body.withIsLtsEnabled(true); body.withAgencyName(CreateTrackerRequestBody.CreateTrackerRequestBody.fromValue("cts_admin_trust")); body.withTrackerName("system"); body.withTrackerType(CreateTrackerRequestBody.CreateTrackerRequestBody.fromValue("system")); request.withBody(body); try { CreateTrackerResponse response = client.createTracker(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - 数据类追踪器创建样例。 ``` package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cts.v3.region.CtsRegion; import com.huaweicloud.sdk.cts.v3.*; import com.huaweicloud.sdk.cts.v3.model.*; import java.util.List; import java.util.ArrayList; public class CreateTrackerSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CtsClient client = CtsClient.newBuilder() .withCredential(auth) .withRegion(CtsRegion.valueOf("")) .build(); CreateTrackerRequest request = new CreateTrackerRequest(); CreateTrackerRequestBody body = new CreateTrackerRequestBody(); List listDataBucketDataEvent = new ArrayList<>(); listDataBucketDataEvent.add(DataBucket.DataEventEnum.fromValue("READ")); listDataBucketDataEvent.add(DataBucket.DataEventEnum.fromValue("WRITE")); DataBucket dataBucketbody = new DataBucket(); dataBucketbody.withDataBucketName("cstest0423") .withDataEvent(listDataBucketDataEvent); TrackerObsInfo obsInfobody = new TrackerObsInfo(); obsInfobody.withBucketName("save-trace-bucket") .withFilePrefixName("11") .withIsObsCreated(false) .withBucketLifecycle(30); body.withDataBucket(dataBucketbody); body.withObsInfo(obsInfobody); body.withIsLtsEnabled(true); body.withAgencyName(CreateTrackerRequestBody.CreateTrackerRequestBody.fromValue("cts_admin_trust")); body.withTrackerName("data-tracker-name"); body.withTrackerType(CreateTrackerRequestBody.CreateTrackerRequestBody.fromValue("data")); request.withBody(body); try { CreateTrackerResponse response = client.createTracker(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } ``` - [Python] - 管理类追踪器创建样例。 ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcts.v3.region.cts_region import CtsRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcts.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CtsClient.new_builder() \ .with_credentials(credentials) \ .with_region(CtsRegion.value_of("")) \ .build() try: request = CreateTrackerRequest() obsInfobody = TrackerObsInfo( bucket_name="test-data-tracker", file_prefix_name="11", is_obs_created=False ) request.body = CreateTrackerRequestBody( is_support_validate=True, kms_id="13a4207c-7abe-4b68-8510-16b84c3b5504", is_support_trace_files_encryption=True, obs_info=obsInfobody, is_lts_enabled=True, agency_name="cts_admin_trust", tracker_name="system", tracker_type="system" ) response = client.create_tracker(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - 数据类追踪器创建样例。 ``` # coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcts.v3.region.cts_region import CtsRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcts.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CtsClient.new_builder() \ .with_credentials(credentials) \ .with_region(CtsRegion.value_of("")) \ .build() try: request = CreateTrackerRequest() listDataEventDataBucket = [ "READ", "WRITE" ] dataBucketbody = DataBucket( data_bucket_name="cstest0423", data_event=listDataEventDataBucket ) obsInfobody = TrackerObsInfo( bucket_name="save-trace-bucket", file_prefix_name="11", is_obs_created=False, bucket_lifecycle=30 ) request.body = CreateTrackerRequestBody( data_bucket=dataBucketbody, obs_info=obsInfobody, is_lts_enabled=True, agency_name="cts_admin_trust", tracker_name="data-tracker-name", tracker_type="data" ) response = client.create_tracker(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) ``` - [Go] - 管理类追踪器创建样例。 ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cts/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cts/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cts/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cts.CtsClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cts.NewCtsClient(hcClient) request := &model.CreateTrackerRequest{} bucketNameObsInfo:= "test-data-tracker" filePrefixNameObsInfo:= "11" isObsCreatedObsInfo:= false obsInfobody := &model.TrackerObsInfo{ BucketName: &bucketNameObsInfo, FilePrefixName: &filePrefixNameObsInfo, IsObsCreated: &isObsCreatedObsInfo, } isSupportValidateCreateTrackerRequestBody:= true kmsIdCreateTrackerRequestBody:= "13a4207c-7abe-4b68-8510-16b84c3b5504" isSupportTraceFilesEncryptionCreateTrackerRequestBody:= true isLtsEnabledCreateTrackerRequestBody:= true agencyNameCreateTrackerRequestBody:= model.GetCreateTrackerRequestBodyAgencyNameEnum().CTS_ADMIN_TRUST request.Body = &model.CreateTrackerRequestBody{ IsSupportValidate: &isSupportValidateCreateTrackerRequestBody, KmsId: &kmsIdCreateTrackerRequestBody, IsSupportTraceFilesEncryption: &isSupportTraceFilesEncryptionCreateTrackerRequestBody, ObsInfo: obsInfobody, IsLtsEnabled: &isLtsEnabledCreateTrackerRequestBody, AgencyName: &agencyNameCreateTrackerRequestBody, TrackerName: "system", TrackerType: model.GetCreateTrackerRequestBodyTrackerTypeEnum().SYSTEM, } response, err := client.CreateTracker(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - 数据类追踪器创建样例。 ``` package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cts/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cts/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cts/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth, err := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). SafeBuild() if err != nil { fmt.Println(err) return } hcClient, err := cts.CtsClientBuilder(). WithRegion(region.ValueOf("")). WithCredential(auth). SafeBuild() if err != nil { fmt.Println(err) return } client := cts.NewCtsClient(hcClient) request := &model.CreateTrackerRequest{} var listDataEventDataBucket = []model.DataBucketDataEvent{ model.GetDataBucketDataEventEnum().READ, model.GetDataBucketDataEventEnum().WRITE, } dataBucketNameDataBucket:= "cstest0423" dataBucketbody := &model.DataBucket{ DataBucketName: &dataBucketNameDataBucket, DataEvent: &listDataEventDataBucket, } bucketNameObsInfo:= "save-trace-bucket" filePrefixNameObsInfo:= "11" isObsCreatedObsInfo:= false bucketLifecycleObsInfo:= int32(30) obsInfobody := &model.TrackerObsInfo{ BucketName: &bucketNameObsInfo, FilePrefixName: &filePrefixNameObsInfo, IsObsCreated: &isObsCreatedObsInfo, BucketLifecycle: &bucketLifecycleObsInfo, } isLtsEnabledCreateTrackerRequestBody:= true agencyNameCreateTrackerRequestBody:= model.GetCreateTrackerRequestBodyAgencyNameEnum().CTS_ADMIN_TRUST request.Body = &model.CreateTrackerRequestBody{ DataBucket: dataBucketbody, ObsInfo: obsInfobody, IsLtsEnabled: &isLtsEnabledCreateTrackerRequestBody, AgencyName: &agencyNameCreateTrackerRequestBody, TrackerName: "data-tracker-name", TrackerType: model.GetCreateTrackerRequestBodyTrackerTypeEnum().DATA, } response, err := client.CreateTracker(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } ``` - [更多] 更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CTS/sdk?api=CreateTracker)的代码示例页签，可生成自动对应的SDK代码示例。 #### 状态码 | 状态码 | 描述 | |:---|:---| | 201 | 请求成功。 | | 400 | 服务器未能处理请求。 | | 401 | 请求鉴权校验失败，访问被拒绝。 | | 403 | 请求权限校验失败，访问被禁止。 | | 404 | 请求中的资源不存在，请求未完成。 | | 500 | 服务内部异常，请求未完成。 | | 503 | 被请求的服务无效。建议直接修改该请求，不要重试该请求。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cts/ErrorCode.html)。