CriarAgenda
Você pode usar CreateSchedule Agendar uma captura automática de um volume em um intervalo definido.
Você pode usar o snapshot criado posteriormente como backup ou reversão para garantir que os dados em um volume ou grupo de volumes estejam consistentes no momento em que o snapshot foi criado. Se você agendar a captura de um instantâneo para um período que não seja divisível por 5 minutos, a captura será executada no próximo período divisível por 5 minutos. Por exemplo, se você agendar a captura de um instantâneo para ser executada às 12:42:00 UTC, ela será executada às 12:45:00 UTC. Não é possível agendar a captura de um instantâneo em intervalos inferiores a 5 minutos.
|
|
Você pode criar snapshots se o nível de preenchimento do cluster estiver no estágio 1, 2 ou 3. Não é possível criar snapshots quando o nível de preenchimento do cluster atinge o estágio 4 ou 5. |
Parâmetros
Este método possui os seguintes parâmetros de entrada:
| Nome | Descrição | Tipo | Valor padrão | Obrigatório |
|---|---|---|---|---|
|
Use a string “frequency” para indicar a frequência da captura de tela. Valores possíveis:
|
objeto JSON |
Nenhum |
Não |
|
Precisa-se de ajuda com a descrição |
booleano |
|
Não |
|
Número de horas entre capturas de tela recorrentes ou hora em GMT em que a captura de tela ocorrerá no modo Dias da Semana ou Dias do Mês. Os valores válidos são de 0 a 23. |
inteiro |
Nenhum |
Não |
|
O resultado ou status da última criação de instantâneo agendada. |
corda |
Nenhum |
Não |
|
O nome da imagem. Caso nenhum nome seja inserido, a data e a hora em que a foto do grupo foi tirada serão utilizadas. O comprimento máximo permitido para o nome é de 244 caracteres. |
corda |
Nenhum |
Não |
|
Número de minutos entre capturas de tela recorrentes ou o minuto em GMT em que a captura de tela ocorrerá no modo Dias da Semana ou Dias do Mês. Os valores válidos são de 5 a 59. |
inteiro |
Nenhum |
Não |
|
Indica se a programação deve ser pausada ou não. Valores válidos:
|
booleano |
Nenhum |
Não |
|
Indica se a programação será recorrente ou não. Os valores válidos são:
|
booleano |
Nenhum |
Não |
|
Especifica se o instantâneo deve ou não ser executado na próxima vez que o agendador estiver ativo. Quando definido como verdadeiro, o snapshot agendado é executado na próxima vez que o agendador estiver ativo e, em seguida, é redefinido para falso. Os valores válidos são:
|
booleano |
|
Não |
|
Nome único para a programação. O comprimento máximo permitido para o nome da programação é de 244 caracteres. |
corda |
Nenhum |
Sim |
|
Indica o tipo de cronograma a ser criado. O valor válido é snapshot. |
corda |
Nenhum |
Sim |
|
O nome exclusivo atribuído ao agendamento, o período de retenção do instantâneo criado e o ID do volume a partir do qual o instantâneo foi criado. Valores válidos:
|
objeto JSON |
Nenhum |
Sim |
|
O rótulo usado pelo software SnapMirror para especificar a política de retenção de snapshots em um endpoint SnapMirror . |
corda |
Nenhum |
Não |
|
Horário após o qual a programação será executada. Caso não seja configurado, o agendamento inicia imediatamente. Formatado em horário UTC. |
string de data ISO 8601 |
Nenhum |
Não |
|
Especifica que este agendamento de instantâneo deve ser excluído após a conclusão da criação do instantâneo. |
booleano |
|
Não |
|
Os dias do mês em que será tirada uma fotografia. Os valores válidos são de 1 a 31. |
matriz de inteiros |
Nenhum |
Sim (se o agendamento for para dias específicos do mês) |
|
Dia da semana em que a captura de tela deve ser feita. Valores obrigatórios (se utilizados):
|
matriz de objetos JSON |
Nenhum |
Sim (se o agendamento for por dias da semana) |
Valores de retorno
Este método tem os seguintes valores de retorno:
Nome |
Descrição |
Tipo |
ID do agendamento |
ID do cronograma criado. |
inteiro |
agendar |
Um objeto contendo informações sobre o cronograma recém-criado. |
Exemplo de solicitação 1
O seguinte exemplo de cronograma possui os seguintes parâmetros:
-
Não são especificados horários ou minutos de início, portanto a programação começa o mais próximo possível da meia-noite (00:00:00 UTC).
-
Não é recorrente (será executado apenas uma vez).
-
O evento ocorre uma vez, no primeiro domingo ou quarta-feira após 1º de junho de 2015, às 19:17:15 UTC (o que ocorrer primeiro).
-
Inclui apenas um volume (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
}
}
}
Exemplo de resposta 1
A solicitação acima retorna uma resposta semelhante ao exemplo a seguir:
{
"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
}
}
Exemplo de solicitação 2
O seguinte exemplo de cronograma possui os seguintes parâmetros:
-
É recorrente (será executado em cada intervalo programado do mês, no horário especificado).
-
O evento acontece nos dias 1, 10, 15 e 30 de cada mês subsequente à data de início.
-
O evento acontece às 12h15 em todos os dias em que está programado para ocorrer.
-
Inclui apenas um volume (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
}
Exemplo de resposta 2
A solicitação acima retorna uma resposta semelhante ao exemplo a seguir:
{
"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
}
}
Exemplo de solicitação 3
O seguinte exemplo de cronograma possui os seguintes parâmetros:
-
Começa dentro de 5 minutos do intervalo programado em 2 de abril de 2015.
-
É recorrente (será executado em cada intervalo programado do mês, no horário especificado).
-
O evento ocorre no segundo, terceiro e quarto dia de cada mês subsequente à data de início.
-
O evento acontece às 14h45 em todos os dias em que está programado.
-
Inclui um grupo de volumes (volumes = 1 e 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
}
Exemplo de resposta 3
A solicitação acima retorna uma resposta semelhante ao exemplo a seguir:
{
"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
}
}
Novidade desde a versão
9,6