Skip to main content
Element Software
12.5
Hay disponible una nueva versión de este producto.
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

CreateSchedule

Colaboradores
PDF

Se puede utilizar CreateSchedule para programar una snapshot automática de un volumen en un intervalo definido.

Es posible usar la snapshot creada más adelante como un backup o una reversión para garantizar que los datos de un volumen o un grupo de volúmenes sean consistentes en el momento específico en el que se creó la snapshot. Si se programa la ejecución de una copia de Snapshot en un período que no sea divisible entre 5 minutos, la copia de Snapshot se ejecutará en el siguiente período que lo sea 5. Por ejemplo, si se programa la ejecución de una copia de Snapshot a las 12:42:00 UTC, se realizará a las 12:45:00 UTC. No se podrá programar la ejecución de una copia de Snapshot en intervalos inferiores a 5 minutos.

Nota Puede crear copias de Snapshot si la ocupación del clúster se encuentra en la etapa 1, 2 o 3. No se pueden crear copias de Snapshot cuando la ocupación del clúster llegue a la etapa 4 o 5.

Parámetros

Este método tiene los siguientes parámetros de entrada:

Nombre Descripción Tipo Valor predeterminado Obligatorio

attributes

Utilice la cadena "'frequency'" para indicar la frecuencia de la instantánea. Los posibles valores son los siguientes:

  • Days of Week

  • Days of Month

  • Time Interval

Objeto JSON

Ninguno

No

hasError

Se necesita ayuda con descripción

booleano

false

No

hours

Cantidad de horas entre instantáneas recurrentes o hora en la hora GMT que la snapshot se realizará en el modo días de la semana o días del mes. Los valores válidos abarcan de 0 a 23.

entero

Ninguno

No

lastRunStatus

El resultado o el estado de la última creación de snapshot programada.

cadena

Ninguno

No

name

El nombre de la copia de Snapshot. Si no se introduce ningún nombre, se utilizará la fecha y la hora en que se tomó la snapshot de grupo. La longitud máxima permitida para el nombre es de 244 caracteres.

cadena

Ninguno

No

minutes

Cantidad de minutos entre las snapshots que se repiten o el minuto en la hora GMT en que la snapshot se producirá en el modo días de la semana o días del mes. Los valores válidos son de 5 a 59.

entero

Ninguno

No

paused

Indica si la programación debe estar en pausa o no. Valores válidos:

  • true

  • false

booleano

Ninguno

No

recurring

Indica si la programación será periódica o no. Valores válidos:

  • true

  • false

booleano

Ninguno

No

runNextInterval

Especifica si se va a ejecutar la snapshot la próxima vez que esté activo el programador. Cuando se configura en true, la snapshot programada se ejecuta la próxima vez que el programador esté activo y se restablece en false. Valores válidos:

  • true

  • false

booleano

false

No

scheduleName

Nombre único de la programación. La longitud máxima permitida para el nombre de programación es de 244 caracteres.

cadena

Ninguno

Sí

scheduleType

Indica el tipo de programación que se va a crear. El valor válido es snapshot.

cadena

Ninguno

Sí

scheduleInfo

El nombre único que se le asignó a la programación, el período de retención de la copia de Snapshot que se creó y el ID de volumen del volumen a partir del cual se creó la copia de Snapshot. Valores válidos:

  • volumeID: El ID del volumen que se incluirá en la snapshot. (entero)

  • volumes: Una lista de los ID de volumen que se incluirán en la snapshot de grupo. (matriz entera)

  • name: El nombre de snapshot que se va a utilizar. (cadena)

  • enableRemoteReplication: Indica si la instantánea debe incluirse en la replicación remota. (booleano)

  • retention: La cantidad de tiempo que la instantánea se retendrá en HH:MM:ss. Si está vacío, la copia de Snapshot se conserva siempre. (cadena)

  • fifo: La instantánea se mantiene en base al primero en primero en salir (FIFO). (cadena)

  • ensureSerialCreation: Especifique si se debe permitir una nueva creación de instantáneas si hay una replicación de instantáneas anterior en curso. (booleano)

Objeto JSON

Ninguno

Sí

snapMirrorLabel

La etiqueta que utiliza el software SnapMirror para especificar la política de retención de snapshots en un extremo de SnapMirror.

cadena

Ninguno

No

startingDate

Hora después de la cual se ejecutará la programación. Si no se define, la programación se inicia de inmediato. Con formato de hora UTC.

Cadena de fecha ISO 8601

Ninguno

No

toBeDeleted

Especifica que esta programación de snapshots se debe eliminar una vez que se completa la creación de la snapshot.

booleano

false

No

monthdays

Los días del mes en que se realizará una copia de Snapshot. Los valores válidos abarcan de 1 a 31.

matriz en números enteros

Ninguno

Sí (si está programado para los días del mes)

weekdays

Día de la semana en que se va a crear la snapshot. Valores requeridos (si se utiliza):

  • Day: 0 a 6 (de domingo a sábado)

  • Offset: Para cada semana posible en un mes, 1 a 6 (Si es mayor que 1, solo coincide el día Nth-1 de la semana. Por ejemplo, offset:3 para domingo significa el tercer domingo del mes, mientras que offset:4 para miércoles significa el cuarto miércoles del mes. Offset:0 significa que no se realiza ninguna acción. Offset:1 (predeterminado) significa que la snapshot se crea para este día de la semana, independientemente de dónde esté en el mes

Cabina de objetos JSON

Ninguno

Sí (si está programado para los días de la semana)

Valores devueltos

Este método tiene los siguientes valores devueltos:

Nombre

Descripción

Tipo

ID de intervalo

Se creó el ID de la programación.

entero

programación

Objeto que contiene información acerca de la programación recién creada.

programación

Ejemplo de solicitud 1

En el siguiente ejemplo de programación se tienen los parámetros siguientes:

  • No se especifican horas ni minutos de inicio, por lo que el programa comienza lo más cerca posible a medianoche (00:00:00Z).

  • No es recurrente (sólo se ejecutará una vez).

  • Se ejecuta una vez en el primer domingo o miércoles después del 1 de junio de 2015, UTC 19:17:15Z (cualquier día que llegue primero).

  • Solo incluye un volumen (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
}
}
}

Ejemplo de respuesta 1

La solicitud anterior devuelve una respuesta similar al siguiente ejemplo:

{
  "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
  }
}

Ejemplo de solicitud 2

En el siguiente ejemplo de programación se tienen los parámetros siguientes:

  • Es recurrente (se ejecutará en cada intervalo programado del mes a la hora especificada).

  • Funciona el 1, 10, 15 y 30 de cada mes siguiente a la fecha de inicio.

  • Se ejecuta a las 12:15 PM cada día que está programado para ocurrir.

  • Solo incluye un volumen (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
}

Ejemplo de respuesta 2

La solicitud anterior devuelve una respuesta similar al siguiente ejemplo:

{
  "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
  }
}

Ejemplo de solicitud 3

En el siguiente ejemplo de programación se tienen los parámetros siguientes:

  • Comienza dentro de los 5 minutos del intervalo programado el 2 de abril de 2015.

  • Es recurrente (se ejecutará en cada intervalo programado del mes a la hora especificada).

  • Se ejecuta en el segundo, tercero y cuarto de cada mes después de la fecha de inicio.

  • Se ejecuta a las 14:45 PM cada día que está programado para ocurrir.

  • Incluye un grupo de volúmenes (volúmenes = 1 y 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
}

Ejemplo de respuesta 3

La solicitud anterior devuelve una respuesta similar al siguiente ejemplo:

{
  "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
  }
}

Nuevo desde la versión

9,6