Umbenennen einer Dateifreigabe in der Konsole

1. Klicken Sie auf der Seite Details zur Dateifreigabe auf das Symbol Symbol 'Bearbeiten' neben dem Namen der Dateifreigabe.

2. Geben Sie einen neuen Namen für die Dateifreigabe an.

Gültige Dateifreigabenamen können eine bis zu 63 Zeichen lange Kombination aus alphanumerischen Zeichen in Kleinschreibung (a-z, 0-9) und Bindestrichen (-) enthalten. Dateinamen für Dateifreigaben müssen mit einem Kleinbuchstaben beginnen.

Umbenennen eines Einbindungsziels einer Dateifreigabe in der Konsole

1. Rufen Sie die Seite Dateifreigaben-Details auf.
2. Klicken Sie auf das Symbol 'Aktionen' .
3. Wählen Sie Umbenennen aus.
4. Geben Sie einen neuen Namen ein und klicken Sie auf Umbenennen.

Gültige Mountzielnamen können eine bis zu 63 Zeichen lange Kombination aus alphanumerischen Zeichen in Kleinschreibung (a-z, 0-9) und Bindestrichen (-) enthalten. Mountzielnamen müssen mit einem Kleinbuchstaben beginnen.

Aktualisieren eines Dateifreigabeprofils in der Konsole

Diese Anweisungen gelten für die vorherige Generation von Dateifreigabeprofilen (Allzweck-, 5-iops-, 10-iops- oder benutzerdefinierte Profile), die in der Beta-Version der zonalen Dateifreigaben verwendet wurden. Ab dem 06. Mai 2026 sind diese Aktienprofile veraltet. Um die aktuellen Funktionen nutzen zu können, müssen Sie das IOPS-Profil Ihrer Freigabe auf dp2 ändern. Die Profile von Dateifreigaben, die mit dem dp2 oder dem rfs Profil erstellt wurden, können nicht geändert werden.

Sie können das Profil für eine Dateifreigabe vom aktuellen Profil in ein anderes IOPS-Schichtprofil, in ein angepasstes Profil oder in ein leistungsfähiges dp2-Profil ändern. Ihre Abrechnung wird auf der Grundlage des von Ihnen gewählten Profils angepasst.

1. Rufen Sie die Seite Dateifreigaben-Details auf.
2. Klicken Sie auf das Bearbeitungssymbol neben dem aktuellen Profil oder verwenden Sie das Menü Aktionen und wählen Sie IOPS-Profil bearbeiten aus. In einer Seitenanzeige werden das aktuelle Profil, die Dateifreigabegröße und die maximale Anzahl E/A-Operationen pro Sekunde angezeigt.
3. Klicken Sie für Neues Profil auf den Abwärtspfeil. Sie können eine neue IOPS-Stufe, ein angepasstes Profil oder dp2auswählen. Geben Sie für Angepasste IOPS oder dp2 einen neuen maximalen IOPS-Wert auf der Basis der Dateifreigabegröße an. Der Dateifreigabepreis wird basierend auf Ihrer Auswahl automatisch berechnet.
4. Klicken Sie auf „ Speichern und fortfahren “.

Aktualisierung der zulässigen Transitverschlüsselungsmodi in der Konsole

Der Eigentümer einer Freigabe kann die zulässigen Transitverschlüsselungsmodi ändern. Bevor diese Eigenschaft geändert werden kann, müssen jedoch alle Bindungen gelöscht werden. Durch Löschen der Bindungen wird der Netzpfad zwischen der ursprünglichen Dateifreigabe und der Zugriffsmechanismusfreigabe entfernt und das Mountziel, das der Zugriffsmechanismusfreigabe zugeordnet ist, in den Status "Fehlgeschlagen" versetzt. Weitere Informationen finden Sie unter Zugriff auf eine Dateifreigabe von anderen Konten entfernen.

1. Wählen Sie eine Dateifreigabe in der Liste der Dateifreigaben aus.
2. Suchen Sie auf der Detailseite der Dateifreigabe nach den zulässigen Übertragungsverschlüsselungsmodi.
3. Klicken Sie auf das Symbol Bearbeiten , um den aktuellen Wert zu ändern.

Umbenennen einer Dateifreigabe über die Befehlszeile

1. Suchen Sie die Dateifreigabe, die Sie umbenennen möchten, indem Sie die Dateifreigaben in der Region mit dem Befehl ibmcloud is shares auflisten. Notieren Sie sich den Namen und die ID der Dateifreigabe.

   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. Führen Sie den Befehl ibmcloud is share-update aus und geben Sie einen neuen Dateifreigabenamen mit den Optionen --name an.

   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
   

Gültige Dateifreigabenamen können eine bis zu 63 Zeichen lange Kombination aus alphanumerischen Zeichen in Kleinschreibung (a-z, 0-9) und Bindestrichen (-) enthalten. Dateinamen für Dateifreigaben müssen mit einem Kleinbuchstaben beginnen.

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is share-update.

Umbenennen eines Einhängeziels einer Dateifreigabe über die Befehlszeile

1. Listen Sie die Dateifreigaben in der Region mit dem Befehl ibmcloud is shares auf. Notieren Sie den Namen und die ID der Dateifreigabe, die das Mountziel enthält, das Sie umbenennen möchten.

2. Verwenden Sie den Namen oder die ID der Freigabe, um ihre Mountziele mit dem Befehl ibmcloud is share-mount-targets zu suchen.

   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. Um das Mountziel umzubenennen, führen Sie den Befehl share-mount-target-update mit dem Namen oder der ID der Dateifreigabe und dem Namen des Mountzieles aus. Geben Sie einen neuen Mountzielnamen mit der Option --name an.

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

Gültige Mountzielnamen können eine bis zu 63 Zeichen lange Kombination aus alphanumerischen Zeichen in Kleinschreibung (a-z, 0-9) und Bindestrichen (-) enthalten. Mountzielnamen müssen mit einem Kleinbuchstaben beginnen.

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is share-mount-target-update.

Aktualisieren eines Dateifreigabeprofils über die Befehlszeilenschnittstelle

Diese Anweisungen gelten für die vorherige Generation von Dateifreigabeprofilen (Allzweck-, 5-iops-, 10-iops- oder benutzerdefinierte Profile), die in der Beta-Version der zonalen Dateifreigaben verwendet wurden. Ab dem 06. Mai 2026 sind diese Aktienprofile veraltet. Um die aktuellen Funktionen nutzen zu können, müssen Sie das IOPS-Profil Ihrer Freigabe auf dp2 ändern. Die Profile von Dateifreigaben, die mit dem dp2 oder dem rfs Profil erstellt wurden, können nicht geändert werden.

1. Suchen Sie die Dateifreigabe, die Sie aktualisieren wollen, indem Sie die Dateifreigaben in der Region mit dem Befehl ibmcloud is shares auflisten.

   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. Verwenden Sie den Befehl share-update mit dem Parameter --profile, um das neue Dateifreigabeprofil nach Namen anzugeben.

   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
   

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is share-update.

Aktualisierung der zulässigen Transitverschlüsselungsmodi über die CLI

Der Eigentümer der Freigabe kann die zulässigen Transitverschlüsselungsmodi mit den folgenden Werten aktualisieren.

• Für zonale Dateifreigaben sind die zulässigen Werte ipsec,none,ipsec oder none.
• Für regionale Dateifreigaben sind die Werte stunnel,none, stunnel oder none zulässig.

Bevor diese Eigenschaft jedoch geändert werden kann, müssen alle Bindungen und Mount-Ziele gelöscht werden. Durch Löschen der Bindungen wird der Netzpfad zwischen der ursprünglichen Dateifreigabe und der Zugriffsmechanismusfreigabe entfernt und das Mountziel, das der Zugriffsmechanismusfreigabe zugeordnet ist, in den Status "Fehlgeschlagen" versetzt. Weitere Informationen finden Sie unter Entfernen des Zugriffs auf eine Dateifreigabe von anderen Konten.

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

Umbenennen einer Dateifreigabe über die API

Führen Sie den Aufruf PATCH /shares/$share_id aus, um eine bestimmte Dateifreigabe umzubenennen. Beispiel:

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"}'

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.

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

Gültige Dateifreigabenamen können eine bis zu 63 Zeichen lange Kombination aus alphanumerischen Zeichen in Kleinschreibung (a-z, 0-9) und Bindestrichen (-) enthalten. Dateinamen für Dateifreigaben müssen mit einem Kleinbuchstaben beginnen.

Umbenennen eines Einhängeziels einer Dateifreigabe über die API

Führen Sie den Befehl „ PATCH /shares/$share_id/mount_targets/$target_id “ aus, um ein Einhängeziel einer Dateifreigabe umzubenennen. Beispiel:

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.

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

Gültige Mountzielnamen können eine bis zu 63 Zeichen lange Kombination aus alphanumerischen Zeichen in Kleinschreibung (a-z, 0-9) und Bindestrichen (-) enthalten. Mountzielnamen müssen mit einem Kleinbuchstaben beginnen.

Ein Dateifreigabeprofil über die API aktualisieren

Diese Anweisungen gelten für die vorherige Generation von Dateifreigabeprofilen (Allzweck-, 5-iops-, 10-iops- oder benutzerdefinierte Profile), die in der Beta-Version der zonalen Dateifreigaben verwendet wurden. Ab dem 06. Mai 2026 sind diese Aktienprofile veraltet. Um die aktuellen Funktionen nutzen zu können, müssen Sie das IOPS-Profil Ihrer Freigabe auf dp2 ändern. Die Profile von Dateifreigaben, die mit dem dp2 oder dem rfs Profil erstellt wurden, können nicht geändert werden.

Erstellen Sie einen Aufruf PATCH /shares/{share_ID} und geben Sie den Profilnamen in der Eigenschaft profile an. Im folgenden Beispiel wird das Profil in ein dp2-Profil geändert.

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"}}'

Zulässige Transitverschlüsselungsmodi mit der API aktualisieren

Der Eigentümer der Freigabe kann die zulässigen Transitverschlüsselungsmodi mit den folgenden Werten aktualisieren.

• Für zonale Dateifreigaben sind die zulässigen Werte ipsec,none,ipsec oder none.
• Für regionale Dateifreigaben sind die Werte stunnel,none, stunnel oder none zulässig.

Bevor diese Eigenschaft jedoch geändert werden kann, müssen alle Bindungen und Einhängeziele gelöscht werden. Durch Löschen der Bindungen wird der Netzpfad zwischen der ursprünglichen Dateifreigabe und der Zugriffsmechanismusfreigabe entfernt und das Mountziel, das der Zugriffsmechanismusfreigabe zugeordnet ist, in den Status "Fehlgeschlagen" versetzt. Weitere Informationen finden Sie unter Zugriff auf eine Dateifreigabe von anderen Konten entfernen.

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"}'

Attribute einer Dateifreigabe mit Terraform aktualisieren

Aktualisieren Sie die Ressource ibm_is_share, um alle Attribute der Dateifreigabe wie Name, Größe, Profil und Tags zu ändern. Wenn das folgende Beispiel angewendet wird, wird der Name der Freigabe in new_name aktualisiert.

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

Gültige Namen für Dateifreigaben und Einhängeziele dürfen aus einer Kombination aus Kleinbuchstaben, Ziffern (a–z, 0–9) und dem Bindestrich (-) bestehen und bis zu 63 Zeichen lang sein. Dateinamen für Dateifreigaben müssen mit einem Kleinbuchstaben beginnen.

Einige Attribute, wie z. B. Profil, zulässige Transitverschlüsselungsmodi und Verschlüsselung im Ruhezustand, können für Accessor-Freigaben nicht bearbeitet werden.

Der Eigentümer der Freigabe kann die zulässigen Transitverschlüsselungsmodi mit den folgenden Werten aktualisieren.

• Für zonale Dateifreigaben sind die zulässigen Werte ipsec,none,ipsec oder none.
• Für regionale Dateifreigaben sind die Werte stunnel,none, stunnel oder none zulässig.

Bevor diese Eigenschaft jedoch geändert werden kann, müssen alle Bindungen und Mount-Ziele gelöscht werden. Durch Löschen der Bindungen wird der Netzpfad zwischen der ursprünglichen Dateifreigabe und der Zugriffsmechanismusfreigabe entfernt und das Mountziel, das der Zugriffsmechanismusfreigabe zugeordnet ist, in den Status "Fehlgeschlagen" versetzt. Weitere Informationen finden Sie unter Entfernen des Zugriffs auf eine Dateifreigabe von anderen Konten.

Weitere Informationen zu den Argumenten und Attributen finden Sie unter ibm_is_share.

Attribute eines Mountziels mit Terraform aktualisieren

Aktualisieren Sie die Ressource ibm_is_share_mount_target, um den Namen des Mountziels zu ändern. Nach der Anwendung ändert die folgende Ressource den Namen des Mountziels in 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
}`

Weitere Informationen zu den Argumenten und Attributen finden Sie unter ibm_is_share_target.