Adicionar uma programação de instantâneos no console

Você pode definir com que frequência e quando deseja criar uma cópia de referência do seu volume de armazenamento por meio das programações de Snapshot. É possível ter um máximo de 50 capturas instantâneas por volume de armazenamento. Os horários são gerenciados na guia “ Armazenamento ” > “ File Storage for Classic ” do site IBM Cloud® console.

Para poder configurar seu planejamento inicial, deve-se primeiramente comprar um espaço de captura instantânea, caso você não tenha comprado durante o fornecimento inicial do volume de armazenamento.

Os planejamentos de capturas instantâneas podem ser configurados em intervalos, como por hora, diários e semanais, cada um com um ciclo de retenção diferente. O limite máximo de capturas instantâneas é 50 por volume de armazenamento, que pode ser uma combinação de planejamentos por hora, diários e semanais e capturas instantâneas manuais.

1. Clique no seu volume de armazenamento para ver os detalhes.
2. Clique em Capturas Instantâneas na navegação lateral
3. No painel de programação de instantâneos, clique em Editar +. Você pode escolher entre três frequências diferentes de instantâneos. Use qualquer combinação das três frequências para criar um planejamento de captura instantânea abrangente.
   • Por hora
     • Especifique o minuto de cada hora em que uma captura instantânea deve ser tirada. O padrão é o minuto atual.
     • Especifique o número de capturas instantâneas por hora a serem retidas antes que a mais antiga seja descartada.
   • Diário
     • Especifique a hora e o minuto em que uma captura instantânea deve ser tirada. O padrão é a hora e o minuto atuais.
     • Especifique o número de capturas instantâneas por hora a serem retidas antes que a mais antiga seja descartada.
   • Semanalmente
     • Especifique o dia da semana, a hora e o minuto em que uma captura instantânea deve ser tirada. O padrão é o dia, a hora e o minuto atuais.
     • Especifique o número de instantâneos semanais a serem mantidos antes que o mais antigo seja descartado.
4. Clique em Salvar. Se o número total de capturas instantâneas programadas exceder 50, você receberá uma mensagem de aviso e não poderá salvar.

A lista de capturas instantâneas é exibida conforme obtida na seção Capturas instantâneas da página Detalhe.

Adicionar uma programação de instantâneos pela CLI

Você pode definir com que frequência e quando deseja criar uma cópia de referência do seu volume de armazenamento por meio das programações de Snapshot. É possível ter um máximo de 50 capturas instantâneas por volume de armazenamento.

Para poder configurar seu planejamento inicial, deve-se primeiramente comprar um espaço de captura instantânea, caso você não tenha comprado durante o fornecimento inicial do volume de armazenamento.

Antes de iniciar, decida sobre o cliente CLI que deseja usar.

• É possível instalar a IBM Cloud e instalar o plug-in do SL com ibmcloud plugin install sl Para obter mais informações, consulte Estendendo IBM Cloud CLI com plug-ins.
• Ou é possível instalar o SLCLI.

$ ibmcloud sl file snapshot-enable 560156918 -s WEEKLY -c 5 -m 0 --hour 2 -d 0
OK
WEEKLY snapshots have been enabled for volume 560156918.

$ slcli file snapshot-enable --help
Usage: slcli file snapshot-enable [OPTIONS] VOLUME_ID

  Enables snapshots for a given volume on the specified schedule

Options:
  --schedule-type TEXT    Snapshot schedule [INTERVAL|HOURLY|DAILY|WEEKLY]
                          [required]
  --retention-count TEXT  Number of snapshots to retain  [required]
  --minute INTEGER        Minute of the day when snapshots should be taken
  --hour INTEGER          Hour of the day when snapshots should be taken
  --day-of-week TEXT      Day of the week when snapshots should be taken
  -h, --help              Show this message and exit.

$ slcli file snapshot-schedule-list --help
Usage: slcli file snapshot-schedule-list [OPTIONS] VOLUME_ID

  Lists snapshot schedules for a given volume

Options:
  -h, --help  Show this message and exit.

Gerenciamento de uma agenda de instantâneos com a API

Você pode definir com que frequência e quando deseja criar uma cópia de referência do seu volume de armazenamento por meio das programações de Snapshot. É possível ter um máximo de 50 capturas instantâneas por volume de armazenamento.

Para poder configurar seu planejamento inicial, deve-se primeiramente comprar um espaço de captura instantânea, caso você não tenha comprado durante o fornecimento inicial do volume de armazenamento.

Você pode usar o método enable_snapshots no File Storage Manager da API Python Client para adicionar um agendamento de instantâneos ao seu volume. É necessário especificar os seguintes parâmetros:

• volume_id (número inteiro)- A ID do volume
• schedule_type (string)- HOURLY,DAILY, ou WEEKLY
• retention_count (inteiro)- Número de instantâneos a serem mantidos
• minute (número inteiro)- Minuto em que o instantâneo deve ser tirado
• hour (número inteiro)- Hora em que o instantâneo deve ser tirado
• day_of_week (string)- Dia em que o instantâneo deve ser tirado

Uma chamada de API bem-sucedida retorna se o instantâneo foi agendado com êxito ou não.

Quando você quiser desativar uma programação, use o método disable_snapshots. Especifique o endereço volume_id e a programação (HOURLY,DAILY ou WEEKLY) que você deseja desativar.

Gerenciando um planejamento de captura instantânea com o Terraform

Para configurar um planejamento de captura instantânea, use o recurso ibm_storage_file e especifique informações no argumento snapshot_schedule. O exemplo a seguir define dois planejamentos diferentes. Um planejamento é para capturas instantâneas semanais que são feitas aos domingos às 13h20. 20 capturas instantâneas são mantidas antes que a mais antiga seja excluída para criar espaço para uma nova. O segundo planejamento é para capturas instantâneas por hora.

resource "ibm_storage_file" "fs_endurance" {
  type       = "Endurance"
  datacenter = "dal09"
  capacity   = 20
  iops       = 0.25

  # Optional fields
  allowed_virtual_guest_ids = ["28961689"]
  allowed_subnets           = ["10.146.139.64/26"]
  allowed_ip_addresses      = ["10.146.139.84"]
  snapshot_capacity         = 10
  hourly_billing            = true

  # Optional fields for snapshot
  snapshot_schedule {
    schedule_type   = "WEEKLY"
    retention_count = 20
    minute          = 20
    hour            = 13
    day_of_week     = "SUNDAY"
    enable          = true
  }
  snapshot_schedule {
    schedule_type   = "HOURLY"
    retention_count = 20
    minute          = 2
    enable          = true
  }

}

Se você desejar atualizar o planejamento, altere esses valores e aplique-os a seus recursos Se desejar excluir o planejamento, remova seus detalhes da definição de recurso ibm_storage_file e aplique suas mudanças.

Para obter mais informações sobre argumentos e atributos, consulte ibm_storage_file.

Como criar um instantâneo manualmente no console

Capturas instantâneas manuais podem ser obtidas em vários pontos durante um upgrade ou manutenção do aplicativo. Também é possível tirar capturas instantâneas em múltiplos servidores que tenham sido desativados temporariamente no nível do aplicativo.

O limite máximo de capturas instantâneas manuais por volume de armazenamento é 50.

1. Clique em seu volume de armazenamento.
2. Clique em Ações .
3. Clique em Tomar captura instantânea manual.

A captura instantânea é tomada e exibida na seção Capturas instantâneas da página Detalhe. Seu planejamento aparece Manual.

Como criar um snapshot manualmente pela CLI

Capturas instantâneas manuais podem ser obtidas em vários pontos durante um upgrade ou manutenção do aplicativo. Também é possível tirar capturas instantâneas em múltiplos servidores que tenham sido desativados temporariamente no nível do aplicativo.

O limite máximo de capturas instantâneas manuais por volume de armazenamento é 50.

ibmcloud sl file snapshot-create 12345678

$ slcli file snapshot-create --help
Usage: slcli file snapshot-create [OPTIONS] VOLUME_ID

Options:
  -n, --notes TEXT  Notes to set on the new snapshot
  -h, --help        Show this message and exit.

Obtenção de um instantâneo manual com a API

Capturas instantâneas manuais podem ser obtidas em vários pontos durante um upgrade ou manutenção do aplicativo. Também é possível tirar capturas instantâneas em múltiplos servidores que tenham sido desativados temporariamente no nível do aplicativo.

O limite máximo de capturas instantâneas manuais por volume de armazenamento é 50.

Você pode usar o método create_snapshot no cliente da API Python para criar um instantâneo sob demanda. Especifique o endereço volume_id e um nome para seu snapshot, adicionando-o como notes. Uma chamada de API bem-sucedida retorna a ID do novo instantâneo.

Listar todos os instantâneos com informações de uso e funções de gerenciamento no console

A lista de instantâneos retidos e o espaço que eles ocupam podem ser consultados na página de detalhes do File Storage for Classic. As funções de gerenciamento (planejamentos de edição e inclusão de mais espaço) são realizadas na página Detalhes do File Storage for Classic usando o menu Ações ou os links nas várias seções da página. A página Captura instantânea exibe quanta capacidade o volume tem e quanto dele é usado.

Você recebe notificações quando atinge os limites de espaço – 75%, 90% e 95%.

• No endereço 75% da capacidade, é exibido um aviso informando que o uso de espaço dos snapshots ultrapassou 75%. Para corrigir essa situação, é possível incluir ou excluir manualmente capturas instantâneas desnecessárias retidas. É possível reduzir o número de capturas instantâneas retidas no planejamento Se você reduzir os dados do instantâneo ou aumentar o espaço, o sistema de aviso será reiniciado e não ocorrerá nenhuma exclusão automática.
• No site 90% da capacidade, é enviado um segundo aviso quando o uso do espaço de snapshots ultrapassa 90%. Assim como quando se atinge 75% da capacidade, se você tomar as medidas necessárias para reduzir os dados dos snapshots ou aumentar o espaço, o sistema de alertas é reiniciado e não ocorre a exclusão automática.
• No site 95% da capacidade, é enviado um aviso final. Se nenhuma medida for tomada para reduzir seu uso de espaço para abaixo do limite, a exclusão automática inicia para que capturas instantâneas futuras possam ser criadas Os instantâneos programados são excluídos, começando pelos mais antigos, até que o uso caia para menos de 95%. Os instantâneos continuam sendo excluídos sempre que o uso ultrapassar 95%, até que o nível caia abaixo do limite. Se o espaço for aumentado manualmente ou se os instantâneos forem excluídos manualmente, o aviso será reinicializado e reemitido caso o limite seja excedido novamente. Se nenhuma ação for executada, essa notificação será o único aviso que você receberá.

Por padrão, as notificações de aviso de captura instantânea são ativadas para cada cliente. No entanto, é possível optar por desativá-las. Quando esse recurso é desativado, todas as gerações de chamados e notificações são paradas. Você pode desativar e ativar notificações para o volume a qualquer momento a partir da CLI.

Se o uso de espaço das instantâneas aumentar muito rapidamente, você poderá receber uma notificação antes que ocorra a exclusão automática da instantânea mais antiga programada. Por exemplo, se o uso passar de 76% para 96% em 15 minutos, você receberá uma notificação sobre a ultrapassagem de 75% e outra sobre a ultrapassagem de 95%.

Listar todos os instantâneos com informações de uso e funções de gerenciamento a partir da CLI

ibmcloud sl file snapshot-list 12345678 --sortby id

$ slcli file snapshot-list --help
Usage: slcli file snapshot-list [OPTIONS] VOLUME_ID

Options:
  --sortby TEXT   Column to sort by
  --columns TEXT  Columns to display. Options: id, name, created, size_bytes
  -h, --help      Show this message and exit.

Verificando o status das notificações pela CLI

São enviadas notificações quando você atinge três limites diferentes de espaço: 75%, 90% e 95%.

• No endereço 75% da capacidade, é exibido um aviso informando que o uso de espaço dos snapshots ultrapassou 75%. Para corrigir essa situação, é possível incluir ou excluir manualmente capturas instantâneas desnecessárias retidas. É possível reduzir o número de capturas instantâneas retidas no planejamento Se você reduzir os dados do instantâneo ou aumentar o espaço, o sistema de aviso será reiniciado e não ocorrerá nenhuma exclusão automática.
• No site 90% da capacidade, é enviado um segundo aviso quando o uso do espaço de snapshots ultrapassa 90%. Assim como quando se atinge 75% da capacidade, se você tomar as medidas necessárias para reduzir os dados dos snapshots ou aumentar o espaço, o sistema de alertas é reiniciado e não ocorre a exclusão automática.
• No site 95% da capacidade, é enviado um aviso final. Se nenhuma medida for tomada para reduzir seu uso de espaço para abaixo do limite, a exclusão automática inicia para que capturas instantâneas futuras possam ser criadas Os instantâneos programados são excluídos, começando pelos mais antigos, até que o uso caia para menos de 95%. Os instantâneos continuam sendo excluídos sempre que o uso ultrapassar 95%, até que o nível caia abaixo do limite. Se o espaço for aumentado manualmente ou se os instantâneos forem excluídos manualmente, o aviso será reinicializado e reemitido caso o limite seja excedido novamente. Se nenhuma ação for executada, essa notificação será o único aviso que você receberá.

Se o uso de espaço das instantâneas aumentar muito rapidamente, você poderá receber uma notificação antes que ocorra a exclusão automática da instantânea mais antiga programada. Por exemplo, se o uso passar de 76% para 96% em 15 minutos, você receberá uma notificação sobre a ultrapassagem de 75% e outra sobre a ultrapassagem de 95%. O sistema ignora o aviso da ultrapassagem de 90%.

Por padrão, as notificações de aviso de captura instantânea são ativadas para cada cliente. No entanto, é possível optar por desativá-las. Quando esse recurso é desativado, todas as gerações de chamados e notificações são paradas. É possível desativar e ativar as notificações para o volume a qualquer momento.

ibmcloud sl file snapshot-get-notification-status 12345678

ibmcloud sl file snapshot-set-notification 12345678 --disable

$ slcli file snapshot-get-notification-status
Usage: slcli file snapshot-get-notification-status [OPTIONS] VOLUME_ID
  Get snapshots space usage threshold warning flag setting for a given volume

Options:
  -h, --help  Show this message and exit.

$ slcli file snapshot-set-notification VOLUME_ID
Usage: slcli file snapshot-set-notification VOLUME_ID [OPTIONS]

Options:
 --disable  Disable snapshot threshold warning notification for the storage volume
 --enable   Enable snapshot threshold warning notification for the storage volume
 -h, --help  Show this message and exit.

Verificar o status da notificação com a API

São enviadas notificações quando você atinge três limites diferentes de espaço: 75%, 90% e 95%.

• No endereço 75% da capacidade, é exibido um aviso informando que o uso de espaço dos snapshots ultrapassou 75%. Para corrigir essa situação, é possível incluir ou excluir manualmente capturas instantâneas desnecessárias retidas. É possível reduzir o número de capturas instantâneas retidas no planejamento Se você reduzir os dados do instantâneo ou aumentar o espaço, o sistema de aviso será reiniciado e não ocorrerá nenhuma exclusão automática.
• No site 90% da capacidade, é enviado um segundo aviso quando o uso do espaço de snapshots ultrapassa 90%. Assim como quando se atinge 75% da capacidade, se você tomar as medidas necessárias para reduzir os dados dos snapshots ou aumentar o espaço, o sistema de alertas é reiniciado e não ocorre a exclusão automática.
• No site 95% da capacidade, é enviado um aviso final. Se nenhuma medida for tomada para reduzir seu uso de espaço para abaixo do limite, a exclusão automática inicia para que capturas instantâneas futuras possam ser criadas Os instantâneos programados são excluídos, começando pelos mais antigos, até que o uso caia para menos de 95%. Os instantâneos continuam sendo excluídos sempre que o uso ultrapassar 95%, até que o nível caia abaixo do limite. Se o espaço for aumentado manualmente ou se os instantâneos forem excluídos manualmente, o aviso será reinicializado e reemitido caso o limite seja excedido novamente. Se nenhuma ação for executada, essa notificação será o único aviso que você receberá.

Se o uso de espaço das instantâneas aumentar muito rapidamente, você poderá receber uma notificação antes que ocorra a exclusão automática da instantânea mais antiga programada. Por exemplo, se o uso passar de 76% para 96% em 15 minutos, você receberá uma notificação sobre a ultrapassagem de 75% e outra sobre a ultrapassagem de 95%. O sistema ignora o aviso da ultrapassagem de 90%.

Por padrão, as notificações de aviso de captura instantânea são ativadas para cada cliente. No entanto, é possível optar por desativá-las. Quando esse recurso é desativado, todas as gerações de chamados e notificações são paradas. É possível desativar e ativar as notificações para o volume a qualquer momento.

Para verificar se as notificações estão ativadas, use o método get_volume_snapshot_notification_status no cliente da API Python. Especifique o endereço volume_id. A resposta bem-sucedida indica se o aviso de limite de uso de espaço do instantâneo está ativado ou desativado.

Aumentar o espaço de Snapshot de um volume no console

Talvez seja necessário incluir espaço de captura instantânea em um volume que não tinha nenhum anteriormente ou que pode requerer espaço de captura instantânea extra.

O espaço de captura instantânea pode ser aumentado. Não pode ser reduzido. É possível selecionar uma quantia menor de espaço até que você determine o espaço de que precisa.

O espaço de captura instantânea é aumentado por meio de Armazenamento > File Storage for Classic.

1. Clique em seu volume de armazenamento, clique em Ações e clique em Mudar espaço de captura instantânea.
2. Selecione em um intervalo de tamanhos no prompt. Para obter mais informações sobre as alocações de capacidade de captura instantânea disponíveis, consulte Pedindo capturas instantâneas.
3. Clique em Continuar.
4. Insira qualquer Código promocional que você tiver e clique em Recalcular. Os campos Encargos para este pedido e Revisão do pedido são concluídos por padrão.
5. Leia o contrato de prestação de serviços e, se concordar com os termos, marque a caixa de seleção e clique em “Fazer pedido ”. Seu espaço de captura instantânea adicional é provisionado em alguns minutos.

Excluindo uma programação de instantâneos no console

Planejamentos de captura instantânea podem ser excluídos por meio de Armazenamento > File Storage for Classic.

1. Clique no ID do volume para exibir as informações relacionadas.
2. Clique em Capturas instantâneas.
3. Clique no planejamento a ser excluído no quadro Planejamentos de captura instantânea.
4. Marque a caixa de seleção ao lado da programação a ser excluída e clique em Salvar.

Se você estiver usando o recurso de replicação, assegure-se de que o planejamento que está excluindo não seja o planejamento usado pela replicação. Para obter mais informações sobre como excluir um planejamento de replicação, consulte aqui.

Excluindo uma programação de instantâneos pela CLI

Se você estiver usando o recurso de replicação, certifique-se de que a programação que você está excluindo não seja a mesma utilizada pela replicação. Para obter mais informações sobre como excluir um planejamento de replicação, consulte aqui.

ibmcloud sl file snapshot-disable 12345678 -s DAILY

$ slcli file snapshot-disable --help
Usage: slcli file snapshot-disable [OPTIONS] VOLUME_ID

  Disables snapshots on the specified schedule for a given volume

Options:
  --schedule-type TEXT  Snapshot schedule [INTERVAL|HOURLY|DAILY|WEEKLY]
                        [required]
  -h, --help            Show this message and exit.

Excluindo um instantâneo no console

As capturas instantâneas que não são mais necessárias podem ser removidas manualmente para liberar espaço para capturas instantâneas futuras. A exclusão é feita por meio de Armazenamento > File Storage for Classic.

1. Clique em seu volume de armazenamento e clique em Captura instantânea para ver a lista de capturas instantâneas existentes.
2. Clique em “ Ações ” ao lado de um snapshot específico e clique em “ Excluir ” para excluir o snapshot. Esta exclusão não afeta nenhum futuro ou snapshots passados no mesmo planejamento que snapshots não dependem um do outro.

Os instantâneos manuais que não são excluídos manualmente no portal são automaticamente excluídos quando você tira outro instantâneo, se o limite de espaço for atingido. A captura instantânea mais antiga é excluída primeiro.

Excluindo um snapshot pela CLI

As capturas instantâneas que não são mais necessárias podem ser removidas manualmente para liberar espaço para capturas instantâneas futuras.

As capturas instantâneas manuais que não são excluídas no portal manualmente são excluídas automaticamente quando você atinge as limitações de espaço. A captura instantânea mais antiga é excluída primeiro.

ibmcloud sl file snapshot-delete 12345678

$ slcli file snapshot-delete --help
Usage: slcli file snapshot-delete [OPTIONS] SNAPSHOT_ID

Options:
  -h, --help  Show this message and exit.

Excluindo um snapshot com a API

Para excluir um instantâneo com a API, use o método delete_snapshot. Especifique a ID do snapshot no parâmetro snapshot_id.

Excluindo uma captura instantânea com Terraform

Use o comando terraform destroy para remover de forma conveniente um objeto remoto, como um snapshot. O exemplo a seguir exclui o snapshot identificado por seu ID ibm_file_share_snapshot.example.id.

terraform destroy --target ibm_file_share_snapshot.example.id

Para obter mais informações, consulte terraform destroy

Restaurar o volume de armazenamento para um momento específico usando um instantâneo no console

Talvez seja necessário retornar o seu volume de armazenamento para um momento específico devido a um erro do usuário ou uma corrupção de dados.

1. Desmonte e separe seu volume de armazenamento do host.

   Para obter mais informações sobre montagem e desmontagem do armazenamento, consulte Conectando seu novo armazenamento.

2. Vá para o IBM Cloud® console. No menu, selecione " Infraestrutura, " > " Infraestrutura clássica.

3. Clique em Armazenamento, File Storage for Classic.

4. Role na lista e clique no volume a ser restaurado. A página Capturas instantâneas exibe a lista de todas as capturas instantâneas salvas junto com seu tamanho e data de criação.

5. Ao lado do snapshot que você deseja usar, clique em Actions! Ícone Actions(Ações) ) e clique em Restore (Restaurar ).

   A conclusão da restauração resulta na perda dos dados que foram criados ou modificados depois que a captura instantânea foi obtida. Essa perda de dados ocorre porque o seu volume de armazenamento retorna para o mesmo estado em que ele estava na hora da captura instantânea.

6. Clique em ** Sim ** para iniciar a restauração. A restauração vai demorar um pouco e o seu compartilhamento de arquivos é bloqueado durante a restauração.

   Ao retornar à lista de compartilhamentos de arquivos, um ícone de relógio aparecerá ao lado do seu volume, indicando que uma transação está em andamento. Passar o mouse sobre o ícone produz uma janela que mostra a transação. O ícone desaparece quando a transação está concluída.

7. Monte e reconecte seu volume de armazenamento ao host.

   • Para obter mais informações sobre montagem e desmontagem do armazenamento, consulte Conectando seu novo armazenamento.

   A restauração de um volume resulta na exclusão de todas as capturas instantâneas que foram obtidas após a captura instantânea que foi usada para a restauração.

Restaurar o volume de armazenamento para um momento específico usando um snapshot pela CLI

Talvez seja necessário retornar o seu volume de armazenamento para um momento específico devido a um erro do usuário ou uma corrupção de dados.

1. Primeiro, desmonte o volume.
2. Em seguida, você pode restaurar o volume usando um snapshot pela CLI.
3. Por último, monte e reconecte o seu volume de armazenamento ao host.

Para obter mais informações sobre montagem e desmontagem do armazenamento, consulte Conectando seu novo armazenamento.

A restauração de um volume resulta na exclusão de todas as capturas instantâneas que foram obtidas após a captura instantânea que foi usada para a restauração.

ibmcloud sl file snapshot-restore 12345678 87654321

$ slcli file snapshot-restore --help
Usage: slcli file snapshot-restore [OPTIONS] VOLUME_ID

Options:
  -s, --snapshot-id TEXT  The id of the snapshot which will be used to restore
                          the block volume
  -h, --help              Show this message and exit.