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:
-
Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation
> Infrastruktur
> Speicher > Dateifreigaben.
-
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.
-
Erweitern Sie auf der Detailseite für Dateifreigaben das Menü Aktionen.
-
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.
-
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.
-
Überprüfen Sie die geschätzte monatliche Bestellübersicht für Ihre Geografie und die neue Preisgestaltung.
-
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.
-
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
-
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
-
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: