更新生命周期规则
更新时间:2025-09-30
描述
修改生命周期规则
请求
请求结构
Bash
1POST /?action=UpdateL2Policy
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.xx.baidubce.com ## 请将xx替换为对应地域的服务域名,如北京为bj、保定为bd、苏州为su、阳泉为yq
4content-type: application/json
5Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
6version:v2
7{
8 "instanceId": "pfs-Lnf5fM",
9 "policyId": "policy-xxxx"
10 "newPolicyName": "newName",
11 "path": "/xxxx/yyyy",
12 "expiredTime": 400,
13 "executeTime": 1,
14 "bucketName": "bucket",
15 "bucketPrefix": "this/is/prefix/",
16}
请求头域
除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 | 限制 |
---|---|---|---|---|---|
version | string | 是 | Request Header | 此接口为v2版本,固定为v2 | |
action | string | 是 | URL Query | 本接口中固定为 UpdateL2Policy | |
instanceId | string | 是 | Request Body | policyId对应的pfs实例短id | - |
policyId | string | 是 | Request Body | 需要修改policyId | - |
newPolicyName | string | 是 | Request Body | 新规则的名称 | 支持大小写字母、数字、中文、半角冒号(:)、下划线(_)或者短划线(-)。必须以大小字母或中文开头,长度为1~128个英文或中文字符 |
expiredTime | Int | 否 | Request Body | 规则的过期时间,单位天 | 1 ~ 365*5 |
executeTime | Int | 否 | Request Body | 规则的执行时间点,0~23整数 | 默认为0,范围在:0 ~ 23 |
bucketName | string | 否 | Request Body | 数据转存对应的bucket | |
bucketPrefix | string | 否 | Request Body | 数据转存对应的prefix | 非"/"开头,以"/"结尾 |
响应
返回状态码,成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 | |
---|---|---|---|---|---|
requestId | string | 是 | response body | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
示例
请求:
Bash
1POST /?action=UpdateL2Policy
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.xx.baidubce.com ## 请将xx替换为对应地域的服务域名,如北京为bj、保定为bd、苏州为su、阳泉为yq
4content-type: application/json
5Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
6version:v2
7{
8 "instanceId": "pfs-Lnf5fM",
9 "policyId": "policy-xxxx"
10 "newPolicyName": "newName",
11 "path": "/xxxx/yyyy",
12 "expiredTime": 400,
13 "executeTime": 1,
14 "bucketName": "bucket",
15 "bucketPrefix": "this/is/prefix/",
16}
响应:
Bash
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
6{
7 "requestId": "946002ee-cb4f-4aad-b686-5be55df27f09",
8}