Créer une copie d'un volume spécifique dans la console

1. Accédez à votre liste de File Storage for Classic. Dans le menu Infrastructure > Infrastructure classique, cliquez sur Stockage > File Storage for Classic.

2. Recherchez le nom du volume et cliquez dessus.

3. Cliquez sur Actions > Dupliquer le partage.

4. Indiquez si le doublon doit être dépendant ou indépendant.

5. Sélectionnez une option d'image instantanée.

   • Créez dès maintenant un instantané contenant les données les plus récentes.
   • Utilisez la dernière image instantanée prise précédemment.

6. L'emplacement et le profil IOPS restent les mêmes que ceux du volume d'origine.

7. Vous pouvez choisir de mettre à disposition le volume dupliqué avec la méthode de facturation horaire ou mensuelle. Le type de facturation du volume d'origine est sélectionné automatiquement et vous pouvez le modifier si vous le souhaitez.

8. Vous pouvez également spécifier un nombre d'E-S par seconde ou un niveau d'E-S par seconde différent pour le nouveau volume. Les IOPS du volume d'origine sont définies par défaut. Les combinaisons de performances et de taille disponibles sont affichées.

   • Si le volume d'origine a un niveau Endurance avec 0,25 IOPS, vous ne pourrez pas effectuer de nouvelle sélection.
   • Si le volume d'origine a un niveau Endurance avec 2, 4 ou 10 IOPS, vous pouvez indiquer n'importe lequel de ces niveaux pour le nouveau volume.

9. Vous pouvez mettre à jour la taille du nouveau volume pour qu'elle soit supérieure à celle du volume d'origine. La taille du volume d'origine est définie par défaut.

   Le redimensionnement de File Storage for Classic est soumis à la limite de 10 fois la taille du volume d'origine.

10. Vous pouvez mettre à jour l'espace d'image instantanée pour le nouveau volume en ajoutant plus, moins ou pas du tout d'espace d'image instantanée. L'espace d'image instantanée du volume d'origine est défini par défaut.

11. Cochez la case pour confirmer que vous avez lu et que vous acceptez les dispositions, puis cliquez sur Créer pour passer la commande.

Une fois que vous avez cliqué sur Créer, la fenêtre de confirmation de commande s'affiche. Lorsque vous fermez la fenêtre, vous revenez à la liste des ressources. Vous pouvez revenir à votre liste de partages File Storage for Classic pour cliquer sur le doublon nouvellement mis à disposition. La section Détails du partage affiche des informations telles que le type de doublon, un lien vers la page Détails du partage parent et le nom de l'instantané utilisé pour créer le doublon.

Créer un double à partir de l'interface de ligne de commande

Avant de commencer, choisissez le client d'interface de ligne de commande que vous souhaitez utiliser.

• Vous pouvez installer l'interface de ligne de commandeIBM Cloud et installer le plug-in SL avec ibmcloud plugin install sl. Pour plus d'informations, voir Extension de l'interface de ligne de commande IBM Cloud avec des plug-in.
• Vous pouvez également installer l'interface 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>

Création d'un partage en double avec l'API

Pour commander un volume dupliqué indépendant Block Storage for Classic avec l'API, vous pouvez effectuer un appel POST /SoftLayer_Product_Order/placeOrder. L'exemple d'API REST suivant crée un doublon indépendant pour un volume Endurance (niveaux d'IOPS).

URL

https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder

Type

POST

Corps de demande

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

Si vous disposez d'un instantané spécifique contenant les données que vous souhaitez utiliser pour créer le volume dupliqué, indiquez l'ID de l'instantané dans la propriété duplicateOriginSnapshotId.

Pour commander un doublon dépendant pour un volume Performance (IOPS personnalisé), effectuez un appel POST /SoftLayer_Product_Order/placeOrder comme dans l'exemple d'API REST suivant.

URL

https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder

Type

POST

Corps de demande

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

Si vous disposez d'un instantané spécifique contenant les données que vous souhaitez utiliser pour créer le volume dupliqué, indiquez l'ID de l'instantané dans la propriété duplicateOriginSnapshotId.

Pour plus d'informations sur l'API et les options, voir Référence d'API. Recherchez le type de données SoftLayer_Container_Product_Order_Network_Storage_AsAService type de données.

Mise à jour des données sur le duplicata du volume parent dans la console

A mesure que le temps passe et que le volume principal change, le volume dupliqué peut être mis à jour pour refléter ces changements via l'action d'actualisation. La mise à jour consiste à créer un instantané du volume principal, puis à mettre à jour le volume dupliqué à l'aide des données issues de cet instantané.

Si le volume en double est indépendant, vous pouvez arrêter une opération d'actualisation en cours d'exécution et en démarrer une nouvelle.

1. Accédez à votre liste de File Storage for Classic. Dans le menu Infrastructure > Infrastructure classique, cliquez sur Stockage > File Storage for Classic.

2. Localisez le volume en double et cliquez sur son nom pour afficher les détails du volume.

3. Cliquez sur Actions > Restaurer l'instantané parent.

4. Dans la liste des instantanés, sélectionnez l'instantané parent qui contient les données à restaurer sur le volume en double. Si le volume en double que vous actualisez est un volume indépendant, vous pouvez arrêter une opération en cours d'exécution et forcer le démarrage d'une nouvelle restauration. Si vous souhaitez forcer l'arrêt d'un processus d'actualisation en cours, cochez la case avant de continuer.

   La restauration des données à partir d'un instantané entraîne la perte de toutes les données qui ont été créées ou modifiées depuis la prise de l'instantané sélectionné. Pendant l'opération de rafraîchissement, le volume dupliqué est désactivé et doit être remonté une fois le rafraîchissement terminé.

5. Cliquez sur « Oui » pour lancer l'actualisation. L'actualisation peut prendre un certain temps. La barre d'état affiche le pourcentage de données copiées sur le volume. Pour afficher le statut mis à jour, actualisez la page dans le navigateur.

Conversion d'un volume dépendant en un double indépendant dans la console

1. Accédez à votre liste de File Storage for Classic. Dans le menu Infrastructure > Infrastructure classique, cliquez sur Stockage > File Storage for Classic.
2. Localisez le volume en double et cliquez sur son nom pour afficher les détails du volume.
3. Cliquez sur Actions > Convertir les doublons dépendants.
4. Cochez la case pour confirmer que vous souhaitez poursuivre la conversion.
5. Cliquez sur Oui.

Le processus de conversion peut prendre un certain temps. Plus le volume est grand, plus il faut de temps pour le convertir. Vous pouvez afficher le statut du processus sur la page des détails du volume sous l'en-tête Dupliquer le statut de conversion.

Mise à jour des données sur le doublon à partir du volume parent à partir de l'interface de ligne de commande

A mesure que le temps passe et que le volume principal change, le volume dupliqué peut être mis à jour pour refléter ces changements via l'action d'actualisation. L'actualisation implique la prise d'un instantané du volume principal, puis la mise à jour du volume en double à l'aide de cet instantané.

Une actualisation n'entraîne pas de temps d'arrêt sur le volume principal. Cependant, le volume dupliqué n'est pas disponible pendant l'opération d'actualisation et il devra être remonté une fois l'actualisation terminée.

Le processus d'actualisation peut prendre du temps. Si vous constatez que vous disposez de nouvelles données que vous souhaitez copier sur le volume dupliqué indépendant, vous pouvez exécuter la commande file volume-refresh avec l'option --force-refresh pour arrêter toutes les transactions d'actualisation en cours et en attente et lancer une nouvelle actualisation.

Le processus d'actualisation forcée fonctionne uniquement sur les volumes indépendants.

$ 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>

Conversion d'un volume dépendant en doublon indépendant à partir de l'interface de ligne de commande

Si vous souhaitez utiliser le volume dépendant comme volume autonome à l'avenir, vous pouvez le convertir en volume normal et indépendant de type « File Storage for Classic » via l'interface de ligne de commande (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

Mise à jour des données sur le doublon à partir du volume parent à l'aide de l'API

A mesure que le temps passe et que le volume principal change, le volume dupliqué peut être mis à jour pour refléter ces changements via l'action d'actualisation. La mise à jour consiste à créer un instantané du volume principal, puis à mettre à jour le volume dupliqué à l'aide des données issues de cet instantané.

Une actualisation n'entraîne pas de temps d'arrêt sur le volume principal. Toutefois, pendant l'opération de rafraîchissement, le volume dupliqué est désactivé et doit être remonté une fois le rafraîchissement terminé.

Le processus d'actualisation peut prendre du temps. Il se peut que vous ayez de nouvelles données à ajouter au doublon avant la fin de l'actualisation en cours d'exécution. Si tel est le cas, vous pouvez effectuer un deuxième appel à refreshDuplicate et spécifier le deuxième paramètre forceRefresh sous la forme true pour arrêter toutes les transactions d'actualisation en cours et en attente, et lancer une nouvelle actualisation. Si le second paramètre est défini sur false ou qu'il n'est pas spécifié, l'appel échoue si une autre actualisation est déjà en cours.

Le processus d'actualisation forcée fonctionne uniquement sur les volumes indépendants.

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

Conversion d'un volume dépendant en doublon indépendant à l'aide de l'API

Si vous souhaitez utiliser le volume dépendant comme volume autonome à l'avenir, vous pouvez le convertir en volume normal et indépendant de type « IBM Cloud® Block Storage for Classic » à l'aide de l'API. Consultez l'exemple suivant qui utilise l'API REST.

URL

https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/<storageId>/convertCloneDependentToIndependent

Type

POST

Corps de demande

blanc

Pour plus d'informations sur l'API et les options, voir Référence d'API.