Renommer un partage de fichiers dans la console

1. Sur la page Détails des partages de fichiers, cliquez sur l'icône Editer en regard du nom du partage de fichiers.

2. Spécifiez un nouveau nom pour le partage de fichiers.

Les noms de fichier valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Les noms de partage de fichiers doivent commencer par une lettre minuscule.

Renommer une cible de montage d'un partage de fichiers dans la console

1. Accédez à la page Détails des partages de fichiers.
2. Cliquez sur l'icône Actions .
3. Sélectionnez Renommer.
4. Entrez un nouveau nom et cliquez sur Renommer.

Les noms de cible de montage valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Ils doivent commencer par une lettre minuscule.

Mise à jour d'un profil de partage de fichiers dans la console

Ces instructions concernent la génération précédente de profils de partage de fichiers (usage général, 5-iops, 10-iops ou personnalisé) qui ont été utilisés dans la version bêta des partages de fichiers zonaux. A partir du 06 mai 2026, ces profils d'actions sont dépréciés. Pour accéder aux fonctionnalités actuelles, vous devez changer le profil IOPS de votre partage en dp2. Les profils des partages de fichiers qui ont été créés avec le profil dp2 ou rfs ne peuvent pas être modifiés.

Vous pouvez modifier le profil d'un partage de fichiers du profil en cours vers un autre profil de niveau IOPS, vers un profil personnalisé ou vers un profil dp2 hautes performances. Votre facturation s'adapte en fonction du profil que vous avez choisi.

1. Accédez à la page Détails des partages de fichiers.
2. Cliquez sur l'icône Editer en regard du profil en cours ou utilisez le menu Actions et sélectionnez Editer le profil IOPS. Un panneau latéral affiche le profil en cours, la taille de partage de fichiers et le nombre maximal d'IOPS.
3. Pour un nouveau profil, cliquez sur la flèche vers le bas. Vous pouvez sélectionner un nouveau niveau d'IOPS, un profil personnalisé ou dp2. Pour IOPS personnalisées ou dp2, indiquez un nouveau nombre maximal d'IOPS en fonction de la taille du partage de fichiers. Le prix du partage de fichiers est automatiquement calculé en fonction de votre sélection.
4. Cliquez sur « Enregistrer et continuer ».

Mise à jour des modes de cryptage de transit autorisés dans la console

Le propriétaire d'un partage peut modifier les modes de cryptage de transit autorisés. Toutefois, pour que cette propriété puisse être modifiée, toutes les liaisons doivent être supprimées. La suppression des liaisons entraîne la suppression du chemin réseau entre le partage de fichiers d'origine et le partage d'ID d'accès, et place la cible de montage associée au partage d'ID d'accès à l'état d'échec. Pour plus d'informations, voir Retrait de l'accès à un partage de fichiers d'autres comptes.

1. Sélectionnez un partage de fichiers dans la liste des partages de fichiers.
2. Sur la page Détails du partage de fichiers, recherchez les modes de chiffrement de transit autorisés.
3. Cliquez sur l'icône Editer pour modifier la valeur en cours.

Renommer un partage de fichiers depuis l'interface de ligne de commande

1. Localisez le partage de fichiers que vous souhaitez renommer en répertoriant les partages de fichiers dans la région à l'aide de la commande ibmcloud is shares. Notez le nom et l'identifiant du partage de fichiers.

   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
   r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2        10         defaults         none               none                    0                0
   r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2        10         defaults         none               none                    0                0
   r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2        10         defaults         replica            none                    0                0
   r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2        10         defaults         source             none                    0                0
   r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2        10         defaults         replica            none                    0                0
   r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2        10         defaults         source             none                    0                0
   r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
   

2. Exécutez la commande ibmcloud is share-update et indiquez un nouveau nom de partage de fichiers avec les options --name.

   ibmcloud is share-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 --name my-renamed-share
   

   Updating file share r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 under account Test Account as user test.user@ibm.com...
   ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Name                         my-renamed-share
   CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Lifecycle state              stable
   Access control mode          vpc
   Zone                         us-south-2
   Profile                      dp2
   Size(GB)                     100
   IOPS                         100
   Encryption                   ipsec
   Mount Targets                ID                          Name
                                No mounted targets found.
   Resource group               ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
   Created                      2023-08-01T17:02:01+00:00
   Encryption key               crn:v1:bluemix:public:kms:eu-de:a/a1234567:key:f602ae93-b915-49bc-a0e1-af29c73e7788
   Latest job                   Job status   Job status reasons
                                -            -
   Replication cron spec        00 11 * * 0
   Replication role             replica
   Replication status           none
   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
   

Les noms de fichier valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Les noms de partage de fichiers doivent commencer par une lettre minuscule.

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

Renommer une cible de montage d'un partage de fichiers depuis l'interface en ligne de commande

1. Répertoriez les partages de fichiers dans la région à l'aide de la commande ibmcloud is shares. Notez le nom et l'ID du partage de fichiers contenant la cible de montage que vous souhaitez renommer.

2. Utilisez le nom ou l'ID du partage pour trouver ses cibles de montage à l'aide de la commande ibmcloud is share-mount-targets.

   ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   

   Listing share mount target of r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 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
   

3. Pour renommer la cible de montage, exécutez la commande share-mount-target-update avec le nom ou l'ID du partage de fichiers et le nom de la cible de montage. Indiquez un nouveau nom de cible de montage avec l'option --name.

   ibmcloud is share-mount-target-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 r006-fdbffc45-618c-49f1-bb08-ec530d7be378 --name my-renamed-mount-target
   

Les noms de cible de montage valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Ils doivent commencer par une lettre minuscule.

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

Mise à jour d'un profil de partage de fichiers via l'interface de ligne de commande (CLI)

Ces instructions concernent la génération précédente de profils de partage de fichiers (usage général, 5-iops, 10-iops ou personnalisé) qui ont été utilisés dans la version bêta des partages de fichiers zonaux. A partir du 06 mai 2026, ces profils d'actions sont dépréciés. Pour accéder aux fonctionnalités actuelles, vous devez changer le profil IOPS de votre partage en dp2. Les profils des partages de fichiers qui ont été créés avec le profil dp2 ou rfs ne peuvent pas être modifiés.

1. Recherchez le partage de fichiers à mettre à jour en répertoriant les partages de fichiers dans la 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
   r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2        10         defaults         none               none                    0                0
   r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2        10         defaults         none               none                    0                0
   r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2        10         defaults         replica            none                    0                0
   r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2        10         defaults         source             none                    0                0
   r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2        10         defaults         replica            none                    0                0
   r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2        10         defaults         source             none                    0                0
   r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
   

2. Utilisez la commande share-update avec le paramètre --profile pour indiquer le nouveau profil de partage de fichiers par nom.

   ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000
   

   Updating file share my-file-share-8 under account Test Account as user test.user@ibm.com...
   ID                           r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
   Name                         my-old-file-share
   CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
   Lifecycle state              updating
   Access control mode          vpc
   Zone                         us-south-1
   Profile                      dp2
   Size(GB)                     1000
   IOPS                         3000
   User Tags                    env:dev,env:prod
   Encryption                   provider_managed
   Mount Targets                ID                                          Name
                                r006-c9d82a15-7ead-4388-abc8-88e81c12ed28   my-target121
   Resource group               ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
   Created                      2023-03-27T20:43:36+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     nfs4
   Availability Mode            zonal
   Bandwidth(Mbps)              1
   Storage Generation           1
   

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

Mise à jour des modes de cryptage de transit autorisés à partir de la CLI

Le propriétaire du partage peut mettre à jour les modes de cryptage de transit autorisés avec les valeurs suivantes.

• Pour les partages de fichiers zonaux, les valeurs autorisées sont ipsec,none,ipsec, ou none.
• Pour les partages de fichiers régionaux, les valeurs autorisées sont stunnel,none, stunnel, ou none.

Cependant, avant de pouvoir modifier cette propriété, toutes les liaisons et les cibles de montage doivent être supprimées. La suppression des liaisons entraîne la suppression du chemin réseau entre le partage de fichiers d'origine et le partage d'ID d'accès, et place la cible de montage associée au partage d'ID d'accès à l'état d'échec. Pour plus d'informations, voir Suppression de l'accès à un partage de fichiers à partir d'autres comptes.

ibmcloud is share-update my-origin-share --allowed-transit-encryption-modes ipsec

Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                               r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                             my-origin-share
CRN                              crn:v1:bluemix:public:is:us-south-2:a/1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state                  stable
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec
Origin share CRN                                                                                             Name            Remote account  Remote region
                                 crn:v1:bluemix:public:is:us-south-2:a/7654321::share:r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed  my-origin-share a7654321        -
Zone                             us-south-2
Profile                          dp2
Size(GB)                         1000
IOPS                             1000
Encryption                       provider_managed
Mount Targets                    ID                          Name
                                 No mounted targets found.
Resource group                   ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
Created                          2024-06-25T22:15:15+00:00
Replication role                 none
Replication status               none
Replication status reasons       Status code   Status message
                                 -             -
 Allowed Access Protocols        nfs4
 Availability Mode               zonal
 Bandwidth(Mbps)                 1
 Storage Generation              1

Renommer un partage de fichiers à l'aide de l'API

Créez un appel PATCH /shares/$share_id pour renommer un partage de fichiers spécifique. Consultez l'exemple suivant.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"\
  -d '{"name": "share-renamed1"}'

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

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-17T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "id": "0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-renamed1",
  "profile": {
    "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/bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "id": "bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 100,
  "mount_targets": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Les noms de fichier valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Les noms de partage de fichiers doivent commencer par une lettre minuscule.

Renommer une cible de montage d'un partage de fichiers à l'aide de l'API

Effectuez un appel « PATCH /shares/$share_id/mount_targets/$target_id » pour renommer une cible de montage d'un partage de fichiers. Consultez l'exemple suivant.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{"name": "target-renamed1"}

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

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-18T23:31:59Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_state": "stable",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
  "name": "target-renamed1",
  "resource_type": "share_target",
  "transit_encryption": "none",
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs8c95b3c1-fe3c-45c-97a6-e43d14088287",
    "id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
    "name": "vpc-name1",
    "resource_type": "vpc"
  }
}

Les noms de cible de montage valides peuvent inclure une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et un trait d'union (-), jusqu'à 63 caractères. Ils doivent commencer par une lettre minuscule.

Mise à jour d'un profil de partage de fichiers via l'API

Ces instructions concernent la génération précédente de profils de partage de fichiers (usage général, 5-iops, 10-iops ou personnalisé) qui ont été utilisés dans la version bêta des partages de fichiers zonaux. A partir du 06 mai 2026, ces profils d'actions sont dépréciés. Pour accéder aux fonctionnalités actuelles, vous devez changer le profil IOPS de votre partage en dp2. Les profils des partages de fichiers qui ont été créés avec le profil dp2 ou rfs ne peuvent pas être modifiés.

Effectuez un appel PATCH /shares/{share_ID} et spécifiez le nom de profil dans la propriété profile. L'exemple suivant modifie le profil en profil dp2.

curl -X PATCH "$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{"profile": {"name": "dp2"}}'

Mise à jour des modes de chiffrement de transit autorisés avec l'API

Le propriétaire du partage peut mettre à jour les modes de cryptage de transit autorisés avec les valeurs suivantes.

• Pour les partages de fichiers zonaux, les valeurs autorisées sont ipsec,none,ipsec, ou none.
• Pour les partages de fichiers régionaux, les valeurs autorisées sont stunnel,none, stunnel, ou none.

Cependant, avant de pouvoir modifier cette propriété, toutes les liaisons et les cibles de montage doivent être supprimées. La suppression des liaisons entraîne la suppression du chemin réseau entre le partage de fichiers d'origine et le partage d'ID d'accès, et place la cible de montage associée au partage d'ID d'accès à l'état d'échec. Pour plus d'informations, voir Retrait de l'accès à un partage de fichiers d'autres comptes.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"
  -d '{"allowed_transit_encryption_modes": "ipsec"}'

Mise à jour des attributs d'un partage de fichiers avec Terraform

Mettez à jour la ressource ibm_is_share pour modifier les attributs du partage de fichiers, tels que le nom, la taille, le profil et les balises. Lorsqu'il est appliqué, l'exemple suivant met à jour le nom du partage dans new_name.

resource "ibm_is_share" "example" {
  name    = "new_name"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

Les noms valides pour un partage de fichiers et une cible de montage peuvent comporter une combinaison de caractères alphanumériques en minuscules (a-z, 0-9) et de tirets (-), dans la limite de 63 caractères. Les noms de partage de fichiers doivent commencer par une lettre minuscule.

Certains attributs, tels que le profil, les modes de chiffrement de transit autorisés et le chiffrement au repos, ne sont pas modifiables pour les partages d'accesseurs.

Le propriétaire du partage peut mettre à jour les modes de cryptage de transit autorisés avec les valeurs suivantes.

• Pour les partages de fichiers zonaux, les valeurs autorisées sont ipsec,none,ipsec, ou none.
• Pour les partages de fichiers régionaux, les valeurs autorisées sont stunnel,none, stunnel, ou none.

Cependant, avant de pouvoir modifier cette propriété, toutes les liaisons et les cibles de montage doivent être supprimées. La suppression des liaisons entraîne la suppression du chemin réseau entre le partage de fichiers d'origine et le partage d'ID d'accès, et place la cible de montage associée au partage d'ID d'accès à l'état d'échec. Pour plus d'informations, voir Suppression de l'accès à un partage de fichiers à partir d'autres comptes.

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_share.

Mise à jour des attributs d'une cible de montage avec Terraform

Mettez à jour la ressource ibm_is_share_mount_target pour modifier le nom de la cible de montage. Lorsqu'elle est appliquée, la ressource suivante remplace le nom de la cible de montage par my-new-share-target.

resource "ibm_is_share_mount_target" "is_share_target" {
  access_protocol    = "nfs4"
  name               = "my-new-share-target"
  share              = is_share.is_share.id
  subnet             = ibm_is_subnet.example.id
}`

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_share_target.