Kapazität der Dateifreigabe erweitern

Erweitern Sie die Kapazität der Dateifreigabe unter „ File Storage for VPC “ auf bis zu 32.000 GB – ohne Ausfallzeiten oder Datenmigration. Die Abrechnung wird automatisch an die neue Kapazität angepasst.

Die Abrechnung für den Datenträger wird automatisch aktualisiert, um den anteilsmäßigen Unterschied des neuen Preises zum aktuellen Abrechnungszyklus hinzuzufügen. Der neue Betrag wird dann vollständig erst im nächsten Abrechnungszyklus in Rechnung gestellt.

Konzepte für erweiterbare Dateifreigaben

Sie können die Kapazität der Dateifreigabe erhöhen. Die Dateifreigabegröße darf nicht kleiner als die aktuelle Dateifreigabegröße sein.

Die Kapazität kann für Dateifreigaben, die sich in einem stable Status befinden, erhöht werden. Ihre Benutzerberechtigung wird überprüft, bevor die Dateifreigabe erweitert wird. Sie können die Benutzeroberfläche, die Befehlszeilenschnittstelle, die API oder Terraform verwenden, um die Kapazität der Dateifreigabe zu erhöhen. Sie können eine Dateifreigabe mehrmals bis zu ihrer maximalen Kapazitätsgrenze erweitern. Nachdem die Dateifreigabe erweitert wurde, können Sie die Kapazität nicht reduzieren.

Die erweiterte Kapazität wird anhand der durch das Profil der Dateifreigabe festgelegten maximalen Kapazität bestimmt.

Verfügbarkeit auswählen Die regionalen Dateifreigaben, die mit dem Profil rfs erstellt werden, können ohne Einschränkungen auf bis zu 32 TB erweitert werden.

Zonale Dateifreigaben, die mit dem Profil dp2 oder dem benutzerdefinierten Profil Deprecated erstellt wurden, können innerhalb des zulässigen IOPS-Bereichs für diese Dateifreigabegröße erweitert werden.

Zonale Dateifreigaben, die mit einem der veraltetenIOPS-Tier-Profile erstellt wurden, können auf die maximale Größe für ihr IOPS-Tier erweitert werden:

  • Ein allgemeines Profil mit 3 IOPS/GB kann bis auf 32.000 GB erweitert werden.
  • Ein Profil mit 5 IOPS/GB kann auf bis zu 9.600 GB erweitert werden.
  • Ein Profil mit 10 IOPS/GB kann auf 4.800 GB erweitert werden.

Die IOPS-Werte werden für die veralteten, gestaffelten Dateifreigabeprofile automatisch anhand der Größe der Dateifreigabe angepasst. Wenn Sie beispielsweise eine Freigabe mit einem 5-IOPS/GB-Profil von 250 GB auf 1.000 GB erweitern, hat sie eine maximale IOPS von 5.000 IOPS (1.000 GB Kapazität x 5 IOPS). Da eine Dateifreigabe mit 5 IOPS/GB potenziell auf 9.600 GB anwachsen kann, wird die maximale IOPS-Zahl auf 48.000 IOPS angepasst. Die Kapazität und die IOPS werden sofort angepasst, und Sie müssen die Instanz nicht neu starten.

Sie können den Fortschritt Ihrer Dateifreigabeerweiterung über die Benutzerschnittstelle oder die Befehlszeilenschnittstelle überwachen. Sie können auch die Ereignisse in der Aktivitätsprotokollierung überprüfen, um sicherzustellen, dass die Dateifreigabe erweitert wurde. Nachdem eine Dateifreigabe erweitert wurde, können Sie die Kapazität nicht reduzieren.

Anforderungen

Die Dateifreigabe muss sich im Status „ stable “ befinden, bevor Sie eine Kapazitätserweiterung beantragen können.

Einschränkungen

Für dieses Release gelten die folgenden Einschränkungen.

  • Dateifreigaben können erweitert werden, wobei jedoch die folgenden Einschränkungen gelten:
    • Wenn die Dateifreigabe mit einem „Tiered“-Profil erstellt wurde, das die Kapazität auf weniger als 32.000 GB begrenzt, kann sie nur bis zur für diese Stufe zulässigen Kapazität erweitert werden.
    • Wenn die Dateifreigabe mit dem Profil "Benutzerdefiniert" in einem IOPS-Bereich erstellt wurde, der keine Erweiterung auf 16.000 GB zulässt, kann die Freigabe nur bis zur maximalen Kapazität des angegebenen Bereichs erweitert werden.
    • Wenn die Dateifreigabe mit dem Profil dp2 in einem IOPS-Bereich erstellt wurde, der keine Erweiterung auf 32.000 GB zulässt, kann die Freigabe nur bis zur maximalen Kapazität des angegebenen Bereichs erweitert werden.
    • Dateifreigaben können mehrere Male erweitert werden, bis die maximale Kapazität erreicht ist.
  • Erhöhung der IOPS auf den vom Profil zugelassenen Höchstwert.
  • Der IOPS-Wert für eine Dateifreigabe, die aus einem IOPS-Tier-Profil erstellt wurde, kann nicht unabhängig geändert werden. Die IOPS-Leistung wird angepasst, wenn Sie die Kapazität erweitern.
  • Wenn Sie eine Dateifreigabe erweitern, die aus einem angepassten Profil oder einem dp2-Profil erstellt wurde, wird die Kapazität erhöht, aber die E/A-Operationen pro Sekunde bleiben unverändert, es sei denn, Sie entscheiden sich für Anpassung der E/A-Operationen pro Sekunde.
  • Die maximale IOPS-Rate für eine zonale Dateifreigabe ist auf 48.000 IOPS begrenzt, wenn der Zugriff von einem einzelnen Host erfolgt. Bei einer zonalen Dateifreigabe, auf die mehrere Hosts zugreifen, können die IOPS bis zu 96.000 IOPS erreichen.
  • Nachdem eine Dateifreigabe erweitert wurde, können Sie ihre Größe nicht reduzieren.

Erweitern der Dateifreigabekapazität in der Konsole

Befolgen Sie diese Schritte, um die Kapazität der Dateifreigabe in der Konsole zu erweitern:

  1. Klicken Sie in der Konsole IBM Cloud auf das Symbol Navigation > Infrastruktur VPC > Storage > File Storage Shares.

  2. Auf der Listenseite 'Dateifreigaben für VPC' werden alle Dateifreigaben angezeigt, die in dieser Zone erstellt wurden. Klicken Sie auf den Namen einer Dateifreigabe, um die Detailseite anzuzeigen.

  3. Erweitern Sie auf der Detailseite für Dateifreigaben das Menü Aktionen.

  4. Wählen Sie Dateifreigabe erweitern aus. Im Bereich „Dateifreigabe vergrößern“ werden die aktuelle Größe der Dateifreigabe (in GB) sowie das zugehörige Profil angezeigt. Alternativ können Sie auf das Bearbeitungssymbol neben den Angaben zur Größe der Dateifreigabe klicken.

  5. Geben Sie basierend auf dem maximal zulässigen Wert für das Dateifreigabeprofil einen höheren Wert für die Größe der Dateifreigabe ein. Der Standardwert ist die aktuelle Größe + 1 GB.

  6. Überprüfen Sie die geschätzte monatliche Bestellübersicht für Ihre Geografie und die neue Preisgestaltung.

  7. Klicken Sie auf Speichern und fortfahren, wenn Sie einverstanden sind.

Ihre neue Dateispeicherzuordnung steht nach wenigen Minuten zur Verfügung. Wenn sich Ihre Anforderungen ändern, können Sie die Kapazität erneut erhöhen, nachdem die Größe der Dateifreigabe erhöht wurde und die Dateifreigabe einen stable Status aufweist.

Nachdem Sie die Kapazität der Dateifreigabe erweitert haben, können Sie deren Größe nicht mehr verringern.

Dateifreigaben über die Befehlszeilenschnittstelle erweitern

Verwenden Sie zum Erhöhen der Kapazität einer Dateifreigabe über die Befehlszeilenschnittstelle den Befehl share-update mit der Option --size und geben Sie die neue Größe der Dateifreigabe in GB an.

  1. Suchen Sie Ihre Freigabe über die Befehlszeilenschnittstelle, indem Sie Ihre 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

  2. Zeigen Sie die Details der Dateifreigabe an, die Sie mit dem Befehl ibmcloud is share ändern wollen.

    ibmcloud is share my-file-share

 ```sh {: screen}
 Getting file share my-file-share under account Test Account as user test.user@ibm.com...
 ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
 Name                         my-file-share
 CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
 Lifecycle state              stable
 Access control mode          security_group
 Accessor binding role        none
 Zone                         us-south-2
 Profile                      dp2
 Size(GB)                     1000
 IOPS                         1000
 User Tags                    docs:test
 Encryption                   provider_managed
 Mount Targets                ID                                          Name
                              r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
 Resource group               ID                                 Name
                              db8e8d865a83e0aae03f25a492c5b39e   Default
 Created                      2023-10-18T22: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     nfs4
 Availability Mode            zonal
 Bandwidth(Mbps)              1
 Storage Generation           1
  1. Führen Sie den Befehl ibmcloud is share-update aus, um die Kapazität Ihrer Dateifreigabe zu erhöhen.
ibmcloud is share-update my-file-share --size 1500

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-file-share
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1500
IOPS                         1000
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T22:15:15+00:00
Latest job                   Job status   Job status reasons
                             succeeded    -
Replication share            ID                                          Name               Resource type
                             r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-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

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

Erweiterung der Dateifreigabekapazität mithilfe der API

Sie können vorhandene Dateifreigaben erweitern, indem Sie die VPC-API aufrufen. Führen Sie eine Anforderung PATCH /shares/{id} aus und geben Sie die ID der Dateifreigabe an, für die Sie die Größe erhöhen möchten.

In diesem Anforderungsbeispiel wird eine Dateifreigabe mit einer Kapazität von 50 GB auf 2500 GB für ein Profil mit 5 IOPS/GB erweitert.

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

Während die Kapazität erhöht wird, lautet der Status der Dateifreigabe updating. Während der Aktualisierung wird die aktuelle Kapazität angezeigt.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "updating",
  "name": "share-name1",
    .
    .
	"size": 2500,
    .
    .
    .
}

Wenn die Erweiterung der Dateifreigabe abgeschlossen ist, wird der neue Wert angezeigt und der Status lautet stable.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "stable",
  "name": "share-name1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
    "name": "dp2",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/875623bcde2b4ebda924d32640908845",
    "id": "875623bcde2b4ebda924d32640908845",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 2500,
  .
  .
  .
}

Dateifreigaben mit Terraform erweitern

Verwenden Sie die Ressource ibm_is_share, um die Kapazität einer Dateifreigabe zu erhöhen. Bei Anwendung des folgenden Beispiels wird die Freigabekapazität auf 300 GB aktualisiert.

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

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

Nächste Schritte

Sie können Ihre Dateifreigaben nun anhängen und verwenden: