Zeitplan erstellen
Sie können verwenden CreateSchedule um einen automatischen Snapshot eines Volumes in einem definierten Intervall zu planen.
Sie können den erstellten Snapshot später als Backup oder Rollback verwenden, um sicherzustellen, dass die Daten auf einem Volume oder einer Gruppe von Volumes zu dem Zeitpunkt konsistent sind, zu dem der Snapshot erstellt wurde. Wenn Sie einen Snapshot für einen Zeitraum planen, der nicht durch 5 Minuten teilbar ist, wird der Snapshot zum nächsten Zeitpunkt ausgeführt, der durch 5 Minuten teilbar ist. Wenn Sie beispielsweise einen Snapshot für 12:42:00 UTC planen, wird er um 12:45:00 UTC ausgeführt. Sie können nicht planen, dass ein Snapshot in Abständen von weniger als 5 Minuten ausgeführt wird.
|
|
Sie können Snapshots erstellen, wenn der Cluster ausgelastet ist (Stufe 1, 2 oder 3). Snapshots können nicht erstellt werden, wenn der Cluster-Füllstand Stufe 4 oder 5 erreicht. |
Parameter
Diese Methode hat die folgenden Eingabeparameter:
| Name | Beschreibung | Typ | Standardwert | Erforderlich |
|---|---|---|---|---|
|
Verwenden Sie die Zeichenkette “frequency”, um die Häufigkeit der Momentaufnahme anzugeben. Mögliche Werte:
|
JSON-Objekt |
Keine |
Nein |
|
Hilfe bei der Beschreibung benötigt |
boolescher Wert |
|
Nein |
|
Anzahl der Stunden zwischen wiederkehrenden Snapshots oder Stunde in GMT-Zeit, zu der der Snapshot im Wochentags- oder Monatsmodus erstellt wird. Gültige Werte sind 0 bis 23. |
ganze Zahl |
Keine |
Nein |
|
Das Ergebnis oder der Status der letzten geplanten Snapshot-Erstellung. |
Schnur |
Keine |
Nein |
|
Der Name des Snapshots. Wird kein Name eingegeben, wird das Datum und die Uhrzeit der Gruppenaufnahme verwendet. Die maximal zulässige Namenslänge beträgt 244 Zeichen. |
Schnur |
Keine |
Nein |
|
Anzahl der Minuten zwischen wiederkehrenden Momentaufnahmen oder die Minute in GMT-Zeit, zu der die Momentaufnahme im Wochentags- oder Monatsmodus erfolgen soll. Gültige Werte sind 5 bis 59. |
ganze Zahl |
Keine |
Nein |
|
Gibt an, ob der Zeitplan pausiert werden soll oder nicht. Gültige Werte:
|
boolescher Wert |
Keine |
Nein |
|
Gibt an, ob der Zeitplan wiederkehrend ist oder nicht. Gültige Werte sind:
|
boolescher Wert |
Keine |
Nein |
|
Legt fest, ob der Snapshot beim nächsten aktiven Scheduler ausgeführt werden soll oder nicht. Wenn diese Einstellung auf „true“ gesetzt ist, wird der geplante Snapshot beim nächsten aktiven Scheduler ausgeführt und anschließend wieder auf „false“ zurückgesetzt. Gültige Werte sind:
|
boolescher Wert |
|
Nein |
|
Einzigartiger Name für den Zeitplan. Die maximal zulässige Länge des Terminplannamens beträgt 244 Zeichen. |
Schnur |
Keine |
Ja |
|
Gibt den zu erstellenden Zeitplantyp an. Gültiger Wert ist Snapshot. |
Schnur |
Keine |
Ja |
|
Der eindeutige Name des Zeitplans, die Aufbewahrungsfrist für den erstellten Snapshot und die Volume-ID des Volumes, von dem der Snapshot erstellt wurde. Gültige Werte:
|
JSON-Objekt |
Keine |
Ja |
|
Die Bezeichnung, die von der SnapMirror -Software verwendet wird, um die Aufbewahrungsrichtlinie für Snapshots auf einem SnapMirror Endpunkt festzulegen. |
Schnur |
Keine |
Nein |
|
Zeitpunkt, nach dem der Zeitplan ausgeführt wird. Falls kein Zeitplan festgelegt ist, beginnt dieser sofort. Formatiert in UTC-Zeit. |
ISO 8601 Datumszeichenfolge |
Keine |
Nein |
|
Gibt an, dass dieser Snapshot-Zeitplan nach Abschluss der Snapshot-Erstellung gelöscht werden soll. |
boolescher Wert |
|
Nein |
|
Die Tage des Monats, an denen eine Momentaufnahme erstellt wird. Gültige Werte sind 1 bis 31. |
Ganzzahl-Array |
Keine |
Ja (bei Terminplanung für Tage im Monat) |
|
An welchem Wochentag soll der Snapshot erstellt werden? Erforderliche Werte (falls verwendet):
|
JSON-Objektarray |
Keine |
Ja (bei Planung nach Wochentagen) |
Rückgabewerte
Diese Methode hat die folgenden Rückgabewerte:
Name |
Beschreibung |
Typ |
Zeitplan-ID |
ID des erstellten Zeitplans. |
ganze Zahl |
Zeitplan |
Ein Objekt, das Informationen über den neu erstellten Zeitplan enthält. |
Anfragebeispiel 1
Der folgende Beispielzeitplan hat die folgenden Parameter:
-
Es werden keine Startzeiten oder -minuten angegeben, sodass der Zeitplan so nah wie möglich an Mitternacht (00:00:00Z) beginnt.
-
Es wird nicht wiederholt (wird nur einmal ausgeführt).
-
Es findet einmalig entweder am ersten Sonntag oder Mittwoch nach dem 1. Juni 2015, 19:17:15 UTC (je nachdem, welcher Tag zuerst kommt) statt.
-
Es enthält nur einen Band (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
}
}
}
Antwortbeispiel 1
Die obige Anfrage liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"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
}
}
Anfragebeispiel 2
Der folgende Beispielzeitplan hat die folgenden Parameter:
-
Es handelt sich um eine wiederkehrende Aktion (wird in jedem geplanten Intervall des Monats zur angegebenen Zeit ausgeführt).
-
Es findet am 1., 10., 15. und 30. jedes Monats nach dem Startdatum statt.
-
Es findet an jedem geplanten Tag um 12:15 Uhr statt.
-
Es enthält nur einen Band (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
}
Antwortbeispiel 2
Die obige Anfrage liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"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
}
}
Anfragebeispiel 3
Der folgende Beispielzeitplan hat die folgenden Parameter:
-
Es beginnt innerhalb von 5 Minuten nach dem geplanten Zeitpunkt am 2. April 2015.
-
Es handelt sich um eine wiederkehrende Aktion (wird in jedem geplanten Intervall des Monats zur angegebenen Zeit ausgeführt).
-
Es findet am zweiten, dritten und vierten Tag jedes Monats nach dem Startdatum statt.
-
Es findet an jedem geplanten Veranstaltungstag um 14:45 Uhr statt.
-
Es umfasst eine Gruppe von Bänden (Bände = 1 und 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
}
Antwortbeispiel 3
Die obige Anfrage liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"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
}
}
Neu seit Version
9,6