IBM Cloud Docs
Kapazität der Dateifreigabe erweitern

Kapazität der Dateifreigabe erweitern

Für File Storage for VPC-Dateifreigaben können Sie die Größe der Dateifreigabe von der ursprünglichen Kapazität in GB-Schritten in Abhängigkeit von Ihrem Dateifreigabeprofil bis auf 32.000 GB erhöhen. Für diesen Prozess sind keine manuellen Schritte erforderlich. Sie müssen Ihre Daten beispielsweise nicht auf eine größere Dateifreigabe migrieren. Die Erweiterungsoperation verursacht keinen Ausfall oder fehlenden Zugriff auf Ihren Speicher.

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 Dateifreigabekapazität zu erhöhen. Sie können eine Dateifreigabe mehrfach bis zu ihrer maximalen Kapazität 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. Dateifreigaben, die aus einem angepassten Profil oder einem dp2-Profil erstellt werden, können innerhalb des zulässigen IOPS-Bereichs für diese Dateifreigabe erweitert werden.

Dateifreigaben, die aus einem IOPS-Tier-Profil erstellt werden, 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 wird bei abgestuften Dateifreigabeprofilen automatisch auf der Grundlage 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 erweitert werden kann, wird die maximale IOPS auf 48.000 IOPS angepasst. Die Kapazität und die IOPS werden sofort geändert, 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 der Aktivitätsverfolgung überprüfen, um festzustellen, ob die Dateifreigabe erweitert wurde. Nachdem eine Dateifreigabe erweitert wurde, können Sie die Kapazität nicht reduzieren.

Anforderungen

Die Dateifreigabe muss sich im Zustand stable befinden, bevor Sie die Erhöhung der Kapazität 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 abgestuften Profil erstellt wurde, das die Kapazität auf weniger als 32.000 GB begrenzt, kann sie nur bis zur zulässigen Kapazität für diese Stufe 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.
  • Die IOPS steigen auf das vom Profil erlaubte Maximum.
  • Der IOPS-Wert für eine Dateifreigabe, die aus einem IOPS-Tier-Profil erstellt wurde, kann nicht unabhängig geändert werden. IOPS 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 für eine Dateifreigabe ist auf 48.000 IOPS begrenzt, wenn ein einzelner Host auf sie zugreift. Für eine Dateifreigabe, auf die von mehreren Hosts zugegriffen wird, kann der IOPS-Wert 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

Gehen Sie wie folgt vor, um die Dateifreigabekapazität in der Konsole zu erweitern:

  1. Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation Menü-Symbol > Infrastruktur VPC-Symbol > Speicher > Dateifreigaben.

  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. Das Feld Dateifreigabegröße erweitern zeigt die aktuelle Größe der Dateifreigabe (in GB) und das Profil, dem sie zugeordnet ist. 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.

Hinweis: Sie können die Größe der Dateifreigabe nicht verringern, nachdem Sie ihre Kapazität erweitert haben.

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   
    r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   stable            us-south-1   dp2       1500       Default          replica   
    r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    stable            us-south-2   dp2       1500       Default          source   
    r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share        stable            us-south-3   dp2       1500       Default          replica   
    r006-925214bc-ded5-4626-9d8e-bc4e2e579232   my-new-file-share       stable            us-south-2   dp2       500        Default          none   
    r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default          none   
    r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default          source
    
  2. Zeigen Sie die Details der Dateifreigabe an, die Sie mit dem Befehl ibmcloud is share ändern wollen.

 $ ibmcloud is share my-file-share
 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                 
  1. Führen Sie den Befehl ibmcloud is share-update aus, um die Kapazität Ihrer Dateifreigabe zu erhöhen.

    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
    

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

Erweitern der Dateifreigabekapazität mit 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: $iam_token" \
 -d '{
      "size": 2500
    }'

Während die Kapazität erhöht wird, lautet der Status der Dateifreigabe updating. Die aktuelle Kapazität wird angezeigt, während sie aktualisiert wird.

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