Function

Configuration items of the tracker can be modified, including Trace Transfer to OBS, Key Event Notification, Encrypt Trace File, Retrieve Management Traces Using LTS, Verify Trace File, and parameters for enabling and disabling a tracker. Modifying the tracker does not affect the existing operation records. After the modification is complete, the system will immediately start recording operations based on the new rule.

URI

PUT /v1.0/{project_id}/tracker/{tracker_name}

Request

• Parameters

  Table 2 Parameters in the request

  Parameter	Sub-Parameter	Mandatory	Type	Description
  bucket_name	N/A	Yes	String	OBS bucket name. Starts with a digit or letter and contains 3 to 63 characters, including lowercase letters, digits, hyphens (-), and periods (.)
  file_prefix_name	N/A	No	String	Prefix of a log that needs to be stored in an OBS bucket. The value is a string of 0 to 64 characters and can contain uppercase and lowercase letters (a to z and A to Z), digits (0 to 9), hyphens (-), underscores (_), or periods (.)
  status	N/A	No	String	Status of a tracker. The value can be enabled or disabled. If you change the value to disabled, the tracker stops recording traces.
  data_bucket	data_bucket_name	Yes	Array	Bucket name of the data class tracker. This parameter is mandatory whenever the data class tracker is enabled or disabled. This parameter is not invalid for the management class tracker.
  	data_event	Yes	Array	Type of operations tracked by the data tracker. This parameter is mandatory whenever the data class tracker is enabled or disabled. This parameter is not invalid for the management class tracker.
  	search_enabled	Yes	Boolean	Whether to enable trace analysis for the data tracker. This parameter is mandatory whenever the data class tracker is enabled or disabled. This parameter is not invalid for the management class tracker.
  is_obs_created	N/A	Yes	Boolean	Whether a new OBS bucket can be created. When the value is true, you can create an OBS bucket to store trace files. When the value is false, you can select an existing OBS bucket to store trace files. The bucket name is a string of 3 to 64 characters and can only contain digits, letters, hyphens (-), and periods (.). Only one period and hyphen can be contained in the string.
  is_support_trace_files_encryption	N/A	Yes	Boolean	Whether the function of encrypting stored trace files is enabled or not. This parameter must be used with kms_id.
  kms_id	N/A	Yes	String	Key ID used for dumping and encrypting trace files. This key ID is obtained from KMS. This parameter is mandatory when the value of is_support_trace_files_encryption is true.
  lts	is_lts_enabled	Yes	Boolean	Whether the LTS search function is enabled or not.
  	log_group_name	Yes	String	Name of the log group that CTS creates in LTS.
  	log_topic_name	Yes	String	Name of the log topic that CTS creates in LTS.
  log_file_validate	N/A	No	json	Whether to enable the trace file verification function.
  -	is_support_validate	Yes	Boolean	Whether the trace file verification function is supported or not.

• Example request

  PUT /v1.0/{project_id}/tracker/system   
  {
      "bucket_name": "my_created_bucket",
      "file_prefix_name": "some_folder",
      "is_obs_created": true,
      "is_support_trace_files_encryption": true,
      "kms_id": "13a4207c-7abe-4b68-8510-16b84c3b5504",
      "lts": {
          "is_lts_enabled": true,
          "log_group_name": "CTS",
          "log_topic_name": "system-trace"
      },
      "log_file_validate": {
          "is_support_validate": true
      },
      "status": "disabled"
  }

Response

• Parameters

  Table 3 Parameters in the response

  Parameter	Sub-Parameter	Type	Description
  tracker_name	N/A	String	Tracker name. Currently, only tracker "system" is available.
  bucket_name	N/A	String	OBS bucket name. Starts with a digit or letter and contains 3 to 63 characters, including lowercase letters, digits, hyphens (-), and periods (.)
  file_prefix_name	N/A	String	Prefix of a log that needs to be stored in an OBS bucket.
  status	N/A	String	Status of a tracker. The value can be enabled or disabled.
  is_obs_created	N/A	Boolean	Whether a new OBS bucket can be created. When the value is true, you can create an OBS bucket to store trace files. When the value is false, you can select an existing OBS bucket to store trace files. The bucket name is a string of 3 to 64 characters and can only contain digits, letters, hyphens (-), and periods (.). Only one period and hyphen can be contained in the string.
  is_support_trace_files_encryption	N/A	Boolean	Whether the function of encrypting stored trace files is enabled or not. This parameter must be used with kms_id.
  kms_id	N/A	String	Key ID used for dumping and encrypting trace files. This key ID is obtained from KMS. This parameter is mandatory when the value of is_support_trace_files_encryption is true.
  lts	is_lts_enabled	Boolean	Name of the log group that CTS creates in LTS.
  	log_topic_name	String	Name of the log topic that CTS creates in LTS.
  	log_group_id	String	ID of the log group that CTS creates in LTS.
  	log_topic_id	String	ID of the log topic that CTS creates in LTS.
  log_file_validate	N/A	JSON object	Whether to enable the trace file verification function.
  is_support_validate	N/A	Boolean	Whether the trace file verification function is supported or not.

• Example response

Returned Value

• Normal

  Table 4 Return code for successful requests

  Returned Value	Description
  200	The request is successfully processed.

• Abnormal

  Table 5 Return code for failed requests

  Returned Value	Description
  400	The server failed to process the request.
  404	The server failed to find the requested resource.
  500	Failed to complete the request because of an internal service error.
  401	Your access request is rejected.
  403	You are forbidden to access the requested page.