功能描述
本接口可用于修改现有的投递任务,客户如果使用此接口,需要自行处理 CLS 对指定 Bucket 的写权限。
请求示例
PUT /shipper HTTP/1.1Host: <Region>.cls.tencentyun.comAuthorization: <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 | 是 | 压缩格式,支持 gzip 、lzop 和none 不压缩 |
content 格式如下:
字段名 | 类型 | 是否必须 | 含义 |
format | string | 是 | 内容格式,支持 json 、csv |
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 OKContent-Type: application/jsonContent-Length: 0
响应头
除公共响应头部外,无特殊响应头部。
响应参数
无。