更新日志投递UpdateLogShipper
更新时间：2026-06-23
- 修改投递任务的相关配置，不支持修改logStoreName、startTime和destType。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1PUT /v{version}/logshipper/{logShipperID} HTTP/1.1
2Host: xxx.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "project":<project>,
7 "logShipperName":<logShipperName>,
8 "logShipperID":<logShipperID>,
9 "destConfig":<destConfig>
10}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| project | string | 否 | RequestBody参数 | 日志组名称，默认default |
| logShipperName | string | 是 | RequestBody参数 | 投递任务名称 |
| logShipperID | string | 是 | URL参数 | 投递任务ID |
| destConfig | DestConfig | 是 | RequestBody参数 | 目标配置详情 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 请求码，成功为OK，错误为具体的错误码 |
请求示例
Plain Text
1更新BOS类型任务
2
3PUT /v1/logshipper/2323-xxxxx HTTP/1.1
4HOST bls-log.bj.baidubce.com
5Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
6
7{
8 "logShipperName":"shipper1",
9 "destConfig":{
10 "BOSPath":"users-Bucket1/",
11 "partitionFormatTS":"%Y/%m/%d/%H/%M/",
12 "partitionFormatLogStream":true,
13 "maxObjectSize":50,
14 "compressType":"snappy",
15 "deliverInterval":30,
16 "storageFormat":"json",
17 "kafkaConfig": {
18 "brokers": ["localhost:9092"],
19 "topic": "test_logshipper",
20 "maxRetries": 2
21 }
22 }
23}
24
25更新KAFKA类型任务
26
27PUT /v1/logshipper/2323-xxxxx HTTP/1.1
28HOST bls-log.bj.baidubce.com
29Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
30
31{
32 "logShipperName":"shipper1",
33 "destConfig":{
34 "kafkaConfig": {
35 "brokers": ["localhost:9092"],
36 "topic": "test_logshipper",
37 "maxRetries": 2
38 }
39 }
40}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "success": true
10 "code": "OK"
11}评价此篇文章