创建生命周期规则
更新时间：2025-09-30
描述
创建一个生命周期规则，返回对应的生命周期规则id
请求
请求结构
Plain Text
1POST /?action=CreateL2Policy
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 "policyName": "name",
10 "path": "/xxxx/yyyy",
11 "expiredTime": 365,
12 "type": 1,
13 "executeTime": 0,
14 "bucketName": "bucket",
15 "bucketPrefix": "this/is/prefix/",请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 | 限制 |
|---|---|---|---|---|---|
| version | string | 是 | Request Header | 此接口为v2版本，固定为v2 | |
| action | string | 是 | URL Query | 本接口中固定为 CreateL2Policy | |
| instanceId | string | 是 | Request Body | 创建规则的pfs实例短id | |
| policyName | string | 是 | Request Body | 创建规则的名称 | 支持大小写字母、数字、中文、半角冒号（:）、下划线（_）或者短划线（-）。必须以大小字母或中文开头，长度为1~128个英文或中文字符 |
| path | string | 是 | Request Body | 规则对应的路径 | 以"/"开头，非"/"结尾 |
| expiredTime | Int | 是 | Request Body | 规则的过期时间，单位天 | 1 ～ 365*5 |
| type | Int | 是 | Request Body | 规则的类型： 0：表示数据删除 1：表示数据转存 |
|
| executeTime | Int | 否 | Request Body | 规则的执行时间点，0～23整数 | 默认为0，范围在：0 ～ 23 |
| bucketName | string | 否 | Request Body | 数据转存对应的bucket | 当type为数据转存时，该字段必须声明 |
| bucketPrefix | string | 否 | Request Body | 数据转存对应的prefix | 当type为数据转存时，该字段必须声明prefix非"/'开头，以"/"结尾 |
响应
返回状态码，成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 | |
|---|---|---|---|---|---|
| requestId | string | 是 | response body | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 | |
| policyId | string | 是 | response body | 对应的policyId |
示例
请求：
Plain Text
1POST /?action=CreateL2Policy
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 "policyName": "name",
10 "path": "/xxxx/yyyy",
11 "expiredTime": 365,
12 "type": 1,
13 "executeTime": 0,
14 "bucketName": "bucket",
15 "bucketPrefix": "/this/is/prefix/",
16}响应：
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
6{
7 "requestId": "946002ee-cb4f-4aad-b686-5be55df27f09",
8 "policyId": "policy-xxx",
9}