Criação de um volume duplicado no console

Você pode criar volume duplicado a partir da CLI e no IBM Cloud console de duas maneiras.

Criação de uma duplicata pela CLI

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 block volume-duplicate 560382016
This action will incur charges on your account. Continue?> y
OK
Order 110554892 was placed.
 > Storage as a Service
 > File Storage
 > 500 GBs
 > 4 IOPS per GB
 > 500 GB (Snapshot Space)
You may run 'ibmcloud sl block volume-list --order 110554892' to find this block volume after it is ready.

$ ibmcloud sl block volume-list --order 110554892
id          username             datacenter   storage_type             capacity_gb   bytes_used   IOPs   ip_addr                                 lunId   active_transactions   rep_partner_count   notes
560391190   SL02SEV1414935_269   dal09        endurance_block_storage   500           -            -      fsf-dal0902b-fz.service.softlayer.com   -       1                     0                   -

$ ibmcloud sl block volume-duplicate 560391190 --dependent-duplicate
This action will incur charges on your account. Continue?> y
OK
Order 110553472 was placed.
 > Storage as a Service
 > File Storage
 > 500 GBs
 > 4 IOPS per GB
 > 500 GB (Snapshot Space)
You may run 'ibmcloud sl block volume-list --order 110553472' to find this block volume after it is ready.

$ slcli block volume-duplicate --help
Usage: slcli block volume-duplicate [OPTIONS] ORIGIN_VOLUME_ID
Options:
  -o, --origin-snapshot-id INTEGER
                                  ID of an origin volume snapshot to use for
                                  duplcation.
  -c, --duplicate-size INTEGER    Size of duplicate block volume in GB. ***If
                                  no size is specified, the size of the origin
                                  volume will be used.***
                                  Minimum: [the size
                                  of the origin volume]
  -i, --duplicate-iops INTEGER    Performance Storage IOPS, between 100 and
                                  6000 in multiples of 100 [only used for
                                  performance volumes] ***If no IOPS value is
                                  specified, the IOPS value of the origin
                                  volume will be used.***
                                  Requirements: [If
                                  IOPS/GB for the origin volume is less than
                                  0.3, IOPS/GB for the duplicate must also be
                                  less than 0.3. If IOPS/GB for the origin
                                  volume is greater than or equal to 0.3,
                                  IOPS/GB for the duplicate must also be
                                  greater than or equal to 0.3.]
  -t, --duplicate-tier [0.25|2|4|10]
                                  Endurance Storage Tier (IOPS per GB) [only
                                  used for endurance volumes] ***If no tier is
                                  specified, the tier of the origin volume
                                  will be used.***
                                  Requirements: [If IOPS/GB
                                  for the origin volume is 0.25, IOPS/GB for
                                  the duplicate must also be 0.25. If IOPS/GB
                                  for the origin volume is greater than 0.25,
                                  IOPS/GB for the duplicate must also be
                                  greater than 0.25.]
  -s, --duplicate-snapshot-size INTEGER
                                  The size of snapshot space to order for the
                                  duplicate. ***If no snapshot space size is
                                  specified, the snapshot space size of the
                                  origin block volume will be used.***
                                  Input
                                  "0" for this parameter to order a duplicate
                                  volume with no snapshot space.
  --billing [hourly|monthly]      Optional parameter for Billing rate (default
                                  to monthly)
  -h, --help                      Show this message and exit.

slcli block volume-duplicate --dependent-duplicate TRUE ORIGIN_VOLUME_ID

Criação de um volume duplicado com a API

Para solicitar um volume duplicado independente Block Storage for Classic com a API, você pode fazer uma chamada POST para a API do SL. O exemplo de API REST a seguir cria uma duplicata independente para um volume Endurance (camadas IOPS), que é identificado pelo seu ID de volume na duplicateOriginVolumeId propriedade.

• URL - https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder
• Tipo-POST
• Corpo da solicitação-

  {
      "parameters":[{
      "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
      "packageId": 531,
      "duplicateOriginVolumeId":<PrimaryId>,
      "isDependentDuplicateFlag": 0,
      "prices": [{"id": 19497}, {"id": 16479}, {"id": 12931}, {"id": 15749}, {"id":10407}],
      "quantity": 1,
      "osFormatType":{
       "keyName": "LINUX"
      },
      "location": 2,
      "volumeSize":23
      }]
  }
  

  Se você tiver um snapshot específico que contenha os dados que deseja usar para criar o volume duplicado, especifique o ID do snapshot na propriedade duplicateOriginSnapshotId.

Para pedir uma duplicata dependente para um volume de Desempenho (IOPS customizado), faça uma chamada POST /SoftLayer_Product_Order/placeOrder como o exemplo da API de REST a seguir:

• URL - https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder
• Tipo-POST
• Corpo da solicitação-

  {
      "parameters":[{
      "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
      "packageId": 531,
      "duplicateOriginVolumeId":1327277,
      "isDependentDuplicateFlag": 1,
      "prices": [{"id": 15751}, {"id": 19487}, {"id": 18983}, {"id": 15749}, {"id":10407}],
      "quantity": 1,
      "iops":454,
      "osFormatType":{
          "keyName": "LINUX"
      },
      "location": 2,
      "volumeSize":23
      }]
  }
  

  Se você tiver um snapshot específico que contenha os dados que deseja usar para criar o volume duplicado, especifique o ID do snapshot na propriedade duplicateOriginSnapshotId.

Para obter mais informações sobre a API e as opções, consulte a Referência da API Procure o SoftLayer_Container_Product_Order_Network_Storage_AsAService tipo de dados.

Atualizando dados na duplicata do volume pai no console

Conforme o tempo passa e o volume primário muda, o volume duplicado pode ser atualizado com essas mudanças para refletir o estado atual por meio da ação de atualização. A atualização consiste em criar um instantâneo do volume primário e, em seguida, atualizar o volume duplicado utilizando os dados desse instantâneo.

Se o volume duplicado for independente, será possível parar uma operação de atualização em execução e iniciar uma nova..

1. Vá para sua lista de Block Storage for Classic no IBM Cloud no console, clicando em Infrastructure > Classic Infrastructure > Storage > Block Storage for Classic.

2. Localize o volume duplicado e clique em seu nome para visualizar os detalhes do volume.

3. Clique em Ações > Restaurar snapshot pai.

4. Na lista de capturas instantâneas, selecione a captura instantânea pai que contém os dados que deseja restaurar para o volume duplicado. Se o volume duplicado que você está atualizando for um volume independente, será possível parar uma operação em execução e forçar uma nova restauração para iniciar. Se você desejar forçar qualquer processo de atualização atual a parar, marque a caixa antes de continuar

   A restauração de dados a partir de um snapshot resulta na perda de todos os dados criados ou modificados desde que o snapshot selecionado foi gerado. Durante a transação de atualização, o volume duplicado é desativado e deve ser remontado após a conclusão da atualização.

5. Clique em “Sim” para iniciar a atualização. A atualização pode demorar um pouco para ser concluída. A barra de status mostra a porcentagem dos dados copiados para o volume. Para ver status atualizado, atualize a página no navegador.

Convertendo um volume dependente em uma duplicata independente no console

1. Vá para sua lista de Block Storage for Classic no IBM Cloud no console, clicando em Infrastructure > Classic Infrastructure > Storage > Block Storage for Classic.
2. Localize o volume duplicado e clique em seu nome para visualizar os detalhes do volume.
3. Clique em Ações > Converter Duplicata Dependente.
4. Marque a caixa para confirmar que deseja prosseguir com a conversão.
5. Clique em Sim.

O processo de conversão pode demorar algum tempo para ser concluído. Quanto maior for o volume, mais demorado é necessário para converdá-lo. Você pode visualizar o status do processo na página de detalhes do volume sob o cabeçalho Duplicate conversion status.

Atualização de dados na duplicata a partir do volume pai da CLI

Conforme o tempo passa e o volume primário muda, o volume duplicado pode ser atualizado com essas mudanças para refletir o estado atual por meio da ação de atualização. A atualização consiste em criar um instantâneo do volume primário e, em seguida, atualizar o volume duplicado utilizando os dados desse instantâneo.

É possível iniciar as atualizações usando o comando a seguir.

slcli block volume-refresh <duplicate-vol-id> <primary-snapshot-id>

Uma atualização não incorre em tempo de inatividade no volume primário. No entanto, durante a transação de atualização, o volume duplicado é desativado e deve ser remontado após a conclusão da atualização.

O processo de atualização pode ser demorado. Se você achar que possui novos dados que deseja copiar para o volume duplicado independente, será possível emitir o comando slcli block volume-refresh com a opção --force-refresh para parar todas as transações de atualização em andamento e pendentes e iniciar uma nova atualização

O processo de atualização da força funciona apenas em volumes independentes.

Para obter mais informações sobre opções de comando disponíveis, consulte slcli block volume-refresh.

Convertendo um volume dependente para uma duplicata independente da CLI

Se você desejar usar o volume dependente como um volume independente no futuro, será possível convertê-lo para um volume normal e independente do IBM Cloud® Block Storage for Classic por meio da SLCLI. Use o comando abaixo.

slcli block volume-convert <dependent-vol-id>

O processo de conversão pode demorar algum tempo para ser concluído. Quanto maior for o volume, mais demorado é necessário para converdá-lo. Use o comando a seguir para verificar o andamento.

slcli block duplicate-convert-status <dependent-vol-id>

O exemplo a seguir mostra a saída que você pode esperar.

slcli block duplicate-convert-status 370597202
Username            Active Conversion Start Timestamp   Completed Percentage
SL02SEVC307608_74   2022-06-13 14:59:17                 90

Para obter mais informações sobre opções de comando disponíveis, consulte duplicate-convert-status.

Atualizando dados na duplicata do volume pai com a API

Conforme o tempo passa e o volume primário muda, o volume duplicado pode ser atualizado com essas mudanças para refletir o estado atual por meio da ação de atualização. A atualização consiste em criar um instantâneo do volume primário e, em seguida, atualizar o volume duplicado utilizando os dados desse instantâneo.

Uma atualização não incorre em tempo de inatividade no volume primário. No entanto, durante a transação de atualização, o volume duplicado é desativado e deve ser remontado após a conclusão da atualização.

O processo de atualização pode ser demorado. Para adicionar novos dados à duplicata antes do término da atualização em execução, faça uma segunda chamada para refreshDuplicate com o parâmetro forceRefresh definido como true. Isso interrompe todas as transações de atualização em andamento e pendentes e inicia uma nova atualização. Se o parâmetro for definido como false ou não for especificado, a chamada falhará quando outra atualização estiver em andamento.

O processo de atualização da força funciona apenas em volumes independentes.

Convertendo um volume dependente em uma duplicata independente com a API

Se você quiser usar o volume dependente como um volume autônomo no futuro, poderá convertê-lo em um volume normal e independente do tipo “ IBM Cloud® Block Storage for Classic ” por meio da API. Veja o exemplo a seguir, que utiliza a API REST.

• URL - https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/<storageId>/convertCloneDependentToIndependent
• Tipo-POST
• Corpo da solicitação-em branco

Para obter mais informações sobre a API e as opções, consulte a Referência da API