Visualisation de la liste des volumes d' File Storage for Classic s dans la console

Vous pouvez consulter vos volumes à partir de la liste Ressources ou en allant dans la liste des volumes d' File Storage for Classic.

1. Accédez à la consoleIBM Cloud®. Dans le menu, sélectionnez 'Infrastructure ' > 'Infrastructure classique.
2. Cliquez sur Stockage > File Storage for Classic. La liste des partages de fichiers s'affiche.
3. Vous pouvez filtrer la liste en cliquant sur l' et en sélectionnant un lieu ou en saisissant une capacité spécifique. Cliquez sur « Appliquer » pour valider votre sélection.
4. Cliquez sur le nom de volume approprié dans la liste.

Vous pouvez télécharger la liste au format « CSV » en cliquant sur .

Le tableau affiche des informations sur le volume, telles que le nom, l'emplacement, l'état, le type de stockage, l'IOPS maximum, la capacité, l'utilisation, la capacité d'instantané, la date de début et les notes, qui peuvent être modifiées.

Affichage de la liste des volumes d' File Storage for Classic s à 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-list -d dal13 -t endurance --sortby capacity_gb

id          username              datacenter   storage_type             capacity_gb   bytes_used   IOPs   ip_addr                                lunId   active_transactions   rep_partner_count   notes
233039512   IBM02SEV1414935_79    dal13        endurance_file_storage   20            0            -      fsf-dal1303g-fz.adn.networklayer.com   -       0                     1                   -
703233985   IBM02SEV1414935_538   dal13        endurance_file_storage   20            0            -      fsf-dal1303d-fz.adn.networklayer.com   -       0                     0                   -
221349094   IBM02SEV1414935_68    dal13        endurance_file_storage   30            0            -      fsf-dal1302c-fz.adn.networklayer.com   -       0                     1                   Testing

$ slcli file volume-list --help
Usage: slcli file volume-list [OPTIONS]

        List file storage.

Example::
        slcli file volume-list -d dal10 --storage-type endurance --sortby capacity_gb

┌────┬────────────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ -u │ --username     │ Volume username                                                                                                                                                              │
│ -d │ --datacenter   │ Datacenter shortname                                                                                                                                                         │
│ -o │ --order        │ Filter by ID of the order that purchased the block storage                                                                                                                   │
│    │ --storage-type │ Type of storage volume Choices: performance, endurance                                                                                                                       │
│    │ --sortby       │ Column to sort by                                                                                                                                                            │
│    │ --columns      │ Columns to display. Options: id, username, datacenter, storage_type, capacity_gb, bytes_used, ip_addr, active_transactions, mount_addr, rep_partner_count, created_by, notes │
│ -h │ --help         │ Show this message and exit.                                                                                                                                                  │
└────┴────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Visualisation de la liste des volumes File Storage for Classic avec l'API

Pour récupérer la liste des volumes File Storage for Classic avec l'API, vous pouvez utiliser la méthode list_file_volumes et filtrer les résultats avec les paramètres datacenter, storage_type (Endurance ou Performance) et order. La demande renvoie une liste de volumes de fichiers avec des détails.

Vous pouvez également utiliser des commandes curl, comme dans l'exemple suivant, pour interroger divers aspects du volume de stockage. Cet exemple renvoie le nombre d'octets actuellement utilisés.

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/collectBytesUsed'

La requête suivante renvoie la valeur maximale d'IOPS pour le volume.

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/getIops'

Pour plus d'informations, voir SoftLayer_Network_Storage dans la référence de l'API.

Mise à jour des notes d'un volume dans la console

1. Accédez à la consoleIBM Cloud®. Dans le menu, sélectionnez l’icône Infrastructure > Infrastructure classique.
2. Cliquez sur Stockage > File Storage for Classic.
3. Recherchez le volume que vous souhaitez mettre à jour. Cliquez sur le nom du volume pour afficher la page Détails du volume.
4. Cliquez sur l'icône Édition à côté de Notes et saisissez votre texte.

Mise à jour des notes d'un volume via l'interface de ligne de commande

Vous pouvez utiliser la commande ibmcloud sl call-api pour ajouter et modifier des notes pour vos volumes.

$ ibmcloud sl call-api --help
NAME:
  call-api - Call arbitrary API endpoints

USAGE:
  ibmcloud sl call-api SERVICE METHOD [OPTIONS]

OPTIONS:
  --filter value      Object filters
  -h, --help          Usage information.
  --init value        Init parameter
  --limit value       Result limit
  --mask value        Object mask: use to limit fields returned
  --offset value      Result offset
  --output value      Specify output format, only JSON is supported now.
  --parameters value  Append parameters to web call

Spécifiez l'ID du volume dans l'option --init et utilisez l'option --parameters pour définir la nouvelle note. Voir l'exemple suivant :

ibmcloud sl call-api SoftLayer_Network_Storage editObject --init 562193766 --parameters '[{"notes":"Testing."}]'

Pour plus d'informations, voir ibmcloud sl call-api.

Mise à jour des notes d'un volume via l'API

Pour mettre à jour les notes sur un volume à l'aide de l'API, vous pouvez effectuer une requête curl à l'adresse POST /SoftLayer_Network_Storage/$VOLUME_ID/editObject.json. L'exemple d'API suivant ajoute le mot "Testing" comme note au volume de stockage.

curl -u $SL_USER:$SL_APIKEY -X POST -H "Accept: */*" -H "Accept-Encoding: gzip, deflate, compress" -d '{"parameters": [{"notes": "Testing"}]}' 'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/123456789/editObject.json'

Vous pouvez également utiliser la méthode volume_set_note dans le client API Python.

Afficher la liste des hôtes autorisés à accéder à un volume d' File Storage for Classic s dans la console

1. Accédez à la consoleIBM Cloud®. Dans le menu, sélectionnez 'Infrastructure ' > 'Infrastructure classique.
2. Cliquez sur Stockage > File Storage for Classic, puis sur Nom de volume.
3. Cliquez sur Hôtes autorisés pour afficher les instances de calcul pouvant accéder à votre partage de fichiers.
4. Cliquez sur l' et sélectionnez Voir les détails de l'hôte. Un panneau latéral s'affiche avec des détails tels que le nom de l'appareil, l'adresse IP, le nom d'utilisateur et le mot de passe. La section Liste de contrôle d'accès s'affiche également. Dans la section Access Control List, vous pouvez ajouter ou supprimer des sous-réseaux.

L'adresse cible est répertoriée sur la page Détail du stockage. Pour NFS, elle est décrite sous forme de DNS, tandis que pour iSCSI, il s'agit de l'adresse IP du portail cible Discover.

Afficher la liste des hôtes autorisés à accéder à un volume de l' File Storage for Classic depuis l'interface de ligne de commande

ibmcloud sl file access-list 12345678 --sortby id

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

Options:
 --sortby TEXT   Column to sort by
 --columns TEXT  Columns to display. Options: id, name, type,
                 private_ip_address, source_subnet, host_iqn, username,
                 password, allowed_host_id
 -h, --help      Show this message and exit.

Affichage dans la console des volumes de l' File Storage for Classic s auxquels un hôte est autorisé à accéder

Vous pouvez consulter les volumes auxquels un hôte a accès, y compris les informations nécessaires pour établir une connexion : nom du volume, type de stockage, adresse de destination, capacité et emplacement.

1. Accédez à la consoleIBM Cloud®.
2. Dans le menu, sélectionnez 'Infrastructure ' > 'Infrastructure classique.
3. Cliquez sur Unités > Liste des unités.
4. Cliquez sur l'unité appropriée.
5. Sélectionnez l'onglet Stockage.

La liste des volumes de stockage auxquels cet hôte particulier a accès s'affiche (les volumes sont regroupés par type de stockage : bloc, fichier, autre). Les menus Action respectifs vous permettent d'autoriser davantage de stockage ou de retirer l'accès.

Supprimer l'accès d'un hôte à File Storage for Classic dans la console

Si vous souhaitez ne plus autoriser un hôte à accéder à un volume de stockage en particulier, vous pouvez révoquer l'accès. Lorsque l'accès est révoqué, la connexion à l'hôte est retirée du volume. Le système d'exploitation et les applications ne peuvent plus communiquer avec le volume.

Pour empêcher tout problème côté hôte, démontez le volume de stockage de votre système d'exploitation avant de révoquer l'accès afin de prévenir tout incident lié à des unités manquantes ou à l'altération des données.

Vous pouvez révoquer l'accès à partir de Stockage dans la Liste des unités ou dans les vues Stockage.

Supprimer l'accès d'un hôte à File Storage for Classic depuis l'interface de ligne de commande

ibmcloud sl file access-revoke 12345678 --virtual-id 87654321

$ slcli file access-revoke --help
Usage: slcli file access-revoke [OPTIONS] VOLUME_ID

Options:
  -h, --hardware-id TEXT    The ID of one hardware server to revoke authorization.
  -v, --virtual-id TEXT     The ID of one virtual server to revoke authorization.
  -i, --ip-address-id TEXT  The ID of one IP address to revoke authorization.
  -p, --ip-address TEXT     An IP address to revoke authorization.
  -s, --subnet-id TEXT      An ID of one subnet to revoke authorization.
  --help                    Show this message and exit.

Révoquer l'accès d'un hôte à File Storage for Classic avec l'API

Pour révoquer l'autorisation d'accès de l'hôte à votre volume de fichiers, vous pouvez utiliser la méthode deauthorize_host_to_volume dans le client API Python. Vous devez spécifier le volume_id et les hôtes de calcul en fournissant l'un des paramètres suivants : hardware_ids (pour les serveurs métalliques nus),virtual_guest_ids (pour les instances de serveurs virtuels), ip_address_ids, subnet_ids. La requête renvoie un tableau d'objets SoftLayer_Network_Storage_Allowed_Host qui ont accès au volume spécifié, ce qui vous permet de confirmer que les hôtes de calcul demandés ont été supprimés.

Suppression d'un volume de stockage dans la console

Si vous n'avez plus besoin d'un volume spécifique, vous pouvez supprimer ce partage de fichiers. Pour ce faire, vous devez d'abord révoquer l'accès à partir de tous les hôtes.

1. Accédez à la consoleIBM Cloud®. Dans le menu, sélectionnez 'Infrastructure ' > 'Infrastructure classique.

2. Cliquez sur Stockage > File Storage for Classic.

3. Cliquez sur « Actions » (Volume à annuler), puis sélectionnez « Supprimer File Storage for Classic » (Annuler le volume).

4. Confirmez si vous souhaitez supprimer le volume immédiatement ou à la date anniversaire de sa création.

   Si vous sélectionnez l'option d'annulation du volume à sa date anniversaire, vous pouvez annuler la demande d'annulation avant sa date anniversaire.

5. Cliquez sur Continuer ou sur Fermer.

6. Cochez la case de confirmation, puis cliquez sur « Confirmer ».

Lorsque le volume est annulé, la demande est suivie d'un délai d'attente de récupération de 24 heures. Le volume est toujours visible dans la console pendant cette période. Le remplissage du volume s'arrête immédiatement. Une fois que cette dernière arrive à expiration, les données sont détruites et le volume est retiré de la console. Pour plus d'informations, voir la FAQ.

Les répliques actives et les volumes dupliqués dépendants peuvent bloquer la réclamation du volume de stockage. Assurez-vous que le volume n'est plus monté, que les autorisations d'hôte ont été révoquées, que la réplication a été annulée et qu'aucun doublon dépendant n'existe avant de tenter de supprimer le volume d'origine.

Suppression d'un volume de stockage via l'interface de ligne de commande

Lorsque le volume est annulé, la demande est suivie d'un délai d'attente de récupération de 24 heures. Le volume est toujours visible dans la console pendant cette période. Le remplissage du volume s'arrête immédiatement. Une fois que cette dernière arrive à expiration, les données sont détruites et le volume est retiré de la console. Pour plus d'informations, voir la FAQ.

Les répliques actives et les volumes dupliqués dépendants peuvent bloquer la réclamation du volume de stockage. Assurez-vous que le volume n'est plus monté, que les autorisations d'hôte ont été révoquées, que la réplication a été annulée et qu'aucun doublon dépendant n'existe avant de tenter de supprimer le volume d'origine.

ibmcloud sl file volume-cancel 12345678 --immediate -f

$ slcli file volume-cancel --help
Usage: slcli file volume-cancel [OPTIONS] VOLUME_ID

Options:
  --reason TEXT  An optional reason for cancellation.
  --immediate    Cancels the File Storage volume immediately instead of on the
                 billing anniversary.
  -h, --help     Show this message and exit.

Suppression d'un volume de stockage via l'API

Lorsque le volume est annulé, la demande est suivie d'un délai d'attente de récupération de 24 heures. Le volume est toujours visible dans la console pendant cette période. Le remplissage du volume s'arrête immédiatement. Une fois que cette dernière arrive à expiration, les données sont détruites et le volume est retiré de la console. Pour plus d'informations, voir la FAQ.

Les répliques actives et les volumes dupliqués dépendants peuvent bloquer la réclamation du volume de stockage. Assurez-vous que le volume n'est plus monté, que les autorisations d'hôte ont été révoquées, que la réplication a été annulée et qu'aucun doublon dépendant n'existe avant de tenter de supprimer le volume d'origine.

Ensuite, vous pouvez utiliser la méthode cancel_volume dans le client API Python. Précisez l' volume_id s et indiquez si vous souhaitez résilier l'abonnement immédiatement ou à la date anniversaire (immediate=False ou immediate=True). Vous pouvez également, si vous le souhaitez, indiquer le motif de la résiliation (reason='No longer needed').

Suppression d'un volume de stockage avec Terraform

Utilisez la commande « terraform destroy » pour supprimer facilement un objet distant tel qu'un partage de fichier unique. L'exemple suivant annule le partage de fichiers avec l'ID ibm_file_share.example.id.

terraform destroy --target ibm_file_share.example.id

Pour plus d'informations, voir Terraform destroy.

Lorsque le volume est annulé, la demande est suivie d'un délai d'attente de récupération de 24 heures. Le volume est toujours visible dans la console pendant cette période. Le remplissage du volume s'arrête immédiatement. Une fois que cette dernière arrive à expiration, les données sont détruites et le volume est retiré de la console. Pour plus d'informations, voir la FAQ.

Les répliques actives et les volumes dupliqués dépendants peuvent bloquer la réclamation du volume de stockage. Assurez-vous que le volume n'est plus monté, que les autorisations d'hôte ont été révoquées, que la réplication a été annulée et qu'aucun doublon dépendant n'existe avant de tenter de supprimer le volume d'origine.