ClsClient (tencentcloud-sdk-java-intl-en 3.0.340 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
`ApplyConfigToMachineGroupResponse`	`ApplyConfigToMachineGroup(ApplyConfigToMachineGroupRequest req)` This API is used to apply the collection configuration to the specified machine group.
`CreateAlarmResponse`	`CreateAlarm(CreateAlarmRequest req)` This API is used to create an alarm policy.
`CreateAlarmNoticeResponse`	`CreateAlarmNotice(CreateAlarmNoticeRequest req)` This API is used to create an alarm notification template.
`CreateAsyncContextTaskResponse`	`CreateAsyncContextTask(CreateAsyncContextTaskRequest req)` This API is used to create an offline context search task.
`CreateAsyncSearchTaskResponse`	`CreateAsyncSearchTask(CreateAsyncSearchTaskRequest req)` This API is used to create an offline search task.
`CreateConfigResponse`	`CreateConfig(CreateConfigRequest req)` This API is used to create a collection rule configuration.
`CreateExportResponse`	`CreateExport(CreateExportRequest req)` This API is used to create a log 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 shipping rule.
`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 an alarm notification template.
`DeleteAsyncContextTaskResponse`	`DeleteAsyncContextTask(DeleteAsyncContextTaskRequest req)` This API is used to delete an offline context search task.
`DeleteAsyncSearchTaskResponse`	`DeleteAsyncSearchTask(DeleteAsyncSearchTaskRequest req)` This API is used to delete an offline search task.
`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.
`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.
`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 list of alarm notification templates.
`DescribeAlarmsResponse`	`DescribeAlarms(DescribeAlarmsRequest req)` This API is used to get the list of alarm policies.
`DescribeAsyncContextResultResponse`	`DescribeAsyncContextResult(DescribeAsyncContextResultRequest req)` This API is used to get the result of an offline context search task.
`DescribeAsyncContextTasksResponse`	`DescribeAsyncContextTasks(DescribeAsyncContextTasksRequest req)` This API is used to get the list of offline context search tasks.
`DescribeAsyncSearchResultResponse`	`DescribeAsyncSearchResult(DescribeAsyncSearchResultRequest req)` This API is used to get the result of an offline search task.
`DescribeAsyncSearchTasksResponse`	`DescribeAsyncSearchTasks(DescribeAsyncSearchTasksRequest req)` This API is used to get the list of offline search tasks.
`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.
`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.
`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 list of shipping rules.
`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 an alarm notification template.
`ModifyConfigResponse`	`ModifyConfig(ModifyConfigRequest req)` This API is used to modify a collection rule configuration.
`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.
`RetryShipperTaskResponse`	`RetryShipperTask(RetryShipperTaskRequest req)` This API is used to retry a failed shipping task.
`SearchLogResponse`	`SearchLog(SearchLogRequest req)` This API is used to search for logs.
`SplitPartitionResponse`	`SplitPartition(SplitPartitionRequest req)` This API is used to split a topic partition.
`UploadLogResponse`	`UploadLog(UploadLogRequest req)` ## Feature Description This API is used to write logs to a specified log topic.

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
  - 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
  - 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 an alarm notification template.
    
    Parameters:
    
    req - CreateAlarmNoticeRequest
    
    Returns:
    
    CreateAlarmNoticeResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateAsyncContextTask
```
public CreateAsyncContextTaskResponse CreateAsyncContextTask(CreateAsyncContextTaskRequest req)
                                                      throws TencentCloudSDKException
```
    This API is used to create an offline context search task.
    
    Parameters:
    
    req - CreateAsyncContextTaskRequest
    
    Returns:
    
    CreateAsyncContextTaskResponse
    
    Throws:
    
    TencentCloudSDKException
  - CreateAsyncSearchTask
```
public CreateAsyncSearchTaskResponse CreateAsyncSearchTask(CreateAsyncSearchTaskRequest req)
                                                    throws TencentCloudSDKException
```
    This API is used to create an offline search task.
    
    Parameters:
    
    req - CreateAsyncSearchTaskRequest
    
    Returns:
    
    CreateAsyncSearchTaskResponse
    
    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
  - CreateExport
```
public CreateExportResponse CreateExport(CreateExportRequest req)
                                  throws TencentCloudSDKException
```
    This API is used to create a log download task.
    
    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 shipping rule. To use this API, you need to grant CLS the write permission of the specified bucket.
    
    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 an alarm notification template.
    
    Parameters:
    
    req - DeleteAlarmNoticeRequest
    
    Returns:
    
    DeleteAlarmNoticeResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteAsyncContextTask
```
public DeleteAsyncContextTaskResponse DeleteAsyncContextTask(DeleteAsyncContextTaskRequest req)
                                                      throws TencentCloudSDKException
```
    This API is used to delete an offline context search task.
    
    Parameters:
    
    req - DeleteAsyncContextTaskRequest
    
    Returns:
    
    DeleteAsyncContextTaskResponse
    
    Throws:
    
    TencentCloudSDKException
  - DeleteAsyncSearchTask
```
public DeleteAsyncSearchTaskResponse DeleteAsyncSearchTask(DeleteAsyncSearchTaskRequest req)
                                                    throws TencentCloudSDKException
```
    This API is used to delete an offline search task.
    
    Parameters:
    
    req - DeleteAsyncSearchTaskRequest
    
    Returns:
    
    DeleteAsyncSearchTaskResponse
    
    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
  - 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.
    
    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
  - 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 list of alarm notification templates.
    
    Parameters:
    
    req - DescribeAlarmNoticesRequest
    
    Returns:
    
    DescribeAlarmNoticesResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAlarms
```
public DescribeAlarmsResponse DescribeAlarms(DescribeAlarmsRequest req)
                                      throws TencentCloudSDKException
```
    This API is used to get the list of alarm policies.
    
    Parameters:
    
    req - DescribeAlarmsRequest
    
    Returns:
    
    DescribeAlarmsResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAsyncContextResult
```
public DescribeAsyncContextResultResponse DescribeAsyncContextResult(DescribeAsyncContextResultRequest req)
                                                              throws TencentCloudSDKException
```
    This API is used to get the result of an offline context search task.
    
    Parameters:
    
    req - DescribeAsyncContextResultRequest
    
    Returns:
    
    DescribeAsyncContextResultResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAsyncContextTasks
```
public DescribeAsyncContextTasksResponse DescribeAsyncContextTasks(DescribeAsyncContextTasksRequest req)
                                                            throws TencentCloudSDKException
```
    This API is used to get the list of offline context search tasks.
    
    Parameters:
    
    req - DescribeAsyncContextTasksRequest
    
    Returns:
    
    DescribeAsyncContextTasksResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAsyncSearchResult
```
public DescribeAsyncSearchResultResponse DescribeAsyncSearchResult(DescribeAsyncSearchResultRequest req)
                                                            throws TencentCloudSDKException
```
    This API is used to get the result of an offline search task.
    
    Parameters:
    
    req - DescribeAsyncSearchResultRequest
    
    Returns:
    
    DescribeAsyncSearchResultResponse
    
    Throws:
    
    TencentCloudSDKException
  - DescribeAsyncSearchTasks
```
public DescribeAsyncSearchTasksResponse DescribeAsyncSearchTasks(DescribeAsyncSearchTasksRequest req)
                                                          throws TencentCloudSDKException
```
    This API is used to get the list of offline search tasks.
    
    Parameters:
    
    req - DescribeAsyncSearchTasksRequest
    
    Returns:
    
    DescribeAsyncSearchTasksResponse
    
    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
  - 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
  - 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 list of shipping rules.
    
    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 an alarm notification template.
    
    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
  - ModifyIndex
```
public ModifyIndexResponse ModifyIndex(ModifyIndexRequest req)
                                throws TencentCloudSDKException
```
    This API is used to modify the index configuration.
    
    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
  - 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 for logs.
    
    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
```
    ## 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 the 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 hash value (`X-CLS-HashKey`) carried by data. 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. In addition, CLS allows you to upload logs in the following two modes: #### 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 5 `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 | Tag list of logs | `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, please 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 enter 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, please compile the specified protocol format to an API in the target programming language and add the API to the project code. For more information, please 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 commands: ``` 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` 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

ApplyConfigToMachineGroup

CreateAlarm

CreateAlarmNotice

CreateAsyncContextTask

CreateAsyncSearchTask

CreateConfig

CreateExport

CreateIndex

CreateLogset

CreateMachineGroup

CreateShipper

CreateTopic

DeleteAlarm

DeleteAlarmNotice

DeleteAsyncContextTask

DeleteAsyncSearchTask

DeleteConfig

DeleteConfigFromMachineGroup

DeleteExport

DeleteIndex

DeleteLogset

DeleteMachineGroup

DeleteShipper

DeleteTopic

DescribeAlarmNotices

DescribeAlarms

DescribeAsyncContextResult

DescribeAsyncContextTasks

DescribeAsyncSearchResult

DescribeAsyncSearchTasks

DescribeConfigMachineGroups

DescribeConfigs

DescribeExports

DescribeIndex

DescribeLogContext

DescribeLogsets

DescribeMachineGroupConfigs

DescribeMachineGroups

DescribeMachines

DescribePartitions

DescribeShipperTasks

DescribeShippers

DescribeTopics

GetAlarmLog

MergePartition

ModifyAlarm

ModifyAlarmNotice

ModifyConfig

ModifyIndex

ModifyLogset

ModifyMachineGroup

ModifyShipper

ModifyTopic

RetryShipperTask

SearchLog

SplitPartition

UploadLog