ClsClient (tencentcloud-sdk-java-intl-en 3.0.710 API)

java.lang.Object
- com.tencentcloudapi.common.AbstractClient
- - com.tencentcloudapi.cls.v20201016.ClsClient

public class ClsClient
extends AbstractClient

Field Summary
- Fields inherited from class com.tencentcloudapi.common.AbstractClient
  gson, HTTP_RSP_OK, SDK_VERSION

Constructor Summary

Constructors
Constructor and Description
`ClsClient(Credential credential, String region)`
`ClsClient(Credential credential, String region, ClientProfile profile)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`AddMachineGroupInfoResponse`	`AddMachineGroupInfo(AddMachineGroupInfoRequest req)` This API is used to add machine group information.
`ApplyConfigToMachineGroupResponse`	`ApplyConfigToMachineGroup(ApplyConfigToMachineGroupRequest req)` This API is used to apply the collection configuration to the specified machine group.
`CloseKafkaConsumerResponse`	`CloseKafkaConsumer(CloseKafkaConsumerRequest req)` This API is used to disable Kafka consumption.
`CreateAlarmResponse`	`CreateAlarm(CreateAlarmRequest req)` This API is used to create an alarm policy.
`CreateAlarmNoticeResponse`	`CreateAlarmNotice(CreateAlarmNoticeRequest req)` This API is used to create a notification group.
`CreateConfigResponse`	`CreateConfig(CreateConfigRequest req)` This API is used to create a collection rule configuration.
`CreateConsumerResponse`	`CreateConsumer(CreateConsumerRequest req)` This API is used to create a shipping task.
`CreateCosRechargeResponse`	`CreateCosRecharge(CreateCosRechargeRequest req)` This API is used to create a COS import task.
`CreateExportResponse`	`CreateExport(CreateExportRequest req)` This API is used to create a download task.
`CreateIndexResponse`	`CreateIndex(CreateIndexRequest req)` This API is used to create an index.
`CreateLogsetResponse`	`CreateLogset(CreateLogsetRequest req)` This API is used to create a logset.
`CreateMachineGroupResponse`	`CreateMachineGroup(CreateMachineGroupRequest req)` This API is used to create a machine group.
`CreateShipperResponse`	`CreateShipper(CreateShipperRequest req)` This API is used to create a task to ship to COS.
`CreateTopicResponse`	`CreateTopic(CreateTopicRequest req)` This API is used to create a log topic.
`DeleteAlarmResponse`	`DeleteAlarm(DeleteAlarmRequest req)` This API is used to delete an alarm policy.
`DeleteAlarmNoticeResponse`	`DeleteAlarmNotice(DeleteAlarmNoticeRequest req)` This API is used to delete a notification group.
`DeleteConfigResponse`	`DeleteConfig(DeleteConfigRequest req)` This API is used to delete a collection rule configuration.
`DeleteConfigFromMachineGroupResponse`	`DeleteConfigFromMachineGroup(DeleteConfigFromMachineGroupRequest req)` This API is used to delete the collection configuration applied to a machine group.
`DeleteConsumerResponse`	`DeleteConsumer(DeleteConsumerRequest req)` This API is used to delete a shipping task.
`DeleteExportResponse`	`DeleteExport(DeleteExportRequest req)` This API is used to delete a log download task.
`DeleteIndexResponse`	`DeleteIndex(DeleteIndexRequest req)` This API is used to delete the index configuration of a log topic.
`DeleteLogsetResponse`	`DeleteLogset(DeleteLogsetRequest req)` This API is used to delete a logset.
`DeleteMachineGroupResponse`	`DeleteMachineGroup(DeleteMachineGroupRequest req)` This API is used to delete a machine group.
`DeleteMachineGroupInfoResponse`	`DeleteMachineGroupInfo(DeleteMachineGroupInfoRequest req)` This API is used to delete machine group information.
`DeleteShipperResponse`	`DeleteShipper(DeleteShipperRequest req)` This API is used to delete a shipping rule.
`DeleteTopicResponse`	`DeleteTopic(DeleteTopicRequest req)` This API is used to delete a log topic.
`DescribeAlarmNoticesResponse`	`DescribeAlarmNotices(DescribeAlarmNoticesRequest req)` This API is used to get the notification group list.
`DescribeAlarmsResponse`	`DescribeAlarms(DescribeAlarmsRequest req)` This API is used to get the alarm policy list.
`DescribeAlertRecordHistoryResponse`	`DescribeAlertRecordHistory(DescribeAlertRecordHistoryRequest req)` This API is used to get alarm records, such as today's uncleared alarms.
`DescribeConfigMachineGroupsResponse`	`DescribeConfigMachineGroups(DescribeConfigMachineGroupsRequest req)` This API is used to get the machine group bound to a collection rule configuration.
`DescribeConfigsResponse`	`DescribeConfigs(DescribeConfigsRequest req)` This API is used to get a collection rule configuration.
`DescribeConsumerResponse`	`DescribeConsumer(DescribeConsumerRequest req)` This API is used to query a shipping task.
`DescribeCosRechargesResponse`	`DescribeCosRecharges(DescribeCosRechargesRequest req)` This API is used to get COS import configuration.
`DescribeExportsResponse`	`DescribeExports(DescribeExportsRequest req)` This API is used to get the list of log download tasks.
`DescribeIndexResponse`	`DescribeIndex(DescribeIndexRequest req)` This API is used to get the index configuration information.
`DescribeLogContextResponse`	`DescribeLogContext(DescribeLogContextRequest req)` This API is used to search for content in the log context.
`DescribeLogHistogramResponse`	`DescribeLogHistogram(DescribeLogHistogramRequest req)` This API is used to get a log count histogram.
`DescribeLogsetsResponse`	`DescribeLogsets(DescribeLogsetsRequest req)` This API is used to get the list of logsets.
`DescribeMachineGroupConfigsResponse`	`DescribeMachineGroupConfigs(DescribeMachineGroupConfigsRequest req)` This API is used to get the collection rule configuration bound to a machine group.
`DescribeMachineGroupsResponse`	`DescribeMachineGroups(DescribeMachineGroupsRequest req)` This API is used to get the list of machine groups.
`DescribeMachinesResponse`	`DescribeMachines(DescribeMachinesRequest req)` This API is used to get the machine status in the specified machine group.
`DescribePartitionsResponse`	`DescribePartitions(DescribePartitionsRequest req)` This API is used to get the list of topic partitions.
`DescribeShippersResponse`	`DescribeShippers(DescribeShippersRequest req)` This API is used to get the configuration of the task of shipping to COS.
`DescribeShipperTasksResponse`	`DescribeShipperTasks(DescribeShipperTasksRequest req)` This API is used to get the list of shipping tasks.
`DescribeTopicsResponse`	`DescribeTopics(DescribeTopicsRequest req)` This API is used to get the list of log topics and supports pagination.
`GetAlarmLogResponse`	`GetAlarmLog(GetAlarmLogRequest req)` This API is used to get the records of alarm tasks.
`MergePartitionResponse`	`MergePartition(MergePartitionRequest req)` This API is used to merge a topic partition in read/write state.
`ModifyAlarmResponse`	`ModifyAlarm(ModifyAlarmRequest req)` This API is used to modify an alarm policy.
`ModifyAlarmNoticeResponse`	`ModifyAlarmNotice(ModifyAlarmNoticeRequest req)` This API is used to modify a notification group.
`ModifyConfigResponse`	`ModifyConfig(ModifyConfigRequest req)` This API is used to modify a collection rule configuration.
`ModifyConsumerResponse`	`ModifyConsumer(ModifyConsumerRequest req)` This API is used to modify a shipping task.
`ModifyCosRechargeResponse`	`ModifyCosRecharge(ModifyCosRechargeRequest req)` This API is used to modify a COS import task.
`ModifyIndexResponse`	`ModifyIndex(ModifyIndexRequest req)` This API is used to modify the index configuration.
`ModifyLogsetResponse`	`ModifyLogset(ModifyLogsetRequest req)` This API is used to modify a logset.
`ModifyMachineGroupResponse`	`ModifyMachineGroup(ModifyMachineGroupRequest req)` This API is used to modify a machine group.
`ModifyShipperResponse`	`ModifyShipper(ModifyShipperRequest req)` This API is used to modify an existing shipping rule.
`ModifyTopicResponse`	`ModifyTopic(ModifyTopicRequest req)` This API is used to modify a log topic.
`OpenKafkaConsumerResponse`	`OpenKafkaConsumer(OpenKafkaConsumerRequest req)` This API is used to enable the Kafka consumption feature.
`RetryShipperTaskResponse`	`RetryShipperTask(RetryShipperTaskRequest req)` This API is used to retry a failed shipping task.
`SearchLogResponse`	`SearchLog(SearchLogRequest req)` This API is used to search logs.
`SplitPartitionResponse`	`SplitPartition(SplitPartitionRequest req)` This API is used to split a topic partition.
`UploadLogResponse`	`UploadLog(UploadLogRequest req)` ## Note To ensure log data reliability and help you use CLS more efficiently, we recommend you use the optimized API to upload logs.

Methods inherited from class com.tencentcloudapi.common.AbstractClient
call, getClientProfile, getCredential, getRegion, internalRequest, setClientProfile, setCredential, setRegion

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ClsClient
```
public ClsClient(Credential credential,
                 String region)
```
  - ClsClient
```
public ClsClient(Credential credential,
                 String region,
                 ClientProfile profile)
```
- Method Detail
  - AddMachineGroupInfo
```
public AddMachineGroupInfoResponse AddMachineGroupInfo(AddMachineGroupInfoRequest req)
                                                throws TencentCloudSDKException
```
    This API is used to add machine group information.
    
    Parameters:
    
    req - AddMachineGroupInfoRequest
    
    Returns:
    
    AddMachineGroupInfoResponse
    
    Throws:
    
    TencentCloudSDKException
  - ApplyConfigToMachineGroup
```
public ApplyConfigToMachineGroupResponse ApplyConfigToMachineGroup(ApplyConfigToMachineGroupRequest req)
                                                            throws TencentCloudSDKException
```
    This API is used to apply the collection configuration to the specified machine group.
    
    Parameters:
    
    req - ApplyConfigToMachineGroupRequest
    
    Returns:
    
    ApplyConfigToMachineGroupResponse
    
    Throws:
    
    TencentCloudSDKException
  - CloseKafkaConsumer
```
public CloseKafkaConsumerResponse CloseKafkaConsumer(CloseKafkaConsumerRequest req)
                                              throws TencentCloudSDKException
```
    This API is used to disable Kafka consumption.
    
    Parameters:
    
    req - CloseKafkaConsumerRequest
    
    Returns:
    
    CloseKafkaConsumerResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateAlarm
```
public CreateAlarmResponse CreateAlarm(CreateAlarmRequest req)
                                throws TencentCloudSDKException
```
    This API is used to create an alarm policy.
    
    Parameters:
    
    req - CreateAlarmRequest
    
    Returns:
    
    CreateAlarmResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateAlarmNotice
```
public CreateAlarmNoticeResponse CreateAlarmNotice(CreateAlarmNoticeRequest req)
                                            throws TencentCloudSDKException
```
    This API is used to create a notification group.
    
    Parameters:
    
    req - CreateAlarmNoticeRequest
    
    Returns:
    
    CreateAlarmNoticeResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateConfig
```
public CreateConfigResponse CreateConfig(CreateConfigRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to create a collection rule configuration.
    
    Parameters:
    
    req - CreateConfigRequest
    
    Returns:
    
    CreateConfigResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateConsumer
```
public CreateConsumerResponse CreateConsumer(CreateConsumerRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to create a shipping task.
    
    Parameters:
    
    req - CreateConsumerRequest
    
    Returns:
    
    CreateConsumerResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateCosRecharge
```
public CreateCosRechargeResponse CreateCosRecharge(CreateCosRechargeRequest req)
                                            throws TencentCloudSDKException
```
    This API is used to create a COS import task.
    
    Parameters:
    
    req - CreateCosRechargeRequest
    
    Returns:
    
    CreateCosRechargeResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateExport
```
public CreateExportResponse CreateExport(CreateExportRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to create a download task. To get the returned download address, call `DescribeExports` to view the task list. The `CosPath` parameter is also included for download address. For more information, visit https://intl.cloud.tencent.com/document/product/614/56449.?from_cn_redirect=1
    
    Parameters:
    
    req - CreateExportRequest
    
    Returns:
    
    CreateExportResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateIndex
```
public CreateIndexResponse CreateIndex(CreateIndexRequest req)
                                throws TencentCloudSDKException
```
    This API is used to create an index.
    
    Parameters:
    
    req - CreateIndexRequest
    
    Returns:
    
    CreateIndexResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateLogset
```
public CreateLogsetResponse CreateLogset(CreateLogsetRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to create a logset. The ID of the created logset is returned.
    
    Parameters:
    
    req - CreateLogsetRequest
    
    Returns:
    
    CreateLogsetResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateMachineGroup
```
public CreateMachineGroupResponse CreateMachineGroup(CreateMachineGroupRequest req)
                                              throws TencentCloudSDKException
```
    This API is used to create a machine group.
    
    Parameters:
    
    req - CreateMachineGroupRequest
    
    Returns:
    
    CreateMachineGroupResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateShipper
```
public CreateShipperResponse CreateShipper(CreateShipperRequest req)
                                    throws TencentCloudSDKException
```
    This API is used to create a task to ship to COS. Note: To use this API, you need to check whether you have configured the role and permission for shipping to COS. If not, see **Viewing and Configuring Shipping Authorization** at https://intl.cloud.tencent.com/document/product/614/71623.?from_cn_redirect=1
    
    Parameters:
    
    req - CreateShipperRequest
    
    Returns:
    
    CreateShipperResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateTopic
```
public CreateTopicResponse CreateTopic(CreateTopicRequest req)
                                throws TencentCloudSDKException
```
    This API is used to create a log topic.
    
    Parameters:
    
    req - CreateTopicRequest
    
    Returns:
    
    CreateTopicResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteAlarm
```
public DeleteAlarmResponse DeleteAlarm(DeleteAlarmRequest req)
                                throws TencentCloudSDKException
```
    This API is used to delete an alarm policy.
    
    Parameters:
    
    req - DeleteAlarmRequest
    
    Returns:
    
    DeleteAlarmResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteAlarmNotice
```
public DeleteAlarmNoticeResponse DeleteAlarmNotice(DeleteAlarmNoticeRequest req)
                                            throws TencentCloudSDKException
```
    This API is used to delete a notification group.
    
    Parameters:
    
    req - DeleteAlarmNoticeRequest
    
    Returns:
    
    DeleteAlarmNoticeResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteConfig
```
public DeleteConfigResponse DeleteConfig(DeleteConfigRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to delete a collection rule configuration.
    
    Parameters:
    
    req - DeleteConfigRequest
    
    Returns:
    
    DeleteConfigResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteConfigFromMachineGroup
```
public DeleteConfigFromMachineGroupResponse DeleteConfigFromMachineGroup(DeleteConfigFromMachineGroupRequest req)
                                                                  throws TencentCloudSDKException
```
    This API is used to delete the collection configuration applied to a machine group.
    
    Parameters:
    
    req - DeleteConfigFromMachineGroupRequest
    
    Returns:
    
    DeleteConfigFromMachineGroupResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteConsumer
```
public DeleteConsumerResponse DeleteConsumer(DeleteConsumerRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to delete a shipping task.
    
    Parameters:
    
    req - DeleteConsumerRequest
    
    Returns:
    
    DeleteConsumerResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteExport
```
public DeleteExportResponse DeleteExport(DeleteExportRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to delete a log download task.
    
    Parameters:
    
    req - DeleteExportRequest
    
    Returns:
    
    DeleteExportResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteIndex
```
public DeleteIndexResponse DeleteIndex(DeleteIndexRequest req)
                                throws TencentCloudSDKException
```
    This API is used to delete the index configuration of a log topic. After deleting, you cannot retrieve or query the collected logs.
    
    Parameters:
    
    req - DeleteIndexRequest
    
    Returns:
    
    DeleteIndexResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteLogset
```
public DeleteLogsetResponse DeleteLogset(DeleteLogsetRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to delete a logset.
    
    Parameters:
    
    req - DeleteLogsetRequest
    
    Returns:
    
    DeleteLogsetResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteMachineGroup
```
public DeleteMachineGroupResponse DeleteMachineGroup(DeleteMachineGroupRequest req)
                                              throws TencentCloudSDKException
```
    This API is used to delete a machine group.
    
    Parameters:
    
    req - DeleteMachineGroupRequest
    
    Returns:
    
    DeleteMachineGroupResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteMachineGroupInfo
```
public DeleteMachineGroupInfoResponse DeleteMachineGroupInfo(DeleteMachineGroupInfoRequest req)
                                                      throws TencentCloudSDKException
```
    This API is used to delete machine group information.
    
    Parameters:
    
    req - DeleteMachineGroupInfoRequest
    
    Returns:
    
    DeleteMachineGroupInfoResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteShipper
```
public DeleteShipperResponse DeleteShipper(DeleteShipperRequest req)
                                    throws TencentCloudSDKException
```
    This API is used to delete a shipping rule.
    
    Parameters:
    
    req - DeleteShipperRequest
    
    Returns:
    
    DeleteShipperResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteTopic
```
public DeleteTopicResponse DeleteTopic(DeleteTopicRequest req)
                                throws TencentCloudSDKException
```
    This API is used to delete a log topic.
    
    Parameters:
    
    req - DeleteTopicRequest
    
    Returns:
    
    DeleteTopicResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAlarmNotices
```
public DescribeAlarmNoticesResponse DescribeAlarmNotices(DescribeAlarmNoticesRequest req)
                                                  throws TencentCloudSDKException
```
    This API is used to get the notification group list.
    
    Parameters:
    
    req - DescribeAlarmNoticesRequest
    
    Returns:
    
    DescribeAlarmNoticesResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAlarms
```
public DescribeAlarmsResponse DescribeAlarms(DescribeAlarmsRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to get the alarm policy list.
    
    Parameters:
    
    req - DescribeAlarmsRequest
    
    Returns:
    
    DescribeAlarmsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAlertRecordHistory
```
public DescribeAlertRecordHistoryResponse DescribeAlertRecordHistory(DescribeAlertRecordHistoryRequest req)
                                                              throws TencentCloudSDKException
```
    This API is used to get alarm records, such as today's uncleared alarms.
    
    Parameters:
    
    req - DescribeAlertRecordHistoryRequest
    
    Returns:
    
    DescribeAlertRecordHistoryResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeConfigMachineGroups
```
public DescribeConfigMachineGroupsResponse DescribeConfigMachineGroups(DescribeConfigMachineGroupsRequest req)
                                                                throws TencentCloudSDKException
```
    This API is used to get the machine group bound to a collection rule configuration.
    
    Parameters:
    
    req - DescribeConfigMachineGroupsRequest
    
    Returns:
    
    DescribeConfigMachineGroupsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeConfigs
```
public DescribeConfigsResponse DescribeConfigs(DescribeConfigsRequest req)
                                        throws TencentCloudSDKException
```
    This API is used to get a collection rule configuration.
    
    Parameters:
    
    req - DescribeConfigsRequest
    
    Returns:
    
    DescribeConfigsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeConsumer
```
public DescribeConsumerResponse DescribeConsumer(DescribeConsumerRequest req)
                                          throws TencentCloudSDKException
```
    This API is used to query a shipping task.
    
    Parameters:
    
    req - DescribeConsumerRequest
    
    Returns:
    
    DescribeConsumerResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeCosRecharges
```
public DescribeCosRechargesResponse DescribeCosRecharges(DescribeCosRechargesRequest req)
                                                  throws TencentCloudSDKException
```
    This API is used to get COS import configuration.
    
    Parameters:
    
    req - DescribeCosRechargesRequest
    
    Returns:
    
    DescribeCosRechargesResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeExports
```
public DescribeExportsResponse DescribeExports(DescribeExportsRequest req)
                                        throws TencentCloudSDKException
```
    This API is used to get the list of log download tasks.
    
    Parameters:
    
    req - DescribeExportsRequest
    
    Returns:
    
    DescribeExportsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeIndex
```
public DescribeIndexResponse DescribeIndex(DescribeIndexRequest req)
                                    throws TencentCloudSDKException
```
    This API is used to get the index configuration information.
    
    Parameters:
    
    req - DescribeIndexRequest
    
    Returns:
    
    DescribeIndexResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeLogContext
```
public DescribeLogContextResponse DescribeLogContext(DescribeLogContextRequest req)
                                              throws TencentCloudSDKException
```
    This API is used to search for content in the log context.
    
    Parameters:
    
    req - DescribeLogContextRequest
    
    Returns:
    
    DescribeLogContextResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeLogHistogram
```
public DescribeLogHistogramResponse DescribeLogHistogram(DescribeLogHistogramRequest req)
                                                  throws TencentCloudSDKException
```
    This API is used to get a log count histogram.
    
    Parameters:
    
    req - DescribeLogHistogramRequest
    
    Returns:
    
    DescribeLogHistogramResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeLogsets
```
public DescribeLogsetsResponse DescribeLogsets(DescribeLogsetsRequest req)
                                        throws TencentCloudSDKException
```
    This API is used to get the list of logsets.
    
    Parameters:
    
    req - DescribeLogsetsRequest
    
    Returns:
    
    DescribeLogsetsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeMachineGroupConfigs
```
public DescribeMachineGroupConfigsResponse DescribeMachineGroupConfigs(DescribeMachineGroupConfigsRequest req)
                                                                throws TencentCloudSDKException
```
    This API is used to get the collection rule configuration bound to a machine group.
    
    Parameters:
    
    req - DescribeMachineGroupConfigsRequest
    
    Returns:
    
    DescribeMachineGroupConfigsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeMachineGroups
```
public DescribeMachineGroupsResponse DescribeMachineGroups(DescribeMachineGroupsRequest req)
                                                    throws TencentCloudSDKException
```
    This API is used to get the list of machine groups.
    
    Parameters:
    
    req - DescribeMachineGroupsRequest
    
    Returns:
    
    DescribeMachineGroupsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeMachines
```
public DescribeMachinesResponse DescribeMachines(DescribeMachinesRequest req)
                                          throws TencentCloudSDKException
```
    This API is used to get the machine status in the specified machine group.
    
    Parameters:
    
    req - DescribeMachinesRequest
    
    Returns:
    
    DescribeMachinesResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribePartitions
```
public DescribePartitionsResponse DescribePartitions(DescribePartitionsRequest req)
                                              throws TencentCloudSDKException
```
    This API is used to get the list of topic partitions.
    
    Parameters:
    
    req - DescribePartitionsRequest
    
    Returns:
    
    DescribePartitionsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeShipperTasks
```
public DescribeShipperTasksResponse DescribeShipperTasks(DescribeShipperTasksRequest req)
                                                  throws TencentCloudSDKException
```
    This API is used to get the list of shipping tasks.
    
    Parameters:
    
    req - DescribeShipperTasksRequest
    
    Returns:
    
    DescribeShipperTasksResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeShippers
```
public DescribeShippersResponse DescribeShippers(DescribeShippersRequest req)
                                          throws TencentCloudSDKException
```
    This API is used to get the configuration of the task of shipping to COS.
    
    Parameters:
    
    req - DescribeShippersRequest
    
    Returns:
    
    DescribeShippersResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeTopics
```
public DescribeTopicsResponse DescribeTopics(DescribeTopicsRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to get the list of log topics and supports pagination.
    
    Parameters:
    
    req - DescribeTopicsRequest
    
    Returns:
    
    DescribeTopicsResponse
    
    Throws:
    
    TencentCloudSDKException
  - GetAlarmLog
```
public GetAlarmLogResponse GetAlarmLog(GetAlarmLogRequest req)
                                throws TencentCloudSDKException
```
    This API is used to get the records of alarm tasks.
    
    Parameters:
    
    req - GetAlarmLogRequest
    
    Returns:
    
    GetAlarmLogResponse
    
    Throws:
    
    TencentCloudSDKException
  - MergePartition
```
public MergePartitionResponse MergePartition(MergePartitionRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to merge a topic partition in read/write state. During merge, a topic partition ID can be specified, and CLS will automatically merge the partition adjacent to the right of the range.
    
    Parameters:
    
    req - MergePartitionRequest
    
    Returns:
    
    MergePartitionResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyAlarm
```
public ModifyAlarmResponse ModifyAlarm(ModifyAlarmRequest req)
                                throws TencentCloudSDKException
```
    This API is used to modify an alarm policy. At least one valid configuration item needs to be modified.
    
    Parameters:
    
    req - ModifyAlarmRequest
    
    Returns:
    
    ModifyAlarmResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyAlarmNotice
```
public ModifyAlarmNoticeResponse ModifyAlarmNotice(ModifyAlarmNoticeRequest req)
                                            throws TencentCloudSDKException
```
    This API is used to modify a notification group.
    
    Parameters:
    
    req - ModifyAlarmNoticeRequest
    
    Returns:
    
    ModifyAlarmNoticeResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyConfig
```
public ModifyConfigResponse ModifyConfig(ModifyConfigRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to modify a collection rule configuration.
    
    Parameters:
    
    req - ModifyConfigRequest
    
    Returns:
    
    ModifyConfigResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyConsumer
```
public ModifyConsumerResponse ModifyConsumer(ModifyConsumerRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to modify a shipping task.
    
    Parameters:
    
    req - ModifyConsumerRequest
    
    Returns:
    
    ModifyConsumerResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyCosRecharge
```
public ModifyCosRechargeResponse ModifyCosRecharge(ModifyCosRechargeRequest req)
                                            throws TencentCloudSDKException
```
    This API is used to modify a COS import task.
    
    Parameters:
    
    req - ModifyCosRechargeRequest
    
    Returns:
    
    ModifyCosRechargeResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyIndex
```
public ModifyIndexResponse ModifyIndex(ModifyIndexRequest req)
                                throws TencentCloudSDKException
```
    This API is used to modify the index configuration. It is subject to the default request frequency limit, and the number of concurrent requests to the same log topic cannot exceed 1, i.e., the index configuration of only one log topic can be modified at a time.
    
    Parameters:
    
    req - ModifyIndexRequest
    
    Returns:
    
    ModifyIndexResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyLogset
```
public ModifyLogsetResponse ModifyLogset(ModifyLogsetRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to modify a logset.
    
    Parameters:
    
    req - ModifyLogsetRequest
    
    Returns:
    
    ModifyLogsetResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyMachineGroup
```
public ModifyMachineGroupResponse ModifyMachineGroup(ModifyMachineGroupRequest req)
                                              throws TencentCloudSDKException
```
    This API is used to modify a machine group.
    
    Parameters:
    
    req - ModifyMachineGroupRequest
    
    Returns:
    
    ModifyMachineGroupResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyShipper
```
public ModifyShipperResponse ModifyShipper(ModifyShipperRequest req)
                                    throws TencentCloudSDKException
```
    This API is used to modify an existing shipping rule. To use this API, you need to grant CLS the write permission of the specified bucket.
    
    Parameters:
    
    req - ModifyShipperRequest
    
    Returns:
    
    ModifyShipperResponse
    
    Throws:
    
    TencentCloudSDKException
  - ModifyTopic
```
public ModifyTopicResponse ModifyTopic(ModifyTopicRequest req)
                                throws TencentCloudSDKException
```
    This API is used to modify a log topic.
    
    Parameters:
    
    req - ModifyTopicRequest
    
    Returns:
    
    ModifyTopicResponse
    
    Throws:
    
    TencentCloudSDKException
  - OpenKafkaConsumer
```
public OpenKafkaConsumerResponse OpenKafkaConsumer(OpenKafkaConsumerRequest req)
                                            throws TencentCloudSDKException
```
    This API is used to enable the Kafka consumption feature.
    
    Parameters:
    
    req - OpenKafkaConsumerRequest
    
    Returns:
    
    OpenKafkaConsumerResponse
    
    Throws:
    
    TencentCloudSDKException
  - RetryShipperTask
```
public RetryShipperTaskResponse RetryShipperTask(RetryShipperTaskRequest req)
                                          throws TencentCloudSDKException
```
    This API is used to retry a failed shipping task.
    
    Parameters:
    
    req - RetryShipperTaskRequest
    
    Returns:
    
    RetryShipperTaskResponse
    
    Throws:
    
    TencentCloudSDKException
  - SearchLog
```
public SearchLogResponse SearchLog(SearchLogRequest req)
                            throws TencentCloudSDKException
```
    This API is used to search logs. It is subject to the default API rate limit, and the number of concurrent queries to the same log topic cannot exceed 15.
    
    Parameters:
    
    req - SearchLogRequest
    
    Returns:
    
    SearchLogResponse
    
    Throws:
    
    TencentCloudSDKException
  - SplitPartition
```
public SplitPartitionResponse SplitPartition(SplitPartitionRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to split a topic partition.
    
    Parameters:
    
    req - SplitPartitionRequest
    
    Returns:
    
    SplitPartitionResponse
    
    Throws:
    
    TencentCloudSDKException
  - UploadLog
```
public UploadLogResponse UploadLog(UploadLogRequest req)
                            throws TencentCloudSDKException
```
    ## Note To ensure log data reliability and help you use CLS more efficiently, we recommend you use the optimized API to upload logs. For more information about the API, see [Uploading Log via API](https://www.tencentcloud.com/document/product/614/50267). For the optimized API, we have developed an SDK (available in multiple languages) that provides features including async sending, resource control, automatic retry, graceful shutdown, and detection-based reporting. For details, see [Uploading Log via SDK](https://intl.cloud.tencent.com/document/product/614/45006). `UploadLog` allows you to synchronously upload log data. If you still want to continue to use this API instead of the optimized one, read this document. ## Feature Description This API is used to write logs to a specified log topic. CLS provides the following two modes: #### Load balancing mode In this mode, logs will be automatically written to a target partition among all readable/writable partitions under the current log topic based on the load balancing principle. This mode is suitable for scenarios where sequential consumption is not needed. #### Hash routing mode In this mode, data will be written to a target partition that meets the range requirements based on the carried hash value (`X-CLS-HashKey`). For example, a log source can be bound to a topic partition through `HashKey`, strictly guaranteeing the sequence of the data written to and consumed in this partition. #### Input parameters (pb binary streams in `body`) | Parameter | Type | Location | Required | Description | | ------------ | ------- | ---- | ---- | ------------------------------------------------------------ | | logGroupList | message | pb | Yes | The `logGroup` list, which describes the encapsulated log groups. We recommend you enter up to five `logGroup` values. | `LogGroup` description: | Parameter | Required | Description | | ----------- | -------- | ------------------------------------------------------------ | | logs | Yes | Log array consisting of multiple `Log` values. The `Log` indicates a log, and a `LogGroup` can contain up to 10,000 `Log` values. | | contextFlow | No | Unique `LogGroup` ID, which should be passed in if the context feature needs to be used. Format: "{context ID}-{LogGroupID}".
    Context ID: Uniquely identifies the context (a series of log files that are continuously scrolling or a series of logs that need to be sequenced), which is a 64-bit integer hex string.
    LogGroupID: A 64-bit integer hex string that continuously increases, such as `102700A66102516A-59F59`. | | filename | No | Log filename | | source | No | Log source, which is generally the machine IP | | logTags | No | List of log tags | `Log` description: | Parameter | Required | Description | | -------- | -------- | ------------------------------------------------------------ | | time | Yes | Unix timestamp of log time in seconds or milliseconds (recommended) | | contents | No | Log content in key-value format. A log can contain multiple key-value pairs. | `Content` description: | Parameter | Required | Description | | ------ | -------- | ------------------------------------------------------------ | | key | Yes | Key of a field group in one log, which cannot start with `_`. | | value | Yes | Value of a field group. The `value` of one log cannot exceed 1 MB and the total `value` in `LogGroup` cannot exceed 5 MB. | `LogTag` description: | Parameter | Required | Description | | ------ | -------- | -------------------------------- | | key | Yes | Key of a custom tag | | value | Yes | Value corresponding to the custom tag key | ## pb Compilation Sample This sample describes how to use the protoc compiler to compile the pb description file into a log upload API in C++. > ?Currently, protoc supports compilation in multiple programming languages such as Java, C++, and Python. For more information, see [protoc](https://github.com/protocolbuffers/protobuf). #### 1. Install Protocol Buffers Download [Protocol Buffers](https://main.qcloudimg.com/raw/d7810aaf8b3073fbbc9d4049c21532aa/protobuf-2.6.1.tar.gz), decompress the package, and install the tool. The version used in the sample is protobuf 2.6.1 running on CentOS 7.3. Run the following command to decompress the `protobuf-2.6.1.tar.gz` package to the `/usr/local` directory and go to the directory: ``` tar -zxvf protobuf-2.6.1.tar.gz -C /usr/local/ && cd /usr/local/protobuf-2.6.1 ``` Run the following commands to start compilation and installation, and configure the environment variables: ``` [root@VM_0_8_centos protobuf-2.6.1]# ./configure [root@VM_0_8_centos protobuf-2.6.1]# make && make install [root@VM_0_8_centos protobuf-2.6.1]# export PATH=$PATH:/usr/local/protobuf-2.6.1/bin ``` After the compilation succeeds, run the following command to check the version: ``` [root@VM_0_8_centos protobuf-2.6.1]# protoc --version liprotoc 2.6.1 ``` #### 2. Create a pb description file A pb description file is an agreed-on data interchange format for communication. To upload logs, compile the specified protocol format to an API in the target programming language and add the API to the project code. For more information, see [protoc](https://github.com/protocolbuffers/protobuf). Create a pb message description file `cls.proto` based on the pb data format content specified by CLS. > !The pb description file content cannot be modified, and the filename must end with `.proto`. The content of `cls.proto` (pb description file) is as follows: ``` package cls; message Log { message Content { required string key = 1; // Key of each field group required string value = 2; // Value of each field group } required int64 time = 1; // Unix timestamp repeated Content contents = 2; // Multiple key-value pairs in one log } message LogTag { required string key = 1; required string value = 2; } message LogGroup { repeated Log logs = 1; // Log array consisting of multiple logs optional string contextFlow = 2; // This parameter does not take effect currently optional string filename = 3; // Log filename optional string source = 4; // Log source, which is generally the machine IP repeated LogTag logTags = 5; } message LogGroupList { repeated LogGroup logGroupList = 1; // Log group list } ``` #### 3. Compile and generate the API This sample uses the proto compiler to generate a C++ file in the same directory as the `cls.proto` file. Run the following compilation command: ``` protoc --cpp_out=./ ./cls.proto ``` > ?`--cpp_out=./` indicates that the file will be compiled in cpp format and output to the current directory. `./cls.proto` indicates the `cls.proto` description file in the current directory. After the compilation succeeds, the code file in the corresponding programming language will be generated. This sample generates the `cls.pb.h` header file and [cls.pb.cc](http://cls.pb.cc) code implementation file as shown below: ``` [root@VM_0_8_centos protobuf-2.6.1]# protoc --cpp_out=./ ./cls.proto [root@VM_0_8_centos protobuf-2.6.1]# ls cls.pb.cc cls.pb.h cls.proto ``` #### 4. Call the API Import the generated `cls.pb.h` header file into the code and call the API for data encapsulation.
    
    Parameters:
    
    req - UploadLogRequest
    
    Returns:
    
    UploadLogResponse
    
    Throws:
    
    TencentCloudSDKException

Class ClsClient

Field Summary

Fields inherited from class com.tencentcloudapi.common.AbstractClient

Constructor Summary

Method Summary

Methods inherited from class com.tencentcloudapi.common.AbstractClient

Methods inherited from class java.lang.Object

Constructor Detail

ClsClient

ClsClient

Method Detail

AddMachineGroupInfo

ApplyConfigToMachineGroup

CloseKafkaConsumer

CreateAlarm

CreateAlarmNotice

CreateConfig

CreateConsumer

CreateCosRecharge

CreateExport

CreateIndex

CreateLogset

CreateMachineGroup

CreateShipper

CreateTopic

DeleteAlarm

DeleteAlarmNotice

DeleteConfig

DeleteConfigFromMachineGroup

DeleteConsumer

DeleteExport

DeleteIndex

DeleteLogset

DeleteMachineGroup

DeleteMachineGroupInfo

DeleteShipper

DeleteTopic

DescribeAlarmNotices

DescribeAlarms

DescribeAlertRecordHistory

DescribeConfigMachineGroups

DescribeConfigs

DescribeConsumer

DescribeCosRecharges

DescribeExports

DescribeIndex

DescribeLogContext

DescribeLogHistogram

DescribeLogsets

DescribeMachineGroupConfigs

DescribeMachineGroups

DescribeMachines

DescribePartitions

DescribeShipperTasks

DescribeShippers

DescribeTopics

GetAlarmLog

MergePartition

ModifyAlarm

ModifyAlarmNotice

ModifyConfig

ModifyConsumer

ModifyCosRecharge

ModifyIndex

ModifyLogset

ModifyMachineGroup

ModifyShipper

ModifyTopic

OpenKafkaConsumer

RetryShipperTask

SearchLog

SplitPartition

UploadLog