发行说明
CreateSchedule
建议更改
PDF
您可以使用 CreateSchedule 按定义的间隔计划卷的自动快照。
您可以稍后将创建的快照用作备份或回滚，以确保卷或一组卷上的数据在创建快照的时间点保持一致。如果计划在不可被 5 分钟整除的时间段运行快照，则快照将在下一个可被 5 分钟整除的时间段运行。例如，如果计划在 12 ： 42 ： 00 UTC 运行快照，则快照将在 12 ： 45 ： 00 UTC 运行。您不能计划以少于 5 分钟的间隔运行快照。
|
如果集群填充度处于第 1 ， 2 或 3 阶段，则可以创建快照。当集群填充度达到第 4 或第 5 阶段时，您无法创建快照。 |
Parameters
此方法具有以下输入参数：
| Name | Description | Type | 默认值 | Required |
|---|---|---|---|---|
|
使用 "`frequency` " 字符串指示快照的频率。可能值：
|
JSON 对象 |
无 |
否 |
|
* 需要问题描述帮助 * |
boolean |
|
否 |
|
重复快照之间的小时数，或者在 GMT 时间中，快照将在一周中的某些天或几天的月份模式下发生的小时数。有效值为 0 到 23 。 |
整型 |
无 |
否 |
|
上次计划快照创建的结果或状态。 |
string |
无 |
否 |
|
快照的名称。如果未输入任何名称，则会使用创建组快照的日期和时间。允许的最大名称长度为 244 个字符。 |
string |
无 |
否 |
|
重复快照之间的分钟数，或在一周中的某些天或一个月中的某些天模式下快照在 GMT 时间内的分钟数。有效值为 5 到 59 。 |
整型 |
无 |
否 |
|
指示是否应暂停计划。有效值：
|
boolean |
无 |
否 |
|
指示计划是否重复。有效值为：
|
boolean |
无 |
否 |
|
指定是否在计划程序下次处于活动状态时运行快照。如果设置为 true ，则计划快照会在计划程序下次处于活动状态时运行，并重置为 false 。有效值为：
|
boolean |
|
否 |
|
计划的唯一名称。允许的最大计划名称长度为 244 个字符。 |
string |
无 |
是的。 |
|
指示要创建的计划的类型。有效值为 snapshot 。 |
string |
无 |
是的。 |
|
为计划指定的唯一名称，创建的快照的保留期限以及从中创建快照的卷的卷 ID 。有效值：
|
JSON 对象 |
无 |
是的。 |
|
SnapMirror 软件用于在 SnapMirror 端点上指定快照保留策略的标签。 |
string |
无 |
否 |
|
运行计划所经过的时间。如果未设置，计划将立即启动。采用 UTC 时间格式。 |
ISO 8601 日期字符串 |
无 |
否 |
|
指定在创建快照后应删除此快照计划。 |
boolean |
|
否 |
|
一个月中将创建快照的天数。有效值为 1 到 31 。 |
整型数组 |
无 |
是（如果计划在一个月中的几天内执行） |
|
要创建快照的星期几。所需值（如果使用）：
|
JSON 对象数组 |
无 |
是（如果计划在一周中的几天内执行） |
返回值
此方法具有以下返回值：
Name |
Description |
Type |
计划 ID |
已创建计划的 ID 。 |
整型 |
schedule |
包含有关新创建的计划的信息的对象。 |
请求示例 1
以下示例计划包含以下参数：
-
由于未指定开始时间或分钟，因此计划尽可能接近午夜（ 00 ： 00 ： 00Z ）。
-
它不会重复运行（仅运行一次）。
-
此计划在 2015 年 6 月 1 日 UTC 19 ： 17 ： 15Z 之后的第一个星期日或星期三（以较早日期为准）运行一次。
-
它仅包含一个卷（ volumeID = 1 ）。
{
"method":"CreateSchedule",
"params":{
"hours":0,
"minutes":0,
"paused":false,
"recurring":false,
"scheduleName":"MCAsnapshot1",
"scheduleType":"snapshot",
"attributes":{
"frequency":"Days Of Week"
},
"scheduleInfo":{
"volumeID":"1",
"name":"MCA1"
},
"monthdays":[],
"weekdays":[
{
"day":0,
"offset":1
},
{
"day":3,
"offset":1
}
],
"startingDate":"2015-06-01T19:17:54Z"
},
"id":1
}
}
}
响应示例 1
上述请求返回类似于以下示例的响应：
{
"id": 1,
"result": {
"schedule": {
"attributes": {
"frequency": "Days Of Week"
},
"hasError": false,
"hours": 0,
"lastRunStatus": "Success",
"lastRunTimeStarted": null,
"minutes": 0,
"monthdays": [],
"paused": false,
"recurring": false,
"runNextInterval": false,
"scheduleID": 4,
"scheduleInfo": {
"name": "MCA1",
"volumeID": "1"
},
"scheduleName": "MCAsnapshot1",
"scheduleType": "Snapshot",
"startingDate": "2015-06-01T19:17:54Z",
"toBeDeleted": false,
"weekdays": [
{
"day": 0,
"offset": 1
},
{
"day": 3,
"offset": 1
}
]
},
"scheduleID": 4
}
}
请求示例 2
以下示例计划包含以下参数：
-
它是重复运行的（将在指定时间按月中的每个计划间隔运行）。
-
此计划在开始日期之后的每个月的 1 日， 10 日， 15 日和 30 日运行。
-
它在计划的每一天的中午 12 ： 15 运行。
-
它仅包含一个卷（ volumeID = 1 ）。
{
"method":"CreateSchedule",
"params":{
"hours":12,
"minutes":15,
"paused":false,
"recurring":true,
"scheduleName":"MCASnapshot1",
"scheduleType":"snapshot",
"attributes":{
"frequency":"Days Of Month"
},
"scheduleInfo":{
"volumeID":"1"
},
"weekdays":[
],
"monthdays":[
1,
10,
15,
30
],
"startingDate":"2015-04-02T18:03:15Z"
},
"id":1
}
响应示例 2
上述请求返回类似于以下示例的响应：
{
"id": 1,
"result": {
"schedule": {
"attributes": {
"frequency": "Days Of Month"
},
"hasError": false,
"hours": 12,
"lastRunStatus": "Success",
"lastRunTimeStarted": null,
"minutes": 15,
"monthdays": [
1,
10,
15,
30
],
"paused": false,
"recurring": true,
"runNextInterval": false,
"scheduleID": 5,
"scheduleInfo": {
"volumeID": "1"
},
"scheduleName": "MCASnapshot1",
"scheduleType": "Snapshot",
"startingDate": "2015-04-02T18:03:15Z",
"toBeDeleted": false,
"weekdays": []
},
"scheduleID": 5
}
}
请求示例 3.
以下示例计划包含以下参数：
-
此计划在 2015 年 4 月 2 日计划间隔的 5 分钟内启动。
-
它是重复运行的（将在指定时间按月中的每个计划间隔运行）。
-
此计划在开始日期之后每个月的第二个，第三个和第四个运行。
-
它在计划的每一天的下午 14 ： 45 运行。
-
它包括一组卷（卷 = 1 和 2 ）。
{
"method":"CreateSchedule",
"params":{
"hours":14,
"minutes":45,
"paused":false,
"recurring":true,
"scheduleName":"MCASnapUser1",
"scheduleType":"snapshot",
"attributes":{
"frequency":"Days Of Month"
},
"scheduleInfo":{
"volumes":[1,2]
},
"weekdays":[],
"monthdays":[2,3,4],
"startingDate":"2015-04-02T20:38:23Z"
},
"id":1
}
响应示例 3
上述请求返回类似于以下示例的响应：
{
"id": 1,
"result": {
"schedule": {
"attributes": {
"frequency": "Days Of Month"
},
"hasError": false,
"hours": 14,
"lastRunStatus": "Success",
"lastRunTimeStarted": null,
"minutes": 45,
"monthdays": [
2,
3,
4
],
"paused": false,
"recurring": true,
"runNextInterval": false,
"scheduleID": 6,
"scheduleInfo": {
"volumes": [
1,
2
]
},
"scheduleName": "MCASnapUser1",
"scheduleType": "Snapshot",
"startingDate": "2015-04-02T20:38:23Z",
"toBeDeleted": false,
"weekdays": []
},
"scheduleID": 6
}
}
自版本以来的新增功能
9.6