有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能描述

本接口可用于修改现有的投递任务,客户如果使用此接口,需要自行处理 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

响应头

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

响应参数

无。

错误码

参见 错误码