建立排程
您可以使用 `CreateSchedule`來排程磁碟區在定義的時間間隔內的自動快照。
您可以稍後使用建立的快照做為備份或復原、以確保磁碟區或磁碟區群組上的資料在建立快照的時間點保持一致。如果您排程快照在5分鐘內不可見的時間段執行、快照將在下一個時間段執行、時間間隔為5分鐘。例如、如果您排定快照在 12 : 42 : 00 UTC 執行、快照將於 12 : 45 : 00 UTC 執行。您無法排程快照以5分鐘以內的時間間隔執行。
如果叢集完整度處於階段1、2或3、您可以建立快照。叢集完整度達到階段4或5時、您無法建立快照。 |
參數
此方法具有下列輸入參數:
名稱 | 說明 | 類型 | 預設值 | 必要 |
---|---|---|---|---|
|
使用「frequency」字串來指出快照的頻率。可能值:
|
Json物件 |
無 |
否 |
|
需要說明的說明 |
布林值 |
|
否 |
|
每週重複快照之間的時數或每小時的格林尼治標準時間(以每週天數或每月天數模式計算)。有效值為 0 至 23 。 |
整數 |
無 |
否 |
|
上次排程快照建立的結果或狀態。 |
字串 |
無 |
否 |
|
快照的名稱。如果未輸入名稱、則會使用拍攝群組快照的日期和時間。允許的最大名稱長度為 244 個字元。 |
字串 |
無 |
否 |
|
週期性快照之間的分鐘數、或快照將以每週數天或每月數日模式所發生的時間(以GMT時間 為單位)。有效值為 5 至 59 。 |
整數 |
無 |
否 |
|
指出排程是否應暫停。有效值:
|
布林值 |
無 |
否 |
|
指出排程是否為週期性。有效值包括:
|
布林值 |
無 |
否 |
|
指定是否在下次排程器處於作用中狀態時執行快照。設為true時、排程快照會在排程器下次作用時執行、並重新設回假。有效值包括:
|
布林值 |
|
否 |
|
排程的唯一名稱。允許的排程名稱長度上限為24個字元。 |
字串 |
無 |
是的 |
|
指出要建立的排程類型。有效值為Snapshot。 |
字串 |
無 |
是的 |
|
排程的唯一名稱、所建立快照的保留期間、以及建立快照的磁碟區Volume ID。有效值:
|
Json物件 |
無 |
是的 |
|
SnapMirror軟體用來指定SnapMirror端點上的快照保留原則的標籤。 |
字串 |
無 |
否 |
|
排程執行的時間。如果未設定、排程會立即開始。格式化為UTC時間。 |
ISO 8601日期字串 |
無 |
否 |
|
指定此快照排程應在建立快照後刪除。 |
布林值 |
|
否 |
|
每月快照的日期。有效值為 1 至 31 。 |
整數陣列 |
無 |
是(如果排程為每月天數) |
|
快照將在一週中的某天建立。必要值(若有使用):
|
Json物件陣列 |
無 |
是(如果排程為一週中的天數) |
傳回值
此方法具有下列傳回值:
名稱 |
說明 |
類型 |
scheduleID |
已建立排程的ID。 |
整數 |
排程 |
包含新建立排程資訊的物件。 |
申請範例1.
下列排程範例包含下列參數:
-
未指定開始時間或分鐘數、因此排程會盡可能接近午夜( 00 : 00 : 00Z )。
-
不會重複發生(只會執行一次)。
-
它會在 2015 年 6 月 1 日之後的第一個週日或週三、 UTC 19 : 17 : 15 Z (以先到的日期為準)執行一次。
-
它僅包含一個Volume(Volume ID = 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 執行。
-
它僅包含一個Volume(Volume ID = 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執行。
-
其中包括一組磁碟區(Volume = 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