tencentcloud-sdk-nodejs 4.0.691 → 4.0.693

package/src/services/cls/v20201016/cls_client.ts

@@ -44,6 +44,7 @@ import {
   DescribeShippersRequest,
   CreateScheduledSqlResponse,
   DescribeDashboardsRequest,
+  QueryMetricRequest,
   LogItem,
   SearchLogResponse,
   DeleteTopicRequest,
@@ -93,6 +94,7 @@ import {
   DataTransformResouceInfo,
   DeleteMachineGroupRequest,
   FullTextInfo,
+  QueryMetricResponse,
   DescribePartitionsResponse,
   DescribeConfigMachineGroupsResponse,
   ModifyAlarmRequest,
@@ -131,6 +133,7 @@ import {
   DeleteConfigResponse,
   ModifyIndexResponse,
   DeleteConsumerRequest,
+  QueryRangeMetricResponse,
   DeleteIndexRequest,
   DescribeConsumerResponse,
   SearchLogTopics,
@@ -147,6 +150,7 @@ import {
   CloseKafkaConsumerRequest,
   RuleTagInfo,
   CreateExportRequest,
+  QueryRangeMetricRequest,
   DescribeAlarmNoticesResponse,
   DeleteDataTransformRequest,
   DescribeMachineGroupsResponse,
@@ -277,277 +281,223 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 创建机器组
+   * 修改Kafka协议消费信息
    */
-  async CreateMachineGroup(
-    req: CreateMachineGroupRequest,
-    cb?: (error: string, rep: CreateMachineGroupResponse) => void
-  ): Promise<CreateMachineGroupResponse> {
-    return this.request("CreateMachineGroup", req, cb)
+  async ModifyKafkaConsumer(
+    req: ModifyKafkaConsumerRequest,
+    cb?: (error: string, rep: ModifyKafkaConsumerResponse) => void
+  ): Promise<ModifyKafkaConsumerResponse> {
+    return this.request("ModifyKafkaConsumer", req, cb)
   }
 
   /**
-   * 用于删除机器组信息
+   * 本接口用于创建Kafka数据订阅任务
    */
-  async DeleteMachineGroupInfo(
-    req: DeleteMachineGroupInfoRequest,
-    cb?: (error: string, rep: DeleteMachineGroupInfoResponse) => void
-  ): Promise<DeleteMachineGroupInfoResponse> {
-    return this.request("DeleteMachineGroupInfo", req, cb)
+  async CreateKafkaRecharge(
+    req: CreateKafkaRechargeRequest,
+    cb?: (error: string, rep: CreateKafkaRechargeResponse) => void
+  ): Promise<CreateKafkaRechargeResponse> {
+    return this.request("CreateKafkaRecharge", req, cb)
   }
 
   /**
-   * 本接口用于获取告警任务历史
+   * 本接口用于获取日志下载任务列表
    */
-  async GetAlarmLog(
-    req: GetAlarmLogRequest,
-    cb?: (error: string, rep: GetAlarmLogResponse) => void
-  ): Promise<GetAlarmLogResponse> {
-    return this.request("GetAlarmLog", req, cb)
+  async DescribeExports(
+    req: DescribeExportsRequest,
+    cb?: (error: string, rep: DescribeExportsResponse) => void
+  ): Promise<DescribeExportsResponse> {
+    return this.request("DescribeExports", req, cb)
   }
 
   /**
-     * ## 提示
-为了保障您日志数据的可靠性以及更高效地使用日志服务，建议您使用CLS优化后的接口[上传结构化日志](https://cloud.tencent.com/document/product/614/16873)。
-
-同时我们给此接口专门优化定制了多个语言版本的SDK供您选择，SDK提供统一的异步发送、资源控制、自动重试、优雅关闭、感知上报等功能，使上报日志功能更完善，详情请参考[SDK采集](https://cloud.tencent.com/document/product/614/67157)。
-
-同时云API上传日志接口也支持同步上传日志数据，如果您选择继续使用此接口请参考下文。
-
-## 功能描述
-
-本接口用于将日志写入到指定的日志主题。
-
-日志服务提供以下两种模式：
-
-#### 负载均衡模式
-
-系统根据当前日志主题下所有可读写的分区，遵循负载均衡原则自动分配写入的目标分区。该模式适合消费不保序的场景。
-
-#### 哈希路由模式
-
-系统根据携带的哈希值（X-CLS-HashKey）将数据写入到符合范围要求的目标分区。例如，可以将某个日志源端通过 hashkey 与某个主题分区强绑定，这样可以保证数据在该分区上写入和消费是严格保序的。
-
-                 
-
-#### 输入参数(pb二进制流，位于body中)
-
-| 字段名       | 类型    | 位置 | 必须 | 含义                                                         |
-| ------------ | ------- | ---- | ---- | ------------------------------------------------------------ |
-| logGroupList | message | pb   | 是   | logGroup 列表，封装好的日志组列表内容，建议 logGroup 数量不要超过5个 |
-
-LogGroup 说明：
-
-| 字段名      | 是否必选 | 含义                                                         |
-| ----------- | -------- | ------------------------------------------------------------ |
-| logs        | 是       | 日志数组，表示有多个 Log 组成的集合，一个 Log 表示一条日志，一个 LogGroup 中 Log 个数不能超过10000 |
-| contextFlow | 否       | LogGroup 的唯一ID，需要使用上下文功能时传入。格式："{上下文ID}-{LogGroupID}"。<br>上下文ID：唯一标识一个上下文（连续滚动的一系列日志文件，或者是需要保序的一系列日志），16进制64位整型字符串。<br>LogGroupID：连续递增的一串整型，16进制64位整型字符串。样例："102700A66102516A-59F59"。                        |
-| filename    | 否       | 日志文件名                                                   |
-| source      | 否       | 日志来源，一般使用机器 IP 作为标识                           |
-| logTags     | 否       | 日志的标签列表                                               |
-
-Log 说明：
-
-| 字段名   | 是否必选 | 含义                                                         |
-| -------- | -------- | ------------------------------------------------------------ |
-| time     | 是       | 日志时间（Unix 格式时间戳），支持秒、毫秒，建议采用毫秒      |
-| contents | 否       | key-value 格式的日志内容，表示一条日志里的多个 key-value 组合 |
-
-Content 说明：
-
-| 字段名 | 是否必选 | 含义                                                         |
-| ------ | -------- | ------------------------------------------------------------ |
-| key    | 是       | 单条日志里某个字段组的 key 值，不能以`_`开头                 |
-| value  | 是       | 单条日志某个字段组的 value 值，单条日志 value 不能超过1MB，LogGroup 中所有 value 总和不能超过5MB |
-
-LogTag 说明：
-
-| 字段名 | 是否必选 | 含义                             |
-| ------ | -------- | -------------------------------- |
-| key    | 是       | 自定义的标签 key                 |
-| value  | 是       | 自定义的标签 key 对应的 value 值 |
-
-## PB 编译示例
-
-本示例将说明如何使用官方 protoc 编译工具将 PB 描述文件 编译生成为 C++ 语言可调用的上传日志接口。
-
-> ?目前 protoc 官方支持 Java、C++、Python 等语言的编译，详情请参见 [protoc](https://github.com/protocolbuffers/protobuf)。
-
-#### 1. 安装 Protocol Buffer
-
-下载 [Protocol Buffer](https://main.qcloudimg.com/raw/d7810aaf8b3073fbbc9d4049c21532aa/protobuf-2.6.1.tar.gz) ，解压并安装。示例版本为 protobuf 2.6.1，环境为 Centos 7.3 系统。 解压`protobuf-2.6.1.tar.gz`压缩包至`/usr/local`目录并进入该目录，执行命令如下：
-
-```
-tar -zxvf protobuf-2.6.1.tar.gz -C /usr/local/ && cd /usr/local/protobuf-2.6.1
-```
-
-开始编译和安装，配置环境变量，执行命令如下：
-
-```
-[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
-```
-
-编译成功后，您可以使用以下命令查看版本：
-
-```
-[root@VM_0_8_centos protobuf-2.6.1]# protoc --version
-liprotoc 2.6.1
-```
-
-#### 2. 创建 PB 描述文件
-
-PB 描述文件是通信双方约定的数据交换格式，上传日志时须将规定的协议格式编译成对应语言版本的调用接口，然后添加到工程代码里，详情请参见 [protoc](https://github.com/protocolbuffers/protobuf) 。
-
-以日志服务所规定的 PB 数据格式内容为准， 在本地创建 PB 消息描述文件 cls.proto。
-
-> !PB 描述文件内容不可更改，且文件名须以`.proto`结尾。
-
-cls.proto 内容（PB 描述文件）如下：
-
-```
-package cls;
-
-message Log
-{
-    message Content
-    {
-        required string key   = 1; // 每组字段的 key
-        required string value = 2; // 每组字段的 value
-    }
-    required int64   time     = 1; // 时间戳，UNIX时间格式
-    repeated Content contents = 2; // 一条日志里的多个kv组合
-}
-
-message LogTag
-{
-    required string key       = 1;
-    required string value     = 2;
-}
+   * 本接口用于创建索引
+   */
+  async CreateIndex(
+    req: CreateIndexRequest,
+    cb?: (error: string, rep: CreateIndexResponse) => void
+  ): Promise<CreateIndexResponse> {
+    return this.request("CreateIndex", req, cb)
+  }
 
-message LogGroup
-{
-    repeated Log    logs        = 1; // 多条日志合成的日志数组
-    optional string contextFlow = 2; // 目前暂无效用
-    optional string filename    = 3; // 日志文件名
-    optional string source      = 4; // 日志来源，一般使用机器IP
-    repeated LogTag logTags     = 5;
-}
+  /**
+   * 修改现有的投递规则，客户如果使用此接口，需要自行处理CLS对指定bucket的写权限。
+   */
+  async ModifyShipper(
+    req: ModifyShipperRequest,
+    cb?: (error: string, rep: ModifyShipperResponse) => void
+  ): Promise<ModifyShipperResponse> {
+    return this.request("ModifyShipper", req, cb)
+  }
 
-message LogGroupList
-{
-    repeated LogGroup logGroupList = 1; // 日志组列表
-}
-```
+  /**
+   * 获取采集规则配置
+   */
+  async DescribeConfigs(
+    req: DescribeConfigsRequest,
+    cb?: (error: string, rep: DescribeConfigsResponse) => void
+  ): Promise<DescribeConfigsResponse> {
+    return this.request("DescribeConfigs", req, cb)
+  }
 
-#### 3. 编译生成
+  /**
+   * 本接口用于删除日志集。
+   */
+  async DeleteLogset(
+    req: DeleteLogsetRequest,
+    cb?: (error: string, rep: DeleteLogsetResponse) => void
+  ): Promise<DeleteLogsetResponse> {
+    return this.request("DeleteLogset", req, cb)
+  }
 
-此例中，使用 proto 编译器生成 C++ 语言的文件，在 cls.proto 文件的同一目录下，执行如下编译命令：
+  /**
+   * 删除应用到机器组的采集配置
+   */
+  async DeleteConfigFromMachineGroup(
+    req: DeleteConfigFromMachineGroupRequest,
+    cb?: (error: string, rep: DeleteConfigFromMachineGroupResponse) => void
+  ): Promise<DeleteConfigFromMachineGroupResponse> {
+    return this.request("DeleteConfigFromMachineGroup", req, cb)
+  }
 
-```
-protoc --cpp_out=./ ./cls.proto 
-```
+  /**
+   * 本接口用于删除数据加工任务
+   */
+  async DeleteDataTransform(
+    req: DeleteDataTransformRequest,
+    cb?: (error: string, rep: DeleteDataTransformResponse) => void
+  ): Promise<DeleteDataTransformResponse> {
+    return this.request("DeleteDataTransform", req, cb)
+  }
 
-> ?`--cpp_out=./`表示编译成 cpp 格式并输出当前目录下，`./cls.proto`表示位于当前目录下的 cls.proto 描述文件。
+  /**
+   * 本接口用于创建日志集，返回新创建的日志集的 ID。
+   */
+  async CreateLogset(
+    req: CreateLogsetRequest,
+    cb?: (error: string, rep: CreateLogsetResponse) => void
+  ): Promise<CreateLogsetResponse> {
+    return this.request("CreateLogset", req, cb)
+  }
 
-编译成功后，会输出对应语言的代码文件。此例会生成 cls.pb.h 头文件和 [cls.pb.cc](http://cls.pb.cc) 代码实现文件，如下所示：
+  /**
+   * 本接口用于创建日志主题。
+   */
+  async CreateTopic(
+    req: CreateTopicRequest,
+    cb?: (error: string, rep: CreateTopicResponse) => void
+  ): Promise<CreateTopicResponse> {
+    return this.request("CreateTopic", req, cb)
+  }
 
-```
-[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
-```
+  /**
+   * 该接口用于删除通知渠道组
+   */
+  async DeleteAlarmNotice(
+    req: DeleteAlarmNoticeRequest,
+    cb?: (error: string, rep: DeleteAlarmNoticeResponse) => void
+  ): Promise<DeleteAlarmNoticeResponse> {
+    return this.request("DeleteAlarmNotice", req, cb)
+  }
 
-#### 4. 调用
+  /**
+   * 获取告警历史，例如今天未恢复的告警
+   */
+  async DescribeAlertRecordHistory(
+    req: DescribeAlertRecordHistoryRequest,
+    cb?: (error: string, rep: DescribeAlertRecordHistoryResponse) => void
+  ): Promise<DescribeAlertRecordHistoryResponse> {
+    return this.request("DescribeAlertRecordHistory", req, cb)
+  }
 
-将生成的 cls.pb.h 头文件引入代码中，调用接口进行数据格式封装。
-     */
-  async UploadLog(
-    req: UploadLogRequest,
-    cb?: (error: string, rep: UploadLogResponse) => void
-  ): Promise<UploadLogResponse> {
-    return this.request("UploadLog", req, cb)
+  /**
+   * 本接口用于删除Kafka数据订阅任务
+   */
+  async DeleteKafkaRecharge(
+    req: DeleteKafkaRechargeRequest,
+    cb?: (error: string, rep: DeleteKafkaRechargeResponse) => void
+  ): Promise<DeleteKafkaRechargeResponse> {
+    return this.request("DeleteKafkaRecharge", req, cb)
   }
 
   /**
-   * 本接口用于创建投递任务
+   * 创建采集规则配置
    */
-  async CreateConsumer(
-    req: CreateConsumerRequest,
-    cb?: (error: string, rep: CreateConsumerResponse) => void
-  ): Promise<CreateConsumerResponse> {
-    return this.request("CreateConsumer", req, cb)
+  async CreateConfig(
+    req: CreateConfigRequest,
+    cb?: (error: string, rep: CreateConfigResponse) => void
+  ): Promise<CreateConfigResponse> {
+    return this.request("CreateConfig", req, cb)
   }
 
   /**
-   * 本接口用于获取kafka用户信息
+   * 查询指定时刻指标的最新值
    */
-  async DescribeKafkaUser(
-    req: DescribeKafkaUserRequest,
-    cb?: (error: string, rep: DescribeKafkaUserResponse) => void
-  ): Promise<DescribeKafkaUserResponse> {
-    return this.request("DescribeKafkaUser", req, cb)
+  async QueryMetric(
+    req: QueryMetricRequest,
+    cb?: (error: string, rep: QueryMetricResponse) => void
+  ): Promise<QueryMetricResponse> {
+    return this.request("QueryMetric", req, cb)
   }
 
   /**
-   * 本接口用于修改日志主题。
+   * 本接口用于获取日志主题列表，支持分页
    */
-  async ModifyTopic(
-    req: ModifyTopicRequest,
-    cb?: (error: string, rep: ModifyTopicResponse) => void
-  ): Promise<ModifyTopicResponse> {
-    return this.request("ModifyTopic", req, cb)
+  async DescribeTopics(
+    req: DescribeTopicsRequest,
+    cb?: (error: string, rep: DescribeTopicsResponse) => void
+  ): Promise<DescribeTopicsResponse> {
+    return this.request("DescribeTopics", req, cb)
   }
 
   /**
-   * 本接口用于预览cos导入信息
+   * 本接口用于创建cos导入任务
    */
-  async SearchCosRechargeInfo(
-    req: SearchCosRechargeInfoRequest,
-    cb?: (error: string, rep: SearchCosRechargeInfoResponse) => void
-  ): Promise<SearchCosRechargeInfoResponse> {
-    return this.request("SearchCosRechargeInfo", req, cb)
+  async CreateCosRecharge(
+    req: CreateCosRechargeRequest,
+    cb?: (error: string, rep: CreateCosRechargeResponse) => void
+  ): Promise<CreateCosRechargeResponse> {
+    return this.request("CreateCosRecharge", req, cb)
   }
 
   /**
-   * 本接口用于获取cos导入配置
+   * 本接口用于合并一个读写态的主题分区，合并时指定一个主题分区 ID，日志服务会自动合并范围右相邻的分区。
    */
-  async DescribeCosRecharges(
-    req: DescribeCosRechargesRequest,
-    cb?: (error: string, rep: DescribeCosRechargesResponse) => void
-  ): Promise<DescribeCosRechargesResponse> {
-    return this.request("DescribeCosRecharges", req, cb)
+  async MergePartition(
+    req: MergePartitionRequest,
+    cb?: (error: string, rep: MergePartitionResponse) => void
+  ): Promise<MergePartitionResponse> {
+    return this.request("MergePartition", req, cb)
   }
 
   /**
-   * 本接口用于获取日志集信息列表。
+   * 本接口用于删除定时SQL分析任务
    */
-  async DescribeLogsets(
-    req: DescribeLogsetsRequest,
-    cb?: (error: string, rep: DescribeLogsetsResponse) => void
-  ): Promise<DescribeLogsetsResponse> {
-    return this.request("DescribeLogsets", req, cb)
+  async DeleteScheduledSql(
+    req: DeleteScheduledSqlRequest,
+    cb?: (error: string, rep: DeleteScheduledSqlResponse) => void
+  ): Promise<DeleteScheduledSqlResponse> {
+    return this.request("DeleteScheduledSql", req, cb)
   }
 
   /**
-   * 本接口用于修改Kafka数据订阅任务
+   * 本接口仅创建下载任务，任务返回的下载地址，请用户调用DescribeExports查看任务列表。其中有下载地址CosPath参数。参考文档https://cloud.tencent.com/document/product/614/56449
    */
-  async ModifyKafkaRecharge(
-    req: ModifyKafkaRechargeRequest,
-    cb?: (error: string, rep: ModifyKafkaRechargeResponse) => void
-  ): Promise<ModifyKafkaRechargeResponse> {
-    return this.request("ModifyKafkaRecharge", req, cb)
+  async CreateExport(
+    req: CreateExportRequest,
+    cb?: (error: string, rep: CreateExportResponse) => void
+  ): Promise<CreateExportResponse> {
+    return this.request("CreateExport", req, cb)
   }
 
   /**
-   * 本接口用于获取日志下载任务列表
+   * 关闭Kafka协议消费
    */
-  async DescribeExports(
-    req: DescribeExportsRequest,
-    cb?: (error: string, rep: DescribeExportsResponse) => void
-  ): Promise<DescribeExportsResponse> {
-    return this.request("DescribeExports", req, cb)
+  async CloseKafkaConsumer(
+    req: CloseKafkaConsumerRequest,
+    cb?: (error: string, rep: CloseKafkaConsumerResponse) => void
+  ): Promise<CloseKafkaConsumerResponse> {
+    return this.request("CloseKafkaConsumer", req, cb)
   }
 
   /**
@@ -561,6 +511,16 @@ cls.pb.cc cls.pb.h cls.proto
     return this.request("ModifyIndex", req, cb)
   }
 
+  /**
+   * 本接口用于获取索引配置信息
+   */
+  async DescribeIndex(
+    req: DescribeIndexRequest,
+    cb?: (error: string, rep: DescribeIndexResponse) => void
+  ): Promise<DescribeIndexResponse> {
+    return this.request("DescribeIndex", req, cb)
+  }
+
   /**
    * 新建投递到COS的任务，【！！！注意】使用此接口，需要检查是否配置了投递COS的角色和权限。如果没有配置，请参考文档投递权限查看和配置https://cloud.tencent.com/document/product/614/71623。
    */
@@ -572,223 +532,243 @@ cls.pb.cc cls.pb.h cls.proto
   }
 
   /**
-   * 本接口用于获取索引配置信息
+   * 本接口用于修改投递任务
    */
-  async DescribeIndex(
-    req: DescribeIndexRequest,
-    cb?: (error: string, rep: DescribeIndexResponse) => void
-  ): Promise<DescribeIndexResponse> {
-    return this.request("DescribeIndex", req, cb)
+  async ModifyConsumer(
+    req: ModifyConsumerRequest,
+    cb?: (error: string, rep: ModifyConsumerResponse) => void
+  ): Promise<ModifyConsumerResponse> {
+    return this.request("ModifyConsumer", req, cb)
   }
 
   /**
-   * 本接口用于获取主题分区列表。
+   * 本接口用于删除投递配置
    */
-  async DescribePartitions(
-    req: DescribePartitionsRequest,
-    cb?: (error: string, rep: DescribePartitionsResponse) => void
-  ): Promise<DescribePartitionsResponse> {
-    return this.request("DescribePartitions", req, cb)
+  async DeleteConsumer(
+    req: DeleteConsumerRequest,
+    cb?: (error: string, rep: DeleteConsumerResponse) => void
+  ): Promise<DeleteConsumerResponse> {
+    return this.request("DeleteConsumer", req, cb)
   }
 
   /**
-   * 本接口用于创建索引
+   * 删除机器组
    */
-  async CreateIndex(
-    req: CreateIndexRequest,
-    cb?: (error: string, rep: CreateIndexResponse) => void
-  ): Promise<CreateIndexResponse> {
-    return this.request("CreateIndex", req, cb)
+  async DeleteMachineGroup(
+    req: DeleteMachineGroupRequest,
+    cb?: (error: string, rep: DeleteMachineGroupResponse) => void
+  ): Promise<DeleteMachineGroupResponse> {
+    return this.request("DeleteMachineGroup", req, cb)
   }
 
   /**
-   * 本接口用于获取定时SQL分析任务列表
+   * 本接口用于获取Kafka数据订阅任务
    */
-  async DescribeScheduledSqlInfo(
-    req: DescribeScheduledSqlInfoRequest,
-    cb?: (error: string, rep: DescribeScheduledSqlInfoResponse) => void
-  ): Promise<DescribeScheduledSqlInfoResponse> {
-    return this.request("DescribeScheduledSqlInfo", req, cb)
+  async DescribeKafkaRecharges(
+    req: DescribeKafkaRechargesRequest,
+    cb?: (error: string, rep: DescribeKafkaRechargesResponse) => void
+  ): Promise<DescribeKafkaRechargesResponse> {
+    return this.request("DescribeKafkaRecharges", req, cb)
   }
 
   /**
-   * 删除采集规则配置
+   * 本接口用于获取告警策略列表。
    */
-  async DeleteConfig(
-    req: DeleteConfigRequest,
-    cb?: (error: string, rep: DeleteConfigResponse) => void
-  ): Promise<DeleteConfigResponse> {
-    return this.request("DeleteConfig", req, cb)
+  async DescribeAlarms(
+    req: DescribeAlarmsRequest,
+    cb?: (error: string, rep: DescribeAlarmsResponse) => void
+  ): Promise<DescribeAlarmsResponse> {
+    return this.request("DescribeAlarms", req, cb)
   }
 
   /**
-   * 本接口用于获取特殊采集配置，特殊采集配置应用于自建K8S环境的采集Agent
+   * 本接口用于获取cos导入配置
    */
-  async DescribeConfigExtras(
-    req: DescribeConfigExtrasRequest,
-    cb?: (error: string, rep: DescribeConfigExtrasResponse) => void
-  ): Promise<DescribeConfigExtrasResponse> {
-    return this.request("DescribeConfigExtras", req, cb)
+  async DescribeCosRecharges(
+    req: DescribeCosRechargesRequest,
+    cb?: (error: string, rep: DescribeCosRechargesResponse) => void
+  ): Promise<DescribeCosRechargesResponse> {
+    return this.request("DescribeCosRecharges", req, cb)
   }
 
   /**
-   * 本接口用于校验Kafka服务集群是否可以正常访问
+   * 应用采集配置到指定机器组
    */
-  async CheckRechargeKafkaServer(
-    req: CheckRechargeKafkaServerRequest,
-    cb?: (error: string, rep: CheckRechargeKafkaServerResponse) => void
-  ): Promise<CheckRechargeKafkaServerResponse> {
-    return this.request("CheckRechargeKafkaServer", req, cb)
+  async ApplyConfigToMachineGroup(
+    req: ApplyConfigToMachineGroupRequest,
+    cb?: (error: string, rep: ApplyConfigToMachineGroupResponse) => void
+  ): Promise<ApplyConfigToMachineGroupResponse> {
+    return this.request("ApplyConfigToMachineGroup", req, cb)
   }
 
   /**
-   * 本接口用于修改投递任务
+   * 本接口用于构建日志数量直方图
    */
-  async ModifyConsumer(
-    req: ModifyConsumerRequest,
-    cb?: (error: string, rep: ModifyConsumerResponse) => void
-  ): Promise<ModifyConsumerResponse> {
-    return this.request("ModifyConsumer", req, cb)
+  async DescribeLogHistogram(
+    req: DescribeLogHistogramRequest,
+    cb?: (error: string, rep: DescribeLogHistogramResponse) => void
+  ): Promise<DescribeLogHistogramResponse> {
+    return this.request("DescribeLogHistogram", req, cb)
   }
 
   /**
-   * 本接口用于创建Kafka数据订阅任务
+   * 该接口用于修改通知渠道组
    */
-  async CreateKafkaRecharge(
-    req: CreateKafkaRechargeRequest,
-    cb?: (error: string, rep: CreateKafkaRechargeResponse) => void
-  ): Promise<CreateKafkaRechargeResponse> {
-    return this.request("CreateKafkaRecharge", req, cb)
+  async ModifyAlarmNotice(
+    req: ModifyAlarmNoticeRequest,
+    cb?: (error: string, rep: ModifyAlarmNoticeResponse) => void
+  ): Promise<ModifyAlarmNoticeResponse> {
+    return this.request("ModifyAlarmNotice", req, cb)
   }
 
   /**
-   * 该接口用于创建通知渠道组。
+   * 打开Kafka协议消费功能
    */
-  async CreateAlarmNotice(
-    req: CreateAlarmNoticeRequest,
-    cb?: (error: string, rep: CreateAlarmNoticeResponse) => void
-  ): Promise<CreateAlarmNoticeResponse> {
-    return this.request("CreateAlarmNotice", req, cb)
+  async OpenKafkaConsumer(
+    req: OpenKafkaConsumerRequest,
+    cb?: (error: string, rep: OpenKafkaConsumerResponse) => void
+  ): Promise<OpenKafkaConsumerResponse> {
+    return this.request("OpenKafkaConsumer", req, cb)
   }
 
   /**
-   * 本接口用于删除投递配置
+   * 获取投递任务列表
    */
-  async DeleteConsumer(
-    req: DeleteConsumerRequest,
-    cb?: (error: string, rep: DeleteConsumerResponse) => void
-  ): Promise<DeleteConsumerResponse> {
-    return this.request("DeleteConsumer", req, cb)
+  async DescribeShipperTasks(
+    req: DescribeShipperTasksRequest,
+    cb?: (error: string, rep: DescribeShipperTasksResponse) => void
+  ): Promise<DescribeShipperTasksResponse> {
+    return this.request("DescribeShipperTasks", req, cb)
   }
 
   /**
-   * 本接口用于修改告警策略。需要至少修改一项有效内容。
+   * 本接口用于删除日志主题的索引配置，删除索引配置后将无法检索和查询采集到的日志。
    */
-  async ModifyAlarm(
-    req: ModifyAlarmRequest,
-    cb?: (error: string, rep: ModifyAlarmResponse) => void
-  ): Promise<ModifyAlarmResponse> {
-    return this.request("ModifyAlarm", req, cb)
+  async DeleteIndex(
+    req: DeleteIndexRequest,
+    cb?: (error: string, rep: DeleteIndexResponse) => void
+  ): Promise<DeleteIndexResponse> {
+    return this.request("DeleteIndex", req, cb)
   }
 
   /**
-   * 删除机器组
+   * 获取Kafka协议消费信息
    */
-  async DeleteMachineGroup(
-    req: DeleteMachineGroupRequest,
-    cb?: (error: string, rep: DeleteMachineGroupResponse) => void
-  ): Promise<DeleteMachineGroupResponse> {
-    return this.request("DeleteMachineGroup", req, cb)
+  async DescribeKafkaConsumer(
+    req: DescribeKafkaConsumerRequest,
+    cb?: (error: string, rep: DescribeKafkaConsumerResponse) => void
+  ): Promise<DescribeKafkaConsumerResponse> {
+    return this.request("DescribeKafkaConsumer", req, cb)
+  }
+
+  /**
+   * 本接口用于预览Kafka数据订阅任务客户日志信息
+   */
+  async PreviewKafkaRecharge(
+    req: PreviewKafkaRechargeRequest,
+    cb?: (error: string, rep: PreviewKafkaRechargeResponse) => void
+  ): Promise<PreviewKafkaRechargeResponse> {
+    return this.request("PreviewKafkaRecharge", req, cb)
+  }
+
+  /**
+   * 本接口用于修改特殊采集配置任务，特殊采集配置应用于自建K8S环境的采集Agent
+   */
+  async ModifyConfigExtra(
+    req: ModifyConfigExtraRequest,
+    cb?: (error: string, rep: ModifyConfigExtraResponse) => void
+  ): Promise<ModifyConfigExtraResponse> {
+    return this.request("ModifyConfigExtra", req, cb)
   }
 
   /**
-   * 重试失败的投递任务
+   * 本接口用于创建特殊采集配置任务，特殊采集配置应用于自建K8S环境的采集Agent
    */
-  async RetryShipperTask(
-    req: RetryShipperTaskRequest,
-    cb?: (error: string, rep: RetryShipperTaskResponse) => void
-  ): Promise<RetryShipperTaskResponse> {
-    return this.request("RetryShipperTask", req, cb)
+  async CreateConfigExtra(
+    req: CreateConfigExtraRequest,
+    cb?: (error: string, rep: CreateConfigExtraResponse) => void
+  ): Promise<CreateConfigExtraResponse> {
+    return this.request("CreateConfigExtra", req, cb)
   }
 
   /**
-   * 本接口用于获取日志主题列表，支持分页
+   * 本接口用于修改定时SQL分析任务
    */
-  async DescribeTopics(
-    req: DescribeTopicsRequest,
-    cb?: (error: string, rep: DescribeTopicsResponse) => void
-  ): Promise<DescribeTopicsResponse> {
-    return this.request("DescribeTopics", req, cb)
+  async ModifyScheduledSql(
+    req: ModifyScheduledSqlRequest,
+    cb?: (error: string, rep: ModifyScheduledSqlResponse) => void
+  ): Promise<ModifyScheduledSqlResponse> {
+    return this.request("ModifyScheduledSql", req, cb)
   }
 
   /**
-   * 本接口用于删除日志集。
+   * 创建机器组
    */
-  async DeleteLogset(
-    req: DeleteLogsetRequest,
-    cb?: (error: string, rep: DeleteLogsetResponse) => void
-  ): Promise<DeleteLogsetResponse> {
-    return this.request("DeleteLogset", req, cb)
+  async CreateMachineGroup(
+    req: CreateMachineGroupRequest,
+    cb?: (error: string, rep: CreateMachineGroupResponse) => void
+  ): Promise<CreateMachineGroupResponse> {
+    return this.request("CreateMachineGroup", req, cb)
   }
 
   /**
-   * 获取投递到COS的任务配置信息
+   * 用于删除机器组信息
    */
-  async DescribeShippers(
-    req: DescribeShippersRequest,
-    cb?: (error: string, rep: DescribeShippersResponse) => void
-  ): Promise<DescribeShippersResponse> {
-    return this.request("DescribeShippers", req, cb)
+  async DeleteMachineGroupInfo(
+    req: DeleteMachineGroupInfoRequest,
+    cb?: (error: string, rep: DeleteMachineGroupInfoResponse) => void
+  ): Promise<DeleteMachineGroupInfoResponse> {
+    return this.request("DeleteMachineGroupInfo", req, cb)
   }
 
   /**
-   * 修改机器组
+   * 本接口用于获取告警任务历史
    */
-  async ModifyMachineGroup(
-    req: ModifyMachineGroupRequest,
-    cb?: (error: string, rep: ModifyMachineGroupResponse) => void
-  ): Promise<ModifyMachineGroupResponse> {
-    return this.request("ModifyMachineGroup", req, cb)
+  async GetAlarmLog(
+    req: GetAlarmLogRequest,
+    cb?: (error: string, rep: GetAlarmLogResponse) => void
+  ): Promise<GetAlarmLogResponse> {
+    return this.request("GetAlarmLog", req, cb)
   }
 
   /**
-   * 删除应用到机器组的采集配置
+   * 本接口用于获取日志集信息列表。
    */
-  async DeleteConfigFromMachineGroup(
-    req: DeleteConfigFromMachineGroupRequest,
-    cb?: (error: string, rep: DeleteConfigFromMachineGroupResponse) => void
-  ): Promise<DeleteConfigFromMachineGroupResponse> {
-    return this.request("DeleteConfigFromMachineGroup", req, cb)
+  async DescribeLogsets(
+    req: DescribeLogsetsRequest,
+    cb?: (error: string, rep: DescribeLogsetsResponse) => void
+  ): Promise<DescribeLogsetsResponse> {
+    return this.request("DescribeLogsets", req, cb)
   }
 
   /**
-   * 本接口用于删除数据加工任务
+   * 本接口用于预览cos导入信息
    */
-  async DeleteDataTransform(
-    req: DeleteDataTransformRequest,
-    cb?: (error: string, rep: DeleteDataTransformResponse) => void
-  ): Promise<DeleteDataTransformResponse> {
-    return this.request("DeleteDataTransform", req, cb)
+  async SearchCosRechargeInfo(
+    req: SearchCosRechargeInfoRequest,
+    cb?: (error: string, rep: SearchCosRechargeInfoResponse) => void
+  ): Promise<SearchCosRechargeInfoResponse> {
+    return this.request("SearchCosRechargeInfo", req, cb)
   }
 
   /**
-   * 本接口用于创建日志集，返回新创建的日志集的 ID。
+   * 本接口用于修改Kafka数据订阅任务
    */
-  async CreateLogset(
-    req: CreateLogsetRequest,
-    cb?: (error: string, rep: CreateLogsetResponse) => void
-  ): Promise<CreateLogsetResponse> {
-    return this.request("CreateLogset", req, cb)
+  async ModifyKafkaRecharge(
+    req: ModifyKafkaRechargeRequest,
+    cb?: (error: string, rep: ModifyKafkaRechargeResponse) => void
+  ): Promise<ModifyKafkaRechargeResponse> {
+    return this.request("ModifyKafkaRecharge", req, cb)
   }
 
   /**
-   * 本接口用于获取Kafka数据订阅任务
+   * 该接口用于创建通知渠道组。
    */
-  async DescribeKafkaRecharges(
-    req: DescribeKafkaRechargesRequest,
-    cb?: (error: string, rep: DescribeKafkaRechargesResponse) => void
-  ): Promise<DescribeKafkaRechargesResponse> {
-    return this.request("DescribeKafkaRecharges", req, cb)
+  async CreateAlarmNotice(
+    req: CreateAlarmNoticeRequest,
+    cb?: (error: string, rep: CreateAlarmNoticeResponse) => void
+  ): Promise<CreateAlarmNoticeResponse> {
+    return this.request("CreateAlarmNotice", req, cb)
   }
 
   /**
@@ -832,23 +812,13 @@ cls.pb.cc cls.pb.h cls.proto
   }
 
   /**
-   * 本接口用于创建日志主题。
-   */
-  async CreateTopic(
-    req: CreateTopicRequest,
-    cb?: (error: string, rep: CreateTopicResponse) => void
-  ): Promise<CreateTopicResponse> {
-    return this.request("CreateTopic", req, cb)
-  }
-
-  /**
-   * 应用采集配置到指定机器组
+   * 本接口用于获取主题分区列表。
    */
-  async ApplyConfigToMachineGroup(
-    req: ApplyConfigToMachineGroupRequest,
-    cb?: (error: string, rep: ApplyConfigToMachineGroupResponse) => void
-  ): Promise<ApplyConfigToMachineGroupResponse> {
-    return this.request("ApplyConfigToMachineGroup", req, cb)
+  async DescribePartitions(
+    req: DescribePartitionsRequest,
+    cb?: (error: string, rep: DescribePartitionsResponse) => void
+  ): Promise<DescribePartitionsResponse> {
+    return this.request("DescribePartitions", req, cb)
   }
 
   /**
@@ -862,13 +832,53 @@ cls.pb.cc cls.pb.h cls.proto
   }
 
   /**
-   * 本接口用于修改cos导入任务
+   * 本接口用于删除告警策略。
    */
-  async ModifyCosRecharge(
-    req: ModifyCosRechargeRequest,
-    cb?: (error: string, rep: ModifyCosRechargeResponse) => void
-  ): Promise<ModifyCosRechargeResponse> {
-    return this.request("ModifyCosRecharge", req, cb)
+  async DeleteAlarm(
+    req: DeleteAlarmRequest,
+    cb?: (error: string, rep: DeleteAlarmResponse) => void
+  ): Promise<DeleteAlarmResponse> {
+    return this.request("DeleteAlarm", req, cb)
+  }
+
+  /**
+   * 删除投递COS任务
+   */
+  async DeleteShipper(
+    req: DeleteShipperRequest,
+    cb?: (error: string, rep: DeleteShipperResponse) => void
+  ): Promise<DeleteShipperResponse> {
+    return this.request("DeleteShipper", req, cb)
+  }
+
+  /**
+   * 查询指定时间范围内指标的变化趋势
+   */
+  async QueryRangeMetric(
+    req: QueryRangeMetricRequest,
+    cb?: (error: string, rep: QueryRangeMetricResponse) => void
+  ): Promise<QueryRangeMetricResponse> {
+    return this.request("QueryRangeMetric", req, cb)
+  }
+
+  /**
+   * 获取采集规则配置所绑定的机器组
+   */
+  async DescribeConfigMachineGroups(
+    req: DescribeConfigMachineGroupsRequest,
+    cb?: (error: string, rep: DescribeConfigMachineGroupsResponse) => void
+  ): Promise<DescribeConfigMachineGroupsResponse> {
+    return this.request("DescribeConfigMachineGroups", req, cb)
+  }
+
+  /**
+   * 本接口用于删除日志下载任务
+   */
+  async DeleteExport(
+    req: DeleteExportRequest,
+    cb?: (error: string, rep: DeleteExportResponse) => void
+  ): Promise<DeleteExportResponse> {
+    return this.request("DeleteExport", req, cb)
   }
 
   /**
@@ -882,75 +892,133 @@ cls.pb.cc cls.pb.h cls.proto
   }
 
   /**
-   * 该接口用于删除通知渠道组
+   * 获取机器组信息列表
    */
-  async DeleteAlarmNotice(
-    req: DeleteAlarmNoticeRequest,
-    cb?: (error: string, rep: DeleteAlarmNoticeResponse) => void
-  ): Promise<DeleteAlarmNoticeResponse> {
-    return this.request("DeleteAlarmNotice", req, cb)
+  async DescribeMachineGroups(
+    req: DescribeMachineGroupsRequest,
+    cb?: (error: string, rep: DescribeMachineGroupsResponse) => void
+  ): Promise<DescribeMachineGroupsResponse> {
+    return this.request("DescribeMachineGroups", req, cb)
   }
 
   /**
-   * 本接口用于获取仪表盘
+   * 本接口用于创建投递任务
    */
-  async DescribeDashboards(
-    req: DescribeDashboardsRequest,
-    cb?: (error: string, rep: DescribeDashboardsResponse) => void
-  ): Promise<DescribeDashboardsResponse> {
-    return this.request("DescribeDashboards", req, cb)
+  async CreateConsumer(
+    req: CreateConsumerRequest,
+    cb?: (error: string, rep: CreateConsumerResponse) => void
+  ): Promise<CreateConsumerResponse> {
+    return this.request("CreateConsumer", req, cb)
+  }
+
+  /**
+   * 本接口用于获取kafka用户信息
+   */
+  async DescribeKafkaUser(
+    req: DescribeKafkaUserRequest,
+    cb?: (error: string, rep: DescribeKafkaUserResponse) => void
+  ): Promise<DescribeKafkaUserResponse> {
+    return this.request("DescribeKafkaUser", req, cb)
+  }
+
+  /**
+   * 本接口用于修改日志主题。
+   */
+  async ModifyTopic(
+    req: ModifyTopicRequest,
+    cb?: (error: string, rep: ModifyTopicResponse) => void
+  ): Promise<ModifyTopicResponse> {
+    return this.request("ModifyTopic", req, cb)
+  }
+
+  /**
+   * 修改机器组
+   */
+  async ModifyMachineGroup(
+    req: ModifyMachineGroupRequest,
+    cb?: (error: string, rep: ModifyMachineGroupResponse) => void
+  ): Promise<ModifyMachineGroupResponse> {
+    return this.request("ModifyMachineGroup", req, cb)
+  }
+
+  /**
+   * 本接口用于获取定时SQL分析任务列表
+   */
+  async DescribeScheduledSqlInfo(
+    req: DescribeScheduledSqlInfoRequest,
+    cb?: (error: string, rep: DescribeScheduledSqlInfoResponse) => void
+  ): Promise<DescribeScheduledSqlInfoResponse> {
+    return this.request("DescribeScheduledSqlInfo", req, cb)
+  }
+
+  /**
+   * 删除采集规则配置
+   */
+  async DeleteConfig(
+    req: DeleteConfigRequest,
+    cb?: (error: string, rep: DeleteConfigResponse) => void
+  ): Promise<DeleteConfigResponse> {
+    return this.request("DeleteConfig", req, cb)
   }
 
   /**
-   * 本接口用于构建日志数量直方图
+   * 本接口用于获取特殊采集配置，特殊采集配置应用于自建K8S环境的采集Agent
    */
-  async DescribeLogHistogram(
-    req: DescribeLogHistogramRequest,
-    cb?: (error: string, rep: DescribeLogHistogramResponse) => void
-  ): Promise<DescribeLogHistogramResponse> {
-    return this.request("DescribeLogHistogram", req, cb)
+  async DescribeConfigExtras(
+    req: DescribeConfigExtrasRequest,
+    cb?: (error: string, rep: DescribeConfigExtrasResponse) => void
+  ): Promise<DescribeConfigExtrasResponse> {
+    return this.request("DescribeConfigExtras", req, cb)
   }
 
   /**
-     * 本接口用于检索分析日志, 该接口除受默认接口请求频率限制外，针对单个日志主题，查询并发数不能超过15。
+   * 本接口用于校验Kafka服务集群是否可以正常访问
+   */
+  async CheckRechargeKafkaServer(
+    req: CheckRechargeKafkaServerRequest,
+    cb?: (error: string, rep: CheckRechargeKafkaServerResponse) => void
+  ): Promise<CheckRechargeKafkaServerResponse> {
+    return this.request("CheckRechargeKafkaServer", req, cb)
+  }
 
-API返回数据包最大49MB，建议启用 gzip 压缩（HTTP Request Header Accept-Encoding:gzip）。
-     */
-  async SearchLog(
-    req: SearchLogRequest,
-    cb?: (error: string, rep: SearchLogResponse) => void
-  ): Promise<SearchLogResponse> {
-    return this.request("SearchLog", req, cb)
+  /**
+   * 本接口用于修改告警策略。需要至少修改一项有效内容。
+   */
+  async ModifyAlarm(
+    req: ModifyAlarmRequest,
+    cb?: (error: string, rep: ModifyAlarmResponse) => void
+  ): Promise<ModifyAlarmResponse> {
+    return this.request("ModifyAlarm", req, cb)
   }
 
   /**
-   * 本接口用于删除定时SQL分析任务
+   * 获取投递到COS的任务配置信息
    */
-  async DeleteScheduledSql(
-    req: DeleteScheduledSqlRequest,
-    cb?: (error: string, rep: DeleteScheduledSqlResponse) => void
-  ): Promise<DeleteScheduledSqlResponse> {
-    return this.request("DeleteScheduledSql", req, cb)
+  async DescribeShippers(
+    req: DescribeShippersRequest,
+    cb?: (error: string, rep: DescribeShippersResponse) => void
+  ): Promise<DescribeShippersResponse> {
+    return this.request("DescribeShippers", req, cb)
   }
 
   /**
-   * 获取制定机器组下的机器状态
+   * 本接口用于获取仪表盘
    */
-  async DescribeMachines(
-    req: DescribeMachinesRequest,
-    cb?: (error: string, rep: DescribeMachinesResponse) => void
-  ): Promise<DescribeMachinesResponse> {
-    return this.request("DescribeMachines", req, cb)
+  async DescribeDashboards(
+    req: DescribeDashboardsRequest,
+    cb?: (error: string, rep: DescribeDashboardsResponse) => void
+  ): Promise<DescribeDashboardsResponse> {
+    return this.request("DescribeDashboards", req, cb)
   }
 
   /**
-   * 打开Kafka协议消费功能
+   * 本接口用于修改cos导入任务
    */
-  async OpenKafkaConsumer(
-    req: OpenKafkaConsumerRequest,
-    cb?: (error: string, rep: OpenKafkaConsumerResponse) => void
-  ): Promise<OpenKafkaConsumerResponse> {
-    return this.request("OpenKafkaConsumer", req, cb)
+  async ModifyCosRecharge(
+    req: ModifyCosRechargeRequest,
+    cb?: (error: string, rep: ModifyCosRechargeResponse) => void
+  ): Promise<ModifyCosRechargeResponse> {
+    return this.request("ModifyCosRecharge", req, cb)
   }
 
   /**
@@ -964,53 +1032,187 @@ API返回数据包最大49MB，建议启用 gzip 压缩（HTTP Request Header Ac
   }
 
   /**
-   * 获取告警历史，例如今天未恢复的告警
-   */
-  async DescribeAlertRecordHistory(
-    req: DescribeAlertRecordHistoryRequest,
-    cb?: (error: string, rep: DescribeAlertRecordHistoryResponse) => void
-  ): Promise<DescribeAlertRecordHistoryResponse> {
-    return this.request("DescribeAlertRecordHistory", req, cb)
-  }
+     * ## 提示
+为了保障您日志数据的可靠性以及更高效地使用日志服务，建议您使用CLS优化后的接口[上传结构化日志](https://cloud.tencent.com/document/product/614/16873)。
 
-  /**
-   * 本接口用于删除日志主题。
-   */
-  async DeleteTopic(
-    req: DeleteTopicRequest,
-    cb?: (error: string, rep: DeleteTopicResponse) => void
-  ): Promise<DeleteTopicResponse> {
-    return this.request("DeleteTopic", req, cb)
-  }
+同时我们给此接口专门优化定制了多个语言版本的SDK供您选择，SDK提供统一的异步发送、资源控制、自动重试、优雅关闭、感知上报等功能，使上报日志功能更完善，详情请参考[SDK采集](https://cloud.tencent.com/document/product/614/67157)。
 
-  /**
-   * 获取投递任务列表
-   */
-  async DescribeShipperTasks(
-    req: DescribeShipperTasksRequest,
-    cb?: (error: string, rep: DescribeShipperTasksResponse) => void
-  ): Promise<DescribeShipperTasksResponse> {
-    return this.request("DescribeShipperTasks", req, cb)
+同时云API上传日志接口也支持同步上传日志数据，如果您选择继续使用此接口请参考下文。
+
+## 功能描述
+
+本接口用于将日志写入到指定的日志主题。
+
+日志服务提供以下两种模式：
+
+#### 负载均衡模式
+
+系统根据当前日志主题下所有可读写的分区，遵循负载均衡原则自动分配写入的目标分区。该模式适合消费不保序的场景。
+
+#### 哈希路由模式
+
+系统根据携带的哈希值（X-CLS-HashKey）将数据写入到符合范围要求的目标分区。例如，可以将某个日志源端通过 hashkey 与某个主题分区强绑定，这样可以保证数据在该分区上写入和消费是严格保序的。
+
+                 
+
+#### 输入参数(pb二进制流，位于body中)
+
+| 字段名       | 类型    | 位置 | 必须 | 含义                                                         |
+| ------------ | ------- | ---- | ---- | ------------------------------------------------------------ |
+| logGroupList | message | pb   | 是   | logGroup 列表，封装好的日志组列表内容，建议 logGroup 数量不要超过5个 |
+
+LogGroup 说明：
+
+| 字段名      | 是否必选 | 含义                                                         |
+| ----------- | -------- | ------------------------------------------------------------ |
+| logs        | 是       | 日志数组，表示有多个 Log 组成的集合，一个 Log 表示一条日志，一个 LogGroup 中 Log 个数不能超过10000 |
+| contextFlow | 否       | LogGroup 的唯一ID，需要使用上下文功能时传入。格式："{上下文ID}-{LogGroupID}"。<br>上下文ID：唯一标识一个上下文（连续滚动的一系列日志文件，或者是需要保序的一系列日志），16进制64位整型字符串。<br>LogGroupID：连续递增的一串整型，16进制64位整型字符串。样例："102700A66102516A-59F59"。                        |
+| filename    | 否       | 日志文件名                                                   |
+| source      | 否       | 日志来源，一般使用机器 IP 作为标识                           |
+| logTags     | 否       | 日志的标签列表                                               |
+
+Log 说明：
+
+| 字段名   | 是否必选 | 含义                                                         |
+| -------- | -------- | ------------------------------------------------------------ |
+| time     | 是       | 日志时间（Unix 格式时间戳），支持秒、毫秒，建议采用毫秒      |
+| contents | 否       | key-value 格式的日志内容，表示一条日志里的多个 key-value 组合 |
+
+Content 说明：
+
+| 字段名 | 是否必选 | 含义                                                         |
+| ------ | -------- | ------------------------------------------------------------ |
+| key    | 是       | 单条日志里某个字段组的 key 值，不能以`_`开头                 |
+| value  | 是       | 单条日志某个字段组的 value 值，单条日志 value 不能超过1MB，LogGroup 中所有 value 总和不能超过5MB |
+
+LogTag 说明：
+
+| 字段名 | 是否必选 | 含义                             |
+| ------ | -------- | -------------------------------- |
+| key    | 是       | 自定义的标签 key                 |
+| value  | 是       | 自定义的标签 key 对应的 value 值 |
+
+## PB 编译示例
+
+本示例将说明如何使用官方 protoc 编译工具将 PB 描述文件 编译生成为 C++ 语言可调用的上传日志接口。
+
+> ?目前 protoc 官方支持 Java、C++、Python 等语言的编译，详情请参见 [protoc](https://github.com/protocolbuffers/protobuf)。
+
+#### 1. 安装 Protocol Buffer
+
+下载 [Protocol Buffer](https://main.qcloudimg.com/raw/d7810aaf8b3073fbbc9d4049c21532aa/protobuf-2.6.1.tar.gz) ，解压并安装。示例版本为 protobuf 2.6.1，环境为 Centos 7.3 系统。 解压`protobuf-2.6.1.tar.gz`压缩包至`/usr/local`目录并进入该目录，执行命令如下：
+
+```
+tar -zxvf protobuf-2.6.1.tar.gz -C /usr/local/ && cd /usr/local/protobuf-2.6.1
+```
+
+开始编译和安装，配置环境变量，执行命令如下：
+
+```
+[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
+```
+
+编译成功后，您可以使用以下命令查看版本：
+
+```
+[root@VM_0_8_centos protobuf-2.6.1]# protoc --version
+liprotoc 2.6.1
+```
+
+#### 2. 创建 PB 描述文件
+
+PB 描述文件是通信双方约定的数据交换格式，上传日志时须将规定的协议格式编译成对应语言版本的调用接口，然后添加到工程代码里，详情请参见 [protoc](https://github.com/protocolbuffers/protobuf) 。
+
+以日志服务所规定的 PB 数据格式内容为准， 在本地创建 PB 消息描述文件 cls.proto。
+
+> !PB 描述文件内容不可更改，且文件名须以`.proto`结尾。
+
+cls.proto 内容（PB 描述文件）如下：
+
+```
+package cls;
+
+message Log
+{
+    message Content
+    {
+        required string key   = 1; // 每组字段的 key
+        required string value = 2; // 每组字段的 value
+    }
+    required int64   time     = 1; // 时间戳，UNIX时间格式
+    repeated Content contents = 2; // 一条日志里的多个kv组合
+}
+
+message LogTag
+{
+    required string key       = 1;
+    required string value     = 2;
+}
+
+message LogGroup
+{
+    repeated Log    logs        = 1; // 多条日志合成的日志数组
+    optional string contextFlow = 2; // 目前暂无效用
+    optional string filename    = 3; // 日志文件名
+    optional string source      = 4; // 日志来源，一般使用机器IP
+    repeated LogTag logTags     = 5;
+}
+
+message LogGroupList
+{
+    repeated LogGroup logGroupList = 1; // 日志组列表
+}
+```
+
+#### 3. 编译生成
+
+此例中，使用 proto 编译器生成 C++ 语言的文件，在 cls.proto 文件的同一目录下，执行如下编译命令：
+
+```
+protoc --cpp_out=./ ./cls.proto 
+```
+
+> ?`--cpp_out=./`表示编译成 cpp 格式并输出当前目录下，`./cls.proto`表示位于当前目录下的 cls.proto 描述文件。
+
+编译成功后，会输出对应语言的代码文件。此例会生成 cls.pb.h 头文件和 [cls.pb.cc](http://cls.pb.cc) 代码实现文件，如下所示：
+
+```
+[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. 调用
+
+将生成的 cls.pb.h 头文件引入代码中，调用接口进行数据格式封装。
+     */
+  async UploadLog(
+    req: UploadLogRequest,
+    cb?: (error: string, rep: UploadLogResponse) => void
+  ): Promise<UploadLogResponse> {
+    return this.request("UploadLog", req, cb)
   }
 
   /**
-   * 本接口用于删除Kafka数据订阅任务
+   * 本接口用于创建定时SQL分析任务
    */
-  async DeleteKafkaRecharge(
-    req: DeleteKafkaRechargeRequest,
-    cb?: (error: string, rep: DeleteKafkaRechargeResponse) => void
-  ): Promise<DeleteKafkaRechargeResponse> {
-    return this.request("DeleteKafkaRecharge", req, cb)
+  async CreateScheduledSql(
+    req: CreateScheduledSqlRequest,
+    cb?: (error: string, rep: CreateScheduledSqlResponse) => void
+  ): Promise<CreateScheduledSqlResponse> {
+    return this.request("CreateScheduledSql", req, cb)
   }
 
   /**
-   * 创建采集规则配置
+   * 本接口用于修改日志集信息
    */
-  async CreateConfig(
-    req: CreateConfigRequest,
-    cb?: (error: string, rep: CreateConfigResponse) => void
-  ): Promise<CreateConfigResponse> {
-    return this.request("CreateConfig", req, cb)
+  async ModifyLogset(
+    req: ModifyLogsetRequest,
+    cb?: (error: string, rep: ModifyLogsetResponse) => void
+  ): Promise<ModifyLogsetResponse> {
+    return this.request("ModifyLogset", req, cb)
   }
 
   /**
@@ -1023,36 +1225,6 @@ API返回数据包最大49MB，建议启用 gzip 压缩（HTTP Request Header Ac
     return this.request("DescribeMachineGroupConfigs", req, cb)
   }
 
-  /**
-   * 修改Kafka协议消费信息
-   */
-  async ModifyKafkaConsumer(
-    req: ModifyKafkaConsumerRequest,
-    cb?: (error: string, rep: ModifyKafkaConsumerResponse) => void
-  ): Promise<ModifyKafkaConsumerResponse> {
-    return this.request("ModifyKafkaConsumer", req, cb)
-  }
-
-  /**
-   * 删除投递COS任务
-   */
-  async DeleteShipper(
-    req: DeleteShipperRequest,
-    cb?: (error: string, rep: DeleteShipperResponse) => void
-  ): Promise<DeleteShipperResponse> {
-    return this.request("DeleteShipper", req, cb)
-  }
-
-  /**
-   * 本接口用于删除日志主题的索引配置，删除索引配置后将无法检索和查询采集到的日志。
-   */
-  async DeleteIndex(
-    req: DeleteIndexRequest,
-    cb?: (error: string, rep: DeleteIndexResponse) => void
-  ): Promise<DeleteIndexResponse> {
-    return this.request("DeleteIndex", req, cb)
-  }
-
   /**
    * 本接口用于修改数据加工任务
    */
@@ -1064,33 +1236,15 @@ API返回数据包最大49MB，建议启用 gzip 压缩（HTTP Request Header Ac
   }
 
   /**
-   * 修改现有的投递规则，客户如果使用此接口，需要自行处理CLS对指定bucket的写权限。
-   */
-  async ModifyShipper(
-    req: ModifyShipperRequest,
-    cb?: (error: string, rep: ModifyShipperResponse) => void
-  ): Promise<ModifyShipperResponse> {
-    return this.request("ModifyShipper", req, cb)
-  }
-
-  /**
-   * 本接口用于删除告警策略。
-   */
-  async DeleteAlarm(
-    req: DeleteAlarmRequest,
-    cb?: (error: string, rep: DeleteAlarmResponse) => void
-  ): Promise<DeleteAlarmResponse> {
-    return this.request("DeleteAlarm", req, cb)
-  }
+     * 本接口用于检索分析日志, 该接口除受默认接口请求频率限制外，针对单个日志主题，查询并发数不能超过15。
 
-  /**
-   * 获取Kafka协议消费信息
-   */
-  async DescribeKafkaConsumer(
-    req: DescribeKafkaConsumerRequest,
-    cb?: (error: string, rep: DescribeKafkaConsumerResponse) => void
-  ): Promise<DescribeKafkaConsumerResponse> {
-    return this.request("DescribeKafkaConsumer", req, cb)
+API返回数据包最大49MB，建议启用 gzip 压缩（HTTP Request Header Accept-Encoding:gzip）。
+     */
+  async SearchLog(
+    req: SearchLogRequest,
+    cb?: (error: string, rep: SearchLogResponse) => void
+  ): Promise<SearchLogResponse> {
+    return this.request("SearchLog", req, cb)
   }
 
   /**
@@ -1114,113 +1268,23 @@ API返回数据包最大49MB，建议启用 gzip 压缩（HTTP Request Header Ac
   }
 
   /**
-   * 该接口用于修改通知渠道组
-   */
-  async ModifyAlarmNotice(
-    req: ModifyAlarmNoticeRequest,
-    cb?: (error: string, rep: ModifyAlarmNoticeResponse) => void
-  ): Promise<ModifyAlarmNoticeResponse> {
-    return this.request("ModifyAlarmNotice", req, cb)
-  }
-
-  /**
-   * 获取采集规则配置
-   */
-  async DescribeConfigs(
-    req: DescribeConfigsRequest,
-    cb?: (error: string, rep: DescribeConfigsResponse) => void
-  ): Promise<DescribeConfigsResponse> {
-    return this.request("DescribeConfigs", req, cb)
-  }
-
-  /**
-   * 本接口用于创建cos导入任务
-   */
-  async CreateCosRecharge(
-    req: CreateCosRechargeRequest,
-    cb?: (error: string, rep: CreateCosRechargeResponse) => void
-  ): Promise<CreateCosRechargeResponse> {
-    return this.request("CreateCosRecharge", req, cb)
-  }
-
-  /**
-   * 获取机器组信息列表
-   */
-  async DescribeMachineGroups(
-    req: DescribeMachineGroupsRequest,
-    cb?: (error: string, rep: DescribeMachineGroupsResponse) => void
-  ): Promise<DescribeMachineGroupsResponse> {
-    return this.request("DescribeMachineGroups", req, cb)
-  }
-
-  /**
-   * 本接口用于合并一个读写态的主题分区，合并时指定一个主题分区 ID，日志服务会自动合并范围右相邻的分区。
-   */
-  async MergePartition(
-    req: MergePartitionRequest,
-    cb?: (error: string, rep: MergePartitionResponse) => void
-  ): Promise<MergePartitionResponse> {
-    return this.request("MergePartition", req, cb)
-  }
-
-  /**
-   * 本接口用于创建特殊采集配置任务，特殊采集配置应用于自建K8S环境的采集Agent
-   */
-  async CreateConfigExtra(
-    req: CreateConfigExtraRequest,
-    cb?: (error: string, rep: CreateConfigExtraResponse) => void
-  ): Promise<CreateConfigExtraResponse> {
-    return this.request("CreateConfigExtra", req, cb)
-  }
-
-  /**
-   * 本接口用于预览Kafka数据订阅任务客户日志信息
-   */
-  async PreviewKafkaRecharge(
-    req: PreviewKafkaRechargeRequest,
-    cb?: (error: string, rep: PreviewKafkaRechargeResponse) => void
-  ): Promise<PreviewKafkaRechargeResponse> {
-    return this.request("PreviewKafkaRecharge", req, cb)
-  }
-
-  /**
-   * 获取采集规则配置所绑定的机器组
-   */
-  async DescribeConfigMachineGroups(
-    req: DescribeConfigMachineGroupsRequest,
-    cb?: (error: string, rep: DescribeConfigMachineGroupsResponse) => void
-  ): Promise<DescribeConfigMachineGroupsResponse> {
-    return this.request("DescribeConfigMachineGroups", req, cb)
-  }
-
-  /**
-   * 本接口用于修改特殊采集配置任务，特殊采集配置应用于自建K8S环境的采集Agent
-   */
-  async ModifyConfigExtra(
-    req: ModifyConfigExtraRequest,
-    cb?: (error: string, rep: ModifyConfigExtraResponse) => void
-  ): Promise<ModifyConfigExtraResponse> {
-    return this.request("ModifyConfigExtra", req, cb)
-  }
-
-  /**
-   * 本接口用于修改日志集信息
+   * 获取制定机器组下的机器状态
    */
-  async ModifyLogset(
-    req: ModifyLogsetRequest,
-    cb?: (error: string, rep: ModifyLogsetResponse) => void
-  ): Promise<ModifyLogsetResponse> {
-    return this.request("ModifyLogset", req, cb)
+  async DescribeMachines(
+    req: DescribeMachinesRequest,
+    cb?: (error: string, rep: DescribeMachinesResponse) => void
+  ): Promise<DescribeMachinesResponse> {
+    return this.request("DescribeMachines", req, cb)
   }
 
   /**
-   * 本接口用于删除日志下载任务
+   * 重试失败的投递任务
    */
-  async DeleteExport(
-    req: DeleteExportRequest,
-    cb?: (error: string, rep: DeleteExportResponse) => void
-  ): Promise<DeleteExportResponse> {
-    return this.request("DeleteExport", req, cb)
+  async RetryShipperTask(
+    req: RetryShipperTaskRequest,
+    cb?: (error: string, rep: RetryShipperTaskResponse) => void
+  ): Promise<RetryShipperTaskResponse> {
+    return this.request("RetryShipperTask", req, cb)
   }
 
   /**
@@ -1234,52 +1298,12 @@ API返回数据包最大49MB，建议启用 gzip 压缩（HTTP Request Header Ac
   }
 
   /**
-   * 本接口用于创建定时SQL分析任务
-   */
-  async CreateScheduledSql(
-    req: CreateScheduledSqlRequest,
-    cb?: (error: string, rep: CreateScheduledSqlResponse) => void
-  ): Promise<CreateScheduledSqlResponse> {
-    return this.request("CreateScheduledSql", req, cb)
-  }
-
-  /**
-   * 本接口仅创建下载任务，任务返回的下载地址，请用户调用DescribeExports查看任务列表。其中有下载地址CosPath参数。参考文档https://cloud.tencent.com/document/product/614/56449
-   */
-  async CreateExport(
-    req: CreateExportRequest,
-    cb?: (error: string, rep: CreateExportResponse) => void
-  ): Promise<CreateExportResponse> {
-    return this.request("CreateExport", req, cb)
-  }
-
-  /**
-   * 本接口用于修改定时SQL分析任务
-   */
-  async ModifyScheduledSql(
-    req: ModifyScheduledSqlRequest,
-    cb?: (error: string, rep: ModifyScheduledSqlResponse) => void
-  ): Promise<ModifyScheduledSqlResponse> {
-    return this.request("ModifyScheduledSql", req, cb)
-  }
-
-  /**
-   * 关闭Kafka协议消费
-   */
-  async CloseKafkaConsumer(
-    req: CloseKafkaConsumerRequest,
-    cb?: (error: string, rep: CloseKafkaConsumerResponse) => void
-  ): Promise<CloseKafkaConsumerResponse> {
-    return this.request("CloseKafkaConsumer", req, cb)
-  }
-
-  /**
-   * 本接口用于获取告警策略列表。
+   * 本接口用于删除日志主题。
    */
-  async DescribeAlarms(
-    req: DescribeAlarmsRequest,
-    cb?: (error: string, rep: DescribeAlarmsResponse) => void
-  ): Promise<DescribeAlarmsResponse> {
-    return this.request("DescribeAlarms", req, cb)
+  async DeleteTopic(
+    req: DeleteTopicRequest,
+    cb?: (error: string, rep: DeleteTopicResponse) => void
+  ): Promise<DeleteTopicResponse> {
+    return this.request("DeleteTopic", req, cb)
   }
 }