Affichage de tous les partages de fichiers dans la console

1. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Partages de stockage de fichiers.

2. La page de liste Partages de fichiers pour VPC affiche tous les partages de fichiers créés dans cette zone. Les options du menu Actions permettent de gérer les partages de fichiers. Le tableau suivant décrit les informations figurant sur la page de liste.

Page de liste des partages de fichiers.

Zone	Valeur
Région	Région du compte du partage de fichiers. Sélectionnez une autre région pour afficher les partages de fichiers des zones de cette région.
Nom	Nom du partage de fichiers. Il peut s'agir du partage de fichiers d'origine ou d'un partage de fichiers de réplique. Cliquez sur le nom pour afficher les détails de ce partage de fichiers.
Statut	Pour obtenir la liste des états des partages de fichiers, consultez la section États du cycle de vie des partages de fichiers.
Groupe de ressources	Le champ affiche le nom du groupe de ressources auquel appartient le partage de fichiers.
Emplacement	Le champ affiche la zone dans laquelle se trouve le partage de fichiers.
Cibles de montage	Nombre de cibles de montage associées au partage de fichiers. Vous pouvez avoir une cible de montage par VPC et partage de fichiers.
Instantanés	Ce champ indique le nombre d'instantanés qui ont été pris du partage de fichiers. Cette colonne est masquée par défaut. Cliquez sur l' pour sélectionner les colonnes que vous souhaitez voir.
Taille	Taille du partage de fichiers, en Go.
Rôle transversal	Les valeurs de cette colonne peuvent être None, Origin share, ou Accessor share. Si la valeur est None, le partage n'est pas partagé avec un autre compte ou un service externe. Si la valeur est Origin share, le partage est partagé avec un autre compte ou un service externe et est lié à un partage d'accesseur dans l'autre compte. Si la valeur est Accessor share, ce partage est lié à un partage d'origine dans le but d'accéder aux données du partage d'origine.
Rôle de réplication	Relation entre le partage de fichiers source et le partage de fichiers réplique. Réplique de indique que le partage de fichiers est une réplique du partage source, auquel il est lié. Source de indique que la réplique est liée à la source. "Aucun" indique que le partage de fichiers n'est pas répliqué avec un autre partage.
Statut de la réplication	Cette colonne est masquée par défaut. Cliquez sur l' pour sélectionner les colonnes que vous souhaitez voir.
Type de chiffrement	Il indique le type de chiffrement du partage de fichiers : géré par le fournisseur ou géré par le client. Le chiffrement géré par le client utilise vos propres clés racine pour protéger vos données. L'interface utilisateur identifie également le service de gestion des clés (KMS).

Vous pouvez accéder au menu Actions en cliquant sur . Le menu Actions comporte des options permettant de gérer le partage de fichiers, en fonction de son état.

• Pour un partage de fichiers zonal dans un état stable, vous pouvez choisir de renommer le partage, de modifier les IOPS, de copier le CRN du partage, de créer une réplique ou de supprimer le partage de fichiers. Les actions Supprimer et Créer une réplique sont désactivées si vous avez déjà configuré la réplication vers un partage de fichiers de réplique. Pour plus d'informations, voir Création de partages de fichiers de réplique.
• Pour un partage de fichiers régional, le menu Actions contient les actions Renommer, Modifier la taille et la bande passante, Copier le CRN, Créer un instantané et Supprimer.

Affichage des détails d'un partage de fichiers dans la console

1. Accédez à la liste de tous les partages de fichiers. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Partages de stockage de fichiers.

2. Cliquez sur le nom d'un partage de fichiers pour afficher la page des détails. Le nom et le statut modifiables du partage de fichiers s'affichent. Si vous avez appliqué des balises de gestion des utilisateurs ou des accès au partage de fichiers, elles sont répertoriées à côté de l'état. Cliquez sur Ajouter des balises pour appliquer de nouvelles balises au partage.

3. La page de détails comporte plusieurs onglets. L'onglet Présentation s'affiche par défaut.

   • Aperçu- Le tableau suivant décrit les informations disponibles pour votre partage de fichiers.

   Page de détails sur les partages de fichiers

   Zone	Valeur
   Détails du partage de fichiers
   Nom	Nom du partage de fichiers. Cliquez sur l'icône Editer pour modifier le nom.
   ID de partage de fichiers	L'UUID généré lors de la création du partage de fichiers.
   Groupe de ressources	Groupes de ressources associés au partage de fichiers dans votre compte.
   Date de création	Date de création du partage de fichiers.
   Emplacement	L'emplacement du partage de fichiers (par exemple, us-south-2 ).
   Rôle de réplication	Partage de fichiers source ou réplique.
   Chiffrement	Indique le chiffrement géré par le fournisseur ou géré par le client. Lorsque le partage de fichiers est chiffré avec des clés gérées par le client, l'instance de chiffrement, le nom de la clé de chiffrement et le CRN de la clé de chiffrement sont également affichés.
   Mode d'accès « Mount target » Obsolète	Ce champ s'affiche uniquement lorsque le partage de fichiers utilise le mode d'accès VPC, désormais obsolète. Cliquez sur l'icône « Modifier pour changer de mode d'accès. Pour plus d'informations, consultez le guide de migration.
   CRN	Nom de la ressource cloud copiable du partage de fichiers.
   Chiffrement autorisé en mode en transit	Cette valeur indique si le chiffrement en transit est requis lorsque les clients accèdent au partage de fichiers. Cliquez sur l'icône Editer pour modifier les valeurs autorisées. Les valeurs possibles sont User managed, et None. Ce champ ne s'applique pas aux partages de fichiers utilisant le mode d'accès VPC, désormais obsolète. [Sélectionnez l'option de disponibilité] «{: tag-green} » : les clients bénéficiant d'un accès spécial leur permettant de tester en avant-première la nouvelle offre de partage de fichiers régional peuvent choisir entre « IPsec », « Stunnel » et « Aucun ».
   Rôle transversal	Les valeurs possibles sont None, Origin, Accessor. Ce champ ne s'applique pas aux partages de fichiers utilisant le mode d'accès VPC, désormais obsolète.
   Nombre d'instantanés	Cette valeur indique le nombre d'instantanés qui ont été pris du partage de fichiers. Ce champ ne s'applique pas aux partages de fichiers utilisant le mode d'accès VPC, désormais obsolète.
   Volume des données modifiées dans l'ensemble des instantanés	Il représente le volume de données facturables sur l'ensemble des instantanés. Ce champ ne s'applique pas aux partages de fichiers utilisant le mode d'accès VPC, désormais obsolète.
   Détails du profil
   Profil	Le nom du profil de partage qui définit les performances du partage de fichiers. Dans la plupart des cas, le profil dp2.
   Taille	Capacité de partage de fichiers en Go.
   Nbre max. d'IOPS	IOPS maximum pour le partage spécifié. Ce champ est affiché pour les parts de zone.
   Bande passante	Limite maximale de la bande passante spécifiée pour le partage. Ce champ est affiché pour les parts régionales.
   Cibles de montage	Nombre de cibles de montage associées au partage de fichiers. Vous pouvez avoir une cible de montage par VPC et partage de fichiers. Vous pouvez créer d'autres cibles de montage pour d'autres VPC. Cliquez sur pour renommer ou supprimer la cible de montage ou pour afficher le chemin de montage.
   Nom	Nom de la cible de montage.
   Statut	Statut de la cible de montage sur le VPC.
   Cloud privé virtuel Obsolète	Ce champ s'affiche si le partage de fichiers utilise le mode d'accès VPC obsolète. Cliquez sur le nom pour accéder à la page de détails de ce VPC, où vous pouvez consulter la liste des partages de fichiers dont la cible de montage se trouve dans ce VPC.
   Sous-réseau	Ce champ s'affiche lorsque le partage de fichiers a un mode d'accès par groupe de sécurité. Cliquez sur le nom du sous-réseau pour afficher ses détails.
   Groupe de sécurité	Ce champ s'affiche lorsque le partage de fichiers a un mode d'accès par groupe de sécurité. Il s'agit du nombre de groupes de sécurité dont le partage est membre.
   IP réservée	Ce champ s'affiche lorsque le partage de fichiers a un mode d'accès par groupe de sécurité. Adresse IP de l'interface de réseau virtuel connectée à la cible de montage
   Chiffrement du transport	Ce champ s'affiche lorsque le partage de fichiers a un mode d'accès par groupe de sécurité. Cette fonctionnalité peut être activée ou désactivée.
   Liaisons de partage d'ID d'accès	Cette section s'affiche si le partage comporte des parts d'accès dans d'autres VPC.
   ID de liaison	Cette zone affiche l'ID de la liaison qui connecte le partage d'origine au partage d'ID d'accès.
   ID de compte	ID du compte qui a accès aux données de votre partage via le partage d'ID d'accès.
   ID d'ID d'accesseur	Cette zone affiche l'ID de compte qui a créé le partage d'ID d'accès dans un autre VPC.
   Statut	Il affiche le statut du cycle de vie du partage de fichiers de l'accesseur. Le statut Stable est attendu
   Date de création	Date et heure de création du partage d'accès.
   Relation de réplication de partage de fichiers	Affiche le nom, l'emplacement et le statut de la source et des partages de fichiers de réplique Si aucun partage de fichiers de réplique n'a été créé, cliquez sur Créer une réplique pour en créer une. Pour rompre la relation de réplication, cliquez sur Supprimer la relation de réplication. Ensuite, le partage de fichiers de réplique devient un partage de fichiers en lecture / écriture indépendant.
   Fréquence de réplication	Passez la souris sur l'icône d'information pour afficher une explication concernant le calendrier de réplication cron.
   Statut	Statut de la réplication, par exemple, suspendu ou disponible.
   Heure de début de la dernière synchronisation	Date et heure du dernier démarrage de la réplication.
   Heure de fin de la dernière synchronisation	Date et heure de fin de la dernière réplication.
   Taux de transfert	Il indique la vitesse à laquelle les données ont été copiées du partage de fichiers source vers sa réplique lors de la dernière synchronisation.
   Montant du transfert	Quantité de données copiées du partage de fichiers source vers sa réplique lors de la dernière synchronisation.
   Rôle de réplication	Partage de fichiers source ou de réplique.
   Nom du partage de fichiers	Cliquez sur le nom du partage de fichiers pour en afficher les détails.
   Emplacement	Il affiche les informations de zone du partage de fichiers.
   Statut	Il affiche le statut de cycle de vie du partage de fichiers. Le statut Stable est attendu.

   • Instantanés- L'onglet « Instantanés » présente un récapitulatif concernant tous les instantanés, ainsi que la liste des instantanés créés pour le partage de fichiers.

     • Le résumé des instantanés fournit des informations telles que le nombre d'instantanés, le volume global de données capturé dans les instantanés et le rôle de réplication.
     • La liste des instantanés montre les instantanés qui ont été pris du partage de fichiers. Vous pouvez voir le nom, la taille du partage de fichiers au moment où l'instantané a été pris, et l'état de l'instantané. Vous pouvez cliquer sur Créer pour capturer un nouvel instantané. Cliquez sur l'icône Actions pour afficher le menu Actions. Le menu Actions comporte 2 options : Restaurer et Supprimer.

   • Surveillance- Dans l'onglet Surveillance, vous pouvez voir trois graphiques pour l'utilisation des parts, la bande passante totale et le nombre total d'IOPS. Ces graphiques sont disponibles gratuitement, même sans instance IBM Cloud Monitoring Vous pouvez personnaliser la plage de dates pour visualiser les données dans le temps.

     Le suivi de ces mesures d'utilisation peut vous aider à déterminer la quantité de travail effectuée par votre application ou votre charge de travail. Vous pouvez utiliser cette information pour déterminer si la valeur IOPS doit être ajustée. Le contrôle de la capacité disponible de votre partage peut vous aider à identifier le besoin de stockage supplémentaire avant que l'espace insuffisant ne devienne un problème pour l'écriture de données sur le partage ou la réplication. La consultation de ces indicateurs peut vous aider à anticiper tout changement dans les frais à la fin de la période de facturation.

     Ces mesures ne sont pas mises à jour en temps réel. Les données relatives aux nouveaux partages de fichiers peuvent prendre jusqu'à une heure ou une heure et 15 minutes pour apparaître dans les graphiques de la console. Les changements d'utilisation peuvent prendre de 15 à 30 minutes pour être reflétés dans les graphiques.

     Si vous disposez d'une instance du service IBM Cloud Monitoring, cliquez sur Lancer la surveillance pour ouvrir l'interface web Sysdig et travailler avec les tableaux de bord de métrologie qui s'y trouvent. Pour plus d'informations sur la configuration de l'instance IBM Cloud Monitoring, voir Monitoring metrics for File Storage for VPC.

Affichage de tous les partages de fichiers d'un VPC dans la console

Vous pouvez voir tous les partages de fichiers qui possèdent une cible de montage sur un VPC en affichant la page des détails du VPC.

1. Accédez à un VPC :

   1. A partir de la page des détails des partages de fichier, cliquez sur le lien VPC dans la liste des cibles de montage.
   2. Dans l'interface utilisateur, cliquez sur l'icône Menu de navigation > Infrastructure > Réseau > VPCs. Cliquez sur le nom d'un VPC dans la liste.

2. Dans la page des détails du VPC, accédez à File shares in this VPC.

Affichage des détails de la cible de montage dans la console

1. Accédez à la liste de tous les partages de fichiers. Dans la console IBM Cloud, cliquez sur l'icône de Navigation > Infrastructure > Stockage > Partages de stockage de fichiers.
2. Cliquez sur le nom d'un partage de fichiers pour afficher la page des détails.
3. Faites défiler la page jusqu'à la section des cibles de montage pour voir la liste des cibles de montage. La liste contient les noms et les statuts de la cible de montage, ainsi que le VPC auquel appartient la cible de montage.
4. Cliquez sur l'icône Actions pour afficher le menu Actions. Le menu Actions comporte 3 options: Renommer, Afficher le chemin et Supprimer.
5. Cliquez sur Afficher le chemin pour afficher les informations de chemin de montage que vous pouvez copier et coller dans vos commandes de montage.

Affichage de tous les partages de fichiers depuis l'interface de ligne de commande (CLI)

Vous pouvez répertorier tous vos partages de fichiers dans une région à l'aide de la commande ibmcloud is shares.

ibmcloud is shares

Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                     Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size   Allowed Access Protocols   Availability Mode   Bandwidth(Mbps)   Storage Generation
r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279   my-regional-file-share   stable            -            rfs       1000        defaults         none               none                    0                0               -                          regional            1500              2
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share     stable            us-south-2   dp2       10         defaults         source             none                    2                1               -                          zonal               -                 1
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-file-share    stable            us-south-1   dp2       10         defaults         replica            none                    2                1               -                          zonal               -                 1
r006-ee1f6fc0-6fa3-4821-ad70-f6589e30c566   my-accessor-share        stable            -           rfs        3000         defaults         none               accessor                0                0               -                          regional            1                 2
r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09   my-origin-share          stable            -           rfs        3000        defaults         none               origin                  0                0               -                          regional            1                 2

Pour plus d'informations sur les options de commande, voir ibmcloud is shares. Pour plus d'informations sur lifecycle state, voir File share statuses. Stable est attendu.

Affichage des détails d'un partage de fichiers depuis l'interface de ligne de commande (CLI)

Pour afficher les détails d'un partage de fichiers, exécutez la commande ibmcloud is share et spécifiez le partage de fichiers par ID ou nom.

L'exemple suivant identifie le partage de fichiers par son ID. Ce partage est une réplique basée sur le profil dp2 et l'accès au partage est accordé à l'aide de groupes de sécurité. La sortie fournit également des informations sur le partage de fichiers source et sur les détails de réplication.

ibmcloud is share r006-455b601c-8fc1-4476-8771-4708c49c8ef7

Getting file share r006-455b601c-8fc1-4476-8771-4708c49c8ef7 under account Test Account as user test.user@ibm.com...
ID                                 r006-455b601c-8fc1-4476-8771-4708c49c8ef7
Name                               my-replica-file-share
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7
Lifecycle state                    stable
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   none,ipsec
Zone                               us-south-1
Profile                            dp2
Size(GB)                           10
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-04-04T09:19:27+00:00
Latest job                         Job status   Job status reasons
                                   succeeded    -
Latest Sync                        Completed At                Data Transferred   Started At
                                   2025-04-18T21:00:04+00:00   3560               2025-04-18T21:00:00+00:00
Replication cron spec              00 * * * *
Replication role                   replica
Replication status                 active
Replication status reasons         Status code   Status message
                                   -             -
Source share                       ID                                          Name                    Resource type
                                   r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    share
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Vous pouvez utiliser le nom du partage source pour extraire ses détails. Consultez l'exemple suivant.

ibmcloud is share my-source-file-share

Getting file share my-source-file-share under account Test Account as user test.user@ibm.com...
ID                               r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
Name                             my-source-file-share
CRN                              crn:v1:bluemix:public:is:us-south-2:a/a1234567b::share:r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
Lifecycle state                  stable
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec,none
Zone                             us-south-2
Profile                          dp2
Size(GB)                         10
IOPS                             100
User Tags                        env:dev
Encryption                       provider_managed
Mount Targets                    ID                                          Name
                                 r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target
Resource group                   ID                                 Name
                                 6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                          2024-06-25T15:42:53+00:00
Latest job                       Job status   Job status reasons
                                 succeeded    -
Replication share                ID                                          Name                    Resource type
                                 r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-file-share   share
Replication role                 source
Replication status               active
Replication status reasons       Status code   Status message
                                 -             -
Snapshot count                   0
Snapshot size                    0
Source snapshot                  -
Allowed Access Protocols         nfs4
Availability Mode                zonal
Bandwidth(Mbps)                  1
Storage Generation               1

L'exemple suivant montre les informations que la commande ibmcloud is share renvoie lorsque vous récupérez des informations sur un partage de fichiers régional.

ibmcloud is share my-regional-file-share

Getting file share my-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279
Lifecycle state                    stable
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel,none
Zone                               -
Profile                            rfs
Size(GB)                           1000
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                       Name
                                   No mounted targets found
Resource group                     ID                                 Name
                                   db8e8d865a83e0aae03f25a492c5b39e   Default
Created                            2025-07-22T22:15:15+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nsf4
Availability Mode                  regional
Bandwidth(Mbps)                    125
Storage Generation                 2

Pour plus d'informations sur les options de commande, voir ibmcloud is share.

Affichage des liaisons de partage d'un partage de fichiers à partir de l'interface de ligne de commande

Pour afficher les liens de partage d'accesseur liés à un partage d'origine à partir de l'interface de gestion, utilisez la commande ibmcloud is share-accessor-bindings. Consultez l'exemple suivant.

ibmcloud is share-accessor-bindings my-origin-share

Listing accessor bindings for the share ID my-origin-share under account Test Account as user test.user@ibm.com...
ID                                          Lifecycle state   Created at                  Accessor CRN                                                                                                    Accessor resource type
r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f   stable            2025-08-26T21:03:40+00:00   crn:v1:bluemix:public:is::a/a1234567::share:r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09   share
Viktoria_Muirhead@cloudshell:~$

Affichage d'une liaison de partage spécifique d'un partage de fichiers à partir de l'interface de ligne de commande

Pour afficher un lien de partage d'accesseur spécifique lié à un partage d'origine à partir de la CLI, utilisez la commande ibmcloud is share-accessor-binding. Consultez l'exemple suivant.

ibmcloud is share-accessor-binding my-origin-share r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f

Get accessor binding r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f for the share ID my-origin-share under account Test Account as user test.user@ibm.com...
ID                r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f
Created           2025-08-26T21:03:40+00:00
Href              https://us-south.iaas.cloud.ibm.com/v1/shares/r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09/accessor_bindings/r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f
Resource type     share_accessor_binding
Lifecycle state   stable
Accessor          Resource type   CRN                                                                                                             Name
                  share           crn:v1:bluemix:public:is::a/a1234567::share:r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09      my-accessor-share

Affichage des cibles de montage d'un partage de fichiers depuis l'interface de ligne de commande

Pour afficher toutes les cibles de montage créées pour un partage de fichiers, exécutez la commande ibmcloud is share-mount-targets et spécifiez l'ID de partage de fichiers.

ibmcloud is share-mount-targets r006-e1a89008-f23b-42f8-8e44-5b31ddf0aac7

Listing share mount target of r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                     VPC      Lifecycle state   Transit Encryption
r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target   my-vpc   stable            none

Pour plus d'informations sur les options de commande, voir ibmcloud is share-mount-targets.

Affichage des détails de la cible de montage depuis l'interface de ligne de commande

Pour afficher des informations plus détaillées sur une cible de montage, exécutez la commande ibmcloud is share-mount-target et indiquez l'ID ou le nom de partage avec le nom ou l'ID de la cible de montage. Consultez l'exemple suivant.

ibmcloud is share-mount-target  r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-mount-target

Getting mount target ID my-source-mount-target for share ID r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a under account Test Account as user test.user@ibm.com...
ID                          r006-fdbffc45-618c-49f1-bb08-ec530d7be378
Name                        my-source-mount-target
VPC                         ID                                          Name
                            r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b   my-vpc
Access control mode         security_group
Resource type               share_mount_target
Virtual network interface   ID                                          Name
                            r006-3b0c00fa-0ce3-4ff8-9a5d-c7a645fbe530   my-source-vni
Lifecycle state             stable
Mount path                  10.240.64.6:/5975a795_e5e7_474c_82d3_46c1d4159c6a
Transit Encryption          none
Created                     2023-10-19T15:42:54+00:00

Pour plus d'informations sur les options de commande, voir ibmcloud is share-mount-target.

Affichage du statut de réplication et de l'état de cycle de vie à l'aide de l'API

• lifecycle_state
  • Cette propriété fournit l'état en cours d'une ressource via la méthode Extraire un partage de fichiers. Les valeurs fournies par lifecycle_state sont génériques et sont destinées à s'appliquer à diverses ressources, et pas uniquement aux partages de fichiers. lifecycle_state indique si le partage de fichiers est stable, en cours de mise à jour, en cours de suppression ou suspendu. Stable est la valeur attendue. Pour plus d'informations, voir Statuts de partage de fichiers.
• replication_status
  • Cette propriété fournit le statut de réplication en cours du fichier via la méthode Extraire un partage de fichiers. Les valeurs renvoyées par replication_status sont spécifiques aux partages de fichiers. Pour plus d'informations, consultez la documentation relative à l'API Virtual Private Cloud.

Affichage de tous les partages de fichiers à l'aide de l'API

Effectuez une demande GET /shares pour répertorier tous les partages de fichiers d'une région.

curl -X GET "$vpc_api_endpoint/v1/shares?version=2023-07-18?limit=50&generation=2" -H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares?limit=50"
  },
  "limit": 50,
  "shares": [
    {
      "access_control_mode": "vpc",
      "created_at": "2023-07-18T13:02:17Z",
      "crn": "crn:[...]",
      "encryption": "provider_managed",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
      "id": "51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
      "iops": 3000,
      "lifecycle_state": "stable",
      "name": "share-name1",
      "profile": {
        "family": "tiered",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
        "name": "tier-10iops",
        "resource_type": "share_profile"
      },
      "resource_group": {
        "crn": "crn:[...]",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/60fc731a-1794-4f5d-ba51-ea24b5357207",
        "id": "60fc731a-1794-4f5d-ba51-ea24b5357207",
        "name": "Default"
      },
      "resource_type": "share",
      "size": 40,
      "mount_targets": [
        {
          "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
          "id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
          "name": "mount-target-name1",
          "resource_type": "share_target",
          "vpc": {
            "crn": "crn:[...]",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c2d941de-27f5-432c-b4d0-37a8491c3216",
            "id": "c2d941de-27f5-432c-b4d0-37a8491c3216",
            "name": "vpc-name1",
            "resource_type": "vpc"
          }
        }
      ],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    }
  ]
}

Dans l'exemple, le paramètre de requête " limit spécifie une limite de 50 partages de fichiers, bien que la réponse de l'exemple n'en contienne qu'un seul. La valeur de la propriété access_control_mode est vpc, ce qui signifie que le partage de fichiers peut être monté sur toutes les instances de serveur virtuel dans un VPC. Ce mode de contrôle d'accès est obsolète. Suivez le guide de migration pour mettre à jour le mode de contrôle d'accès de votre partage à security-group.

Affichage d'un partage de fichier unique à l'aide de l'API

Effectuez une demande GET /shares/{share_id} pour obtenir des détails sur un partage de fichiers unique.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-04-01&generation=2"\
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après. Dans cet exemple, le partage a été créé avec le profil " dp2 La valeur de la propriété access_ control_mode est security_group, ce qui signifie que l'accès au partage est déterminé par les règles d'un groupe de sécurité.

{
  "access_control_mode": "security_group",
  "accessor_binding_role": "none",
  "accessor_bindings": [],
  "allowed_access_protocol": "nsf4",
  "allowed_transit_encryption_modes": [
      "none",
      "ipsec"
  ],
  "availability_mode": "zonal",
  "bandwidth": 100,
  "created_at": "2025-04-04T09:17:14.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "id": "r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "iops": 100,
  "latest_job": {
      "status": "succeeded",
      "status_reasons": [],
      "type": "replication_init"
  },
  "lifecycle_reasons": [],
  "lifecycle_state": "stable",
  "mount_targets": [],
  "name": "my-source-share-dal-2",
  "profile": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
      "name": "dp2",
      "resource_type": "share_profile"
  },
  "replica_share": {
      "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "id": "r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "name": "my-replica-share-dal-1",
      "resource_type": "share"
  },
  "replication_role": "source",
  "replication_status": "active",
  "replication_status_reasons": [],
  "resource_group": {
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
      "id": "6edefe513d934fdd872e78ee6a8e73ef",
      "name": "defaults"
  },
  "resource_type": "share",
  "size": 10,
  "snapshot_count": 0,
  "snapshot_size": 0,
  "storage_generation": 1,
  "user_tags": [],
  "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
      "name": "us-south-2"
  }
}

L'exemple suivant montre la réponse renvoyée lorsque vous récupérez les informations d'un fichier régional avec l'API.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-07-23&generation=2"\
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple suivant :

{
  "access_control_mode": "security_group",
  "accessor_binding_role": "none",
  "accessor_bindings": [],
  "allowed_access_protocol": "nsf4",
  "allowed_transit_encryption_modes": [
      "none",
      "stunnel"
  ],
  "availability_mode": "regional",
  "bandwidth": 100,
  "created_at": "2025-06-24T09:17:14.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-4dadac27-cd17-42df-a5fe-1388705d33f1",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "id": "r006-4dadac27-cd17-42df-a5fe-1388705d33ef1",
  "iops": 100,
  "latest_job": {
      "status": "succeeded",
      "status_reasons": [],
      "type": "replication_init"
  },
  "lifecycle_reasons": [],
  "lifecycle_state": "stable",
  "mount_targets": [],
  "name": "my-regional-share-us-south",
  "profile": {
      "family": "defined_performance",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/rfs",
      "name": "rfs",
      "resource_type": "share_profile"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "resource_type": "share",
    "size": 100,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "storage_generation": 2,
    "user_tags": []
}

Répertorier les liaisons de partage d'un partage de fichiers avec l'API

Effectuez une demande GET /shares/{id}/bindings pour obtenir la liste des liaisons d'un partage de fichiers unique. La demande répertorie toutes les liaisons pour un partage. Chaque liaison est implicitement créée lorsqu'un partage d'ID d'accès est créé.

curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings?version=2024-03-20&generation=2"\
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
  "bindings": [
    {
      "accessor": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "id": "r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "name": "my-accessor-share",
        "resource_type": "share"
      },
      "account": {
        "id": "a0000000000000000000000000000001",
        "resource_type": "account"
      },
      "created_at": "2022-01-07T16:56:54Z",
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r006-df760133-3513-47e7-b980-26cca666561b",
      "id": "r006-df760133-3513-47e7-b980-26cca666561b",
      "lifecycle_state": "stable",
      "name": "my-share-bind",
      "resource_type": "share_binding"
    }
  ],
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-65f30e48-3074-4eb0-9ec4-51ce2ec968eb/bindings?limit=20"
  },
  "limit": 50,
  "total_count": 1
}

Affichage d'une liaison spécifique d'un partage de fichiers avec l'API

Effectuez une demande GET /shares/{share_id}/bindings/{binding_id} pour obtenir les informations d'une liaison spécifique d'un partage de fichiers. Cette demande permet de récupérer une seule liaison spécifiée par l'identifiant dans l'URL.

curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings/$binding_id?version=2024-03-20&generation=2"\
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
  "accessor": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "id": "r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "name": "my-accessor-share",
    "resource_type": "share"
  },
  "account": {
    "id": "a0000000000000000000000000000001",
    "resource_type": "account"
  },
  "created_at": "2022-01-07T16:56:54Z",
  "crn": "crn:[...]",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r006-df760133-3513-47e7-b980-26cca666561b",
  "id": "r006-df760133-3513-47e7-b980-26cca666561b",
  "lifecycle_state": "stable",
  "name": "my-share-bind",
  "resource_type": "share_binding"
}

Répertorier toutes les cibles de montage d'un partage de fichiers avec l'API

Effectuez une demande GET /shares/{share_id}/mount_targets pour répertorier toutes les cibles de montage d'un partage de fichiers.

Consultez l'exemple suivant.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets?version=2023-07-18?limit=50&generation=2"\
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple suivant :

{
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets?limit=50"
  },
  "limit": 50,
  "mount_targets": [
    {
      "access_control_mode": "security_group",
      "created_at": "2023-07-18T01:59:46.000Z",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "lifecycle_reasons": [],
      "lifecycle_state": "stable",
      "mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_voll_mz0716_a4cc07a3_4425_4adf_aed6_0d7e142bee0c",
      "name": "my-target",
      "primary_ip": {
        "address": "192.0.2.0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752/reserved_ips/0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
        "id": "0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
        "name": "my-reserved-ip",
        "resource_type": "subnet_reserved_ip"
      },
      "resource_type": "share_mount_target",
      "security_groups": [
        {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
          "id": "r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
          "name": "my-security-group",
          "resource_type": "security_group"
        }
      ],
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752",
        "id": "35984145-9c3a-4626-8ee7-52c7a8742752",
        "name": "my-subnet",
        "resource_type": "subnet"
      },
      "transit_encryption": "none",
      "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/388f01db-41bb-42aa-b5cd-34ba41288d47",
        "id": "388f01db-41bb-42aa-b5cd-34ba41288d47",
        "name": "my-virtual-network-interface",
        "resource_type": "virtual_network_interface"
      },
      "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
        "id": "4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
        "name": "my-vpc",
        "resource_type": "vpc"
      }
    }
  ],
  "total_count": 1
}

Affichage d'une cible de montage unique à l'aide de l'API

Effectuez une demande GET /shares/{share_id}/mount_targets/{mount_target_id} pour obtenir des informations sur une cible de montage unique d'un partage de fichiers. Cet appel inclut les informations sur le chemin de montage. Utilisez le chemin de montage pour connecter un partage de fichiers à une instance.

Voir l'exemple suivant

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$mount_target_id?version=2023-07-18&generation=2"\
-H "Authorization: Bearer $iam_token"

Une réponse réussie ressemble à celle de l'exemple ci-après. Dans cet exemple, le cryptage des données en transit est activé.

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T01:59:46.000Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares//199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
    "id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
    "lifecycle_reasons": [],
    "lifecycle_state": "stable",
    "mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
    "name": "my-mount-target2",
    "primary_ip": {
      "address": "192.0.2.0",
      "href": "https://us-south.iaas.cloud.ibm.com/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a/reserved_ips/b96d456e-88f7-42a7-b02d-450a6d758534",
      "id": "b96d456e-88f7-42a7-b02d-450a6d758534",
      "name": "my-reserved-ip",
      "resource_type": "subnet_reserved_ip"
    },
    "resource_type": "share_mount_target",
    "security_groups": [
      {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/b79365be-f626-45d4-94ae-83f16fa4edd3",
        "id": "b79365be-f626-45d4-94ae-83f16fa4edd3",
        "name": "my-security-group",
        "resource_type": "security_group"
      }
    ],
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a",
      "id": "c2338e66-dcb5-4e9b-b572-108d47ca479a",
      "name": "my-subnet",
      "resource_type": "subnet"
    },
    "transit_encryption": "ipsec",
    "virtual_network_interface": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/4551a68d-b45d-4443-b6b3-aba7a4a18c98",
      "id": "4551a68d-b45d-4443-b6b3-aba7a4a18c98",
      "name": "my-virtual-network-interface",
      "resource_type": "virtual_network_interface"
    },
    "vpc": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/5821d0c4-a089-4957-b5fa-03b7ac636c15",
      "id": "5821d0c4-a089-4957-b5fa-03b7ac636c15",
      "name": "my-vpc",
      "resource_type": "vpc"
    }
  }

Affichage d'un partage de fichiers source pour un partage de fichiers répliqué à l'aide de l'API

Effectuez une demande GET /shares/{replica_id}/source et spécifiez l'ID du partage de réplique pour extraire les détails du partage de fichiers source.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$replica_id/source?version=2023-07-18&generation=2"\
-H "Authorization: Bearer $iam_token"\

Une réponse concluante fournit des détails sur le partage de fichiers source. Notez que le rôle de réplication est source.

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T22:58:49.000Z",
    "crn": "crn:[...]",
    "encryption": "none",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3",
    "id": "207721a9-aff9-4b16-9823-fe68096aeac3",
    "iops": 14400,
    "lifecycle_state": "stable",
    "mount_targets": [
      {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3/mount_targets/ce244454-0919-45e2-b14b-f4285afcd856",
        "id": "ce244454-0919-45e2-b14b-f4285afcd856",
        "name": "my-share-mount-target",
        "resource_type": "share_mount_target",
        "vpc": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
          "id": "c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
          "name": "my-vpc",
          "resource_type": "vpc"
        }
      }
    ],
    "name": "my-share-3",
    "profile": {
      "family": "defined-performance",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
      "name": "dp2",
      "resource_type": "share_profile"
    },
    "replication_role": "source",
    "replication_status": "active",
    "replication_status_reasons": [],
    "resource_group": {
      "crn": "crn:[...]",
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada915d32640909956",
      "id": "678523bcbe2b4eada915d32640909956",
      "name": "Default"
    },
    "resource_type": "share",
    "size": 4800,
    "snapshot_count": 10,
    "snapshot_size": 10,
    "user_tags": [],
    "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
      "name": "us-south-1",
      "resource_type": "zone"
    }
  }

Affichage de tous les partages de fichiers avec Terraform

Importez la liste des partages de fichiers appartenant à un compte en tant que source de données en lecture seule. Vous pouvez filtrer par nom de partage ou ID de groupe de ressources.

data "ibm_is_shares" "example" {
}

Les attributs exportés incluent le nombre total de partages et la liste des partages. Les attributs imbriqués incluent l'ID de partage, le nom, la date de création, la taille, les IOPS, le CRN, les balises d'accès, le type et la clé de chiffrement, l'état du cycle de vie, le rôle et le statut de réplication, la cible de montage et d'autres attributs.

Pour plus d'informations, voir ibm_is_shares.

Affichage des informations de partage de fichiers avec Terraform

Importez les détails d'un partage de fichiers en tant que source de données en lecture seule. Vous devez identifier le partage par ID ou nom.

data "ibm_is_share" "example" {
  share = ibm_is_share.example.id
}

data "ibm_is_share" "example" {
  name = ibm_is_share.example.name
}

Les attributs exportés incluent l'ID, le nom, la date de création, la taille, les E-S/s, le CRN, les balises d'accès, le type de chiffrement, la clé de chiffrement, l'état du cycle de vie, le rôle et le statut de réplication, la cible de montage et d'autres attributs.

Pour plus d'informations, voir ibm_is_share.

Affichage des cibles de montage associées à un partage de fichiers avec Terraform

Importez la liste des cibles de montage associées à un partage de fichiers en tant que source de données en lecture seule. Identifiez le partage de fichiers par son ID.

data "ibm_is_share_mount_targets" "example" {
  share = ibm_is_share.example.id
}

Les attributs exportés comprennent la liste des cibles de montage ainsi que leurs identifiants, leurs noms, leurs dates de création, leurs chemins de montage et les informations relatives au sous-réseau.

Pour plus d'informations, voir ibm_is_share_mount_targets.

Affichage des informations de cible de montage avec Terraform

Importez les détails d'une cible de montage en tant que source de données en lecture seule. Identifiez la cible de montage en spécifiant l'ID de partage et l'ID de la cible de montage. Les deux arguments sont requis.

data "ibm_is_share_mount_target" "example" {
  share        = ibm_is_share.example.id
  mount_target = ibm_is_share_mount_target.example.mount_target
}

Les attributs exportés incluent l'ID, le nom, la date de création, le chemin de montage, les informations de sous-réseau et d'autres attributs.

Pour plus d'informations, voir ibm_is_share_mount_target.