Criação de uma cópia de um volume específico no console

1. Acesse a sua lista de File Storage for Classic. No menu Infrastructure Classic Infrastructure, clique em Storage File Storage for Classic.

2. Localize e clique no nome do volume.

3. Clique em Ações > Compartilhar Compartilhar.

4. Selecione se a duplicata é para ser dependente ou independente.

5. Escolha sua opção de captura instantânea.

   • Crie agora um instantâneo com os dados mais recentes.
   • Use o último instantâneo que foi tomado anteriormente.

6. A localização e o Perfil das IOPS permanecem iguais ao volume original.

7. É possível escolher provisionar o volume duplicado com método de faturamento por hora ou mensal. O tipo de faturamento para o volume original é selecionado automaticamente e será possível mudá-lo se você desejar.

8. Será possível especificar IOPS ou Camada de IOPS diferentes para o novo volume se você desejar. A designação de IOPS do volume original é configurada por padrão. As combinações de desempenho e tamanho disponíveis são exibidas.

   • Se o seu volume original for a camada 0,25 IOPS Endurance, não será possível fazer uma nova seleção.
   • Se seu volume original for a camada de 2, 4 ou 10 IOPS do Endurance, será possível se mover em qualquer lugar entre essas camadas para o novo volume.

9. É possível atualizar o tamanho do novo volume para que seja maior que o do original. O tamanho do volume original é configurado por padrão.

   O File Storage for Classic pode ser redimensionado para 10 vezes o tamanho original do volume.

10. É possível atualizar o espaço de captura instantânea do novo volume para incluir mais, menos ou nenhum espaço de captura instantânea. O espaço de captura instantânea do volume original é configurado por padrão.

11. Marque a caixa para confirmar que você leu e concordou com os termos, em seguida, clique em Criar para fazer o seu pedido.

Depois de clicar em Criar, aparece a janela de confirmação do pedido. Ao fechar a janela, você volta para a lista de recursos. Você pode voltar para a sua lista de compartilhamentos File Storage for Classic para clicar na duplicata recém-provisionada. A seção de detalhes do compartilhamento exibe informações como Duplicate Type, um link para a página de detalhes do pai share e o nome do instantâneo que foi usado para criar a duplicata.

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 file 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 file volume-list --order 110554892' to find this file volume after it is ready.

$ ibmcloud sl file 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_file_storage   500           -            -      fsf-dal0902b-fz.service.softlayer.com   -       1                     0                   -

$ ibmcloud sl file 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 file volume-list --order 110553472' to find this file volume after it is ready.

$ slcli file volume-duplicate --help
Usage: slcli file 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 file 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 file 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 file volume-duplicate --dependent-duplicate TRUE <primary-vol-id>

Criando um compartilhamento duplicado com a API

Para pedir um volume duplicado independente Block Storage for Classic com a API, é possível fazer uma chamada POST /SoftLayer_Product_Order/placeOrder. O exemplo de API REST a seguir cria uma duplicata independente para um volume de Endurance (camadas IOPS).

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": 1,
       "prices": [{"id": 12207}, {"id": 10723}, {"id": 10413}, {"id": 15749}, {"id":14043}],
       "quantity": 1,
       "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":<PrimaryId>,
       "isDependentDuplicateFlag": 1,
       "prices": [{"id": 15751}, {"id": 19487}, {"id": 18983}, {"id": 15749}, {"id":14043}],
       "quantity": 1,
       "iops":456,
       "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. Acesse a sua lista de File Storage for Classic. No menu Infrastructure Classic Infrastructure, clique em Storage File 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 desejar forçar a parada de um processo de atualização atual, 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. Acesse a sua lista de File Storage for Classic. No menu Infrastructure Classic Infrastructure, clique em Storage File 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 envolve obter uma captura instantânea do volume primário e, em seguida, atualizar o volume duplicado usando essa captura instantânea.

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 não está disponível e deve ser remontado após a atualização ser concluída.

O processo de atualização pode ser demorado. Se você descobrir que tem novos dados que deseja copiar para o volume duplicado independente, você pode emitir o comando file 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.

$ ibmcloud sl file snapshot-create 560391190
OK
New snapshot 560391944 was created.
$ ibmcloud sl file volume-refresh 560391814 560391944
OK

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

Convertendo um volume dependente para uma duplicata independente da CLI

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 “ File Storage for Classic ” por meio da CLI.

$ ibmcloud sl file volume-convert 560391814
OK

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

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

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

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 fica desativado e deve ser remontado após a conclusão da atualização.

O processo de atualização pode ser demorado. Você pode achar que tem novos dados que deseja incluir na duplicata antes que a atualização em execução seja concluída Se esse for o caso, será possível fazer uma segunda chamada para refreshDuplicate e especificar o segundo parâmetro forceRefresh como true para parar todas as transações de atualização em andamento e pendentes e iniciar uma nova atualização Se o segundo parâmetro for configurado como false, ou não for especificado, a chamada falhará se outra atualização já estiver em andamento

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

   {
    "parameters": [primaryVolumeSnapshotId, true OR false]
   }

   <?xml version="1.0" encoding="UTF-8"?>
   <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://api.service.softlayer.com/soap/v3.1/">
   <SOAP-ENV:Header>
    <ns1:authenticate>
     <username>USERNAME</username>
     <apiKey>APIKEY</apiKey>
    </ns1:authenticate>
    <ns2:SoftLayer_Network_StorageInitParameters>
     <id>duplicate Volume Id</id>
    </ns2:SoftLayer_Network_StorageInitParameters>
   </SOAP-ENV:Header>
   <SOAP-ENV:Body>
    <ns1:refreshDuplicate>
      <snapshotId xsi:type="int">primary Volume Snapshot Id</snapshotId>
      <forceRefresh xsi:type="boolean">true</forceRefresh> <-- (remove this tag for normal refresh)
    </ns1:refreshDuplicate>
   </SOAP-ENV:Body>
   </SOAP-ENV:Envelope>

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