文档中心>日志服务

修改投递任务

最近更新时间:2020-08-18 15:30:36

我的收藏

功能描述

本接口可用于修改现有的投递任务,客户如果使用此接口,需要自行处理 CLS 对指定 Bucket 的写权限。

请求示例

PUT /shipper HTTP/1.1
Host: <Region>.cls.tencentyun.com
Authorization: <AuthorizationString>
Content-Type: application/json

{
"shipper_id": "xxxx-xx-xx-xx-xxxxxxxx",
"bucket": "test-1250000001",
"prefix": "test",
"shipper_name": "myname",
"interval": 300,
"max_size": 100,
"effective": true,
"partition": "%Y%m%d",
"compress": {
"format": "none"
},
"content": {
"format": "json"
}
}

请求行

PUT /shipper

请求头

除公共头部外,无特殊请求头部。

请求参数

字段名
类型
位置
是否必须
含义
shipper_id
string
body
修改的 Shipper 的 ID
bucket
string
body
Shipper 投递的新的 bucket,格式:{bucketName}-{appid}
prefix
string
body
Shipper 投递的新的目录前缀
shipper_name
string
body
投递规则的名字
interval
int
body
投递的时间间隔,单位:秒,默认300,取值范围为:[300,360,420,480,540,600,660,720,780,840,900](即整数分钟级别数值)
max_size
int
body
投递的文件的最大值,单位:MB,默认100,范围100 - 256
effective
bool
body
Shipper 的开关状态
partition
string
body
投递日志的分区规则,支持strftime的时间格式表示
compress
object
body
投递日志的压缩配置
content
object
body
投递日志的内容格式配置
compress 格式如下:
字段名
类型
是否必须
含义
format
string
压缩格式,支持gziplzopnone不压缩
content 格式如下:
字段名
类型
是否必须
含义
format
string
内容格式,支持jsoncsv
csv_info
object
内容格式为csv时设置
csv_info 格式如下:
字段名
类型
是否必须
含义
print_key
bool
csv 首行是否打印 key
keys
array(string)
每列 key 的名字
delimiter
string
各字段间的分隔符
escape_char
string
若字段内容中包含分隔符,则使用该转义符包裹改字段
non_existing_field
string
对于上面指定的不存在字段使用该内容填充
说明:
其中 bucket、prefix、shipper_name、interval、max_size、effective、compress 字段至少要有一个。

响应

响应示例

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0

响应头

除公共响应头部外,无特殊响应头部。

响应参数

无。

错误码

参见 错误码