创建日程
建议更改
PDF
您可以使用 `CreateSchedule`按预定时间间隔自动创建卷的快照。
您可以稍后使用创建的快照作为备份或回滚，以确保卷或卷组上的数据在创建快照的时间点保持一致。如果您安排快照运行的时间段不能被 5 分钟整除，则快照将在下一个能被 5 分钟整除的时间段运行。例如，如果您安排快照在 UTC 时间 12:42:00 运行，它将在 UTC 时间 12:45:00 运行。您无法安排快照运行的间隔小于 5 分钟。
|
如果集群容量处于第 1、2 或 3 阶段，则可以创建快照。当集群容量达到 4 或 5 级时，无法创建快照。 |
参数
该方法有以下输入参数：
| 名称 | 描述 | 类型 | 默认值 | 必填项 |
|---|---|---|---|---|
|
使用“
|
JSON 对象 |
无 |
否 |
|
需要协助添加描述 |
布尔值 |
|
否 |
|
在“星期”或“月份”模式下，两次重复快照之间的间隔小时数或 GMT 时间的小时数，即快照发生的日期。有效值为 0 到 23。 |
整数 |
无 |
否 |
|
上次计划快照创建的结果或状态。 |
string |
无 |
否 |
|
快照的名称。如果没有输入姓名，则使用拍摄群组快照的日期和时间。名称长度上限为 244 个字符。 |
string |
无 |
否 |
|
周期性快照之间的分钟数，或者在“星期”或“月份”模式下，快照发生的格林威治标准时间分钟数。有效值为 5 到 59。 |
整数 |
无 |
否 |
|
指示是否应暂停日程安排。有效值：
|
布尔值 |
无 |
否 |
|
指示该日程安排是否会定期重复。有效值包括：
|
布尔值 |
无 |
否 |
|
指定调度程序下次运行时是否运行快照。设置为 true 时，计划快照将在调度程序下次激活时运行，并重置为 false。有效值包括：
|
布尔值 |
|
否 |
|
为日程表起一个独特的名称。允许的最大日程名称长度为 244 个字符。 |
string |
无 |
是 |
|
指示要创建的日程类型。有效值为 snapshot。 |
string |
无 |
是 |
|
为计划赋予的唯一名称、创建的快照的保留期限以及创建快照的卷的卷 ID。有效值：
|
JSON 对象 |
无 |
是 |
|
SnapMirror软件用于指定SnapMirror端点上的快照保留策略的标签。 |
string |
无 |
否 |
|
之后的时间将决定该日程的运行。如果未设置，则立即开始计时。时间格式为UTC时间。 |
ISO 8601 日期字符串 |
无 |
否 |
|
指定在快照创建完成后删除此快照计划。 |
布尔值 |
|
否 |
|
每月拍摄快照的日期。有效值为 1 到 31。 |
整数数组 |
无 |
是的（如果安排在每月的特定日期） |
|
创建快照的日期是星期几。必填值（如果使用）：
|
JSON 对象数组 |
无 |
是的（如果安排在一周中的某一天） |
返回值
此方法具有以下返回值：
名称 |
描述 |
类型 |
计划ID |
已创建日程的 ID。 |
整数 |
日程 |
包含有关新创建的日程安排信息的对象。 |
请求示例 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