ファイル共有容量の拡張
ダウンタイムやデータ移行を伴わずに、 File Storage for VPC のファイル共有容量を最大32,000 GBまで拡張できます。 新しい容量を反映するように、請求情報が自動的に更新されます。
ファイル共有の請求方法が自動的に更新され、新しい価格の日割り額が現在の請求サイクルに加算されます。 その後、次の請求サイクルでは新しい金額全体が請求されます。
拡張可能なファイル共有の概念
ファイル共有の容量を増やすことができます。 ファイル共有サイズは、現在のファイル共有サイズより小さくすることはできません。
stable 状態のファイル共有について、容量を増やすことができます。 ファイル共有が拡張される前に、ユーザー許可が検証されます。 ファイル共有の容量を増やすには、UI、CLI、API、またはTerraformを利用できます。 ファイル共有は、最大容量の制限まで何度でも拡張できます。 ファイル共有を拡張した後は、容量を減らすことはできません。
拡張される容量は、ファイル共有プロファイルで許可されている最大値によって決まります。
可用性の選択 rfs プロファイルで作成される地域ファイル共有は、制限なしに最大32 TBまで増やすことができます。
またはDeprecated カスタムプロファイルで作成されたゾーンファイル共有は、そのファイル共有サイズの許容IOPS範囲内で拡張できます。 dp2 または Deprecatedカスタム プロファイルで作成されたゾーンファイル共有は、そのファイル共有サイズの許容IOPS範囲内で拡張できます。
非推奨IOPSティアプロファイルの 1つで作成されたゾーンファイル共有は、そのIOPSティアの最大サイズまで拡張できます:
- 汎用の 3 IOPS/GB プロファイルは、最大 32,000 GB まで拡張できます。
- 5 IOPS/GB プロファイルは、9,600 GB まで拡張できます。
- 10 IOPS/GB プロファイルは、4,800 GB まで拡張できます。
非推奨となった階層型ファイル共有プロファイルについては、ファイル共有のサイズに基づいてIOPSが自動的に調整されます。 例えば、5 IOPS/GB プロファイルを使用して共有を 250 GB から 1,000 GB に拡張すると、最大 IOPS は 5,000 IOPS (1,000 GB 容量 x 5 IOPS) になります。 5 IOPS/GBのファイル共有は、最大で9,600 GBまで拡張される可能性があるため、最大IOPSは48,000 IOPSに調整されます。
容量とIOPSは即座に変更され、インスタンスを再起動する必要はありません。
UI または CLI からファイル共有拡張の進行状況をモニターできます。 また、「 アクティビティ追跡イベント 」を確認して、ファイル共有が展開されたことを確認することもできます。 ファイル共有の拡張後に容量を減らすことはできません。
要件
容量の増量をリクエストするには、ファイル共有が「 stable 」状態になっている必要があります。
制限
このリリースには、以下の制限が適用されます。
- ファイル共有は、以下の制限付きで拡張できます。
- ファイル共有が、容量を 32,000 GB 未満に制限する 階層型プロファイル を使用して作成された場合、その階層で許可されている容量までしか拡張できません。
- ファイル共有が、16,000 GBまで拡張できないIOPS範囲の カスタムプロファイルで 作成された場合、共有は指定された範囲の最大容量までしか拡張できません。
- ファイル共有が32,000 GBまで拡張できないIOPS範囲の dp2 プロファイルで 作成された場合、共有は指定された範囲の最大容量までしか拡張できません。
- ファイル共有の拡張は、最大容量に達するまで何度も実行できます。
- IOPSを、プロファイルで許可されている最大値まで増加させます。
- IOPS ティア・プロファイルから作成されたファイル共有の IOPS を独立して変更することはできません。 容量を拡張すると、IOPSが調整されます。
- カスタム・プロファイルまたは dp2 プロファイルから作成されたファイル共有を拡張すると、容量は増加しますが、 IOPS の調整 を選択しない限り、IOPS は同じままです。
- ゾーンファイル共有の最大IOPSは、単一のホストからアクセスされる場合、48,000 IOPSに制限されます。 複数のホストからアクセスされるゾーン型ファイル共有の場合、IOPSは最大96,000 IOPSに達することがあります。
- ファイル共有の拡張後に、そのサイズを減らすことはできません。
コンソールでのファイル共有容量の拡張
コンソールでファイル共有の容量を拡張するには、以下の手順に従ってください:
-
IBM Cloud コンソールで、 ナビゲーション メニュー
> インフラストラクチャ
> ストレージ > ファイル ストレージ共有をクリックします。
-
「VPC のファイル共有 (File Shares for VPC)」リスト・ページには、そのゾーンで作成されたすべてのファイル共有が表示されます。 ファイル共有の名前をクリックして、詳細ページを表示します。
-
ファイル共有の詳細ページで、**「アクション」**メニューを展開します。
-
**「ファイル共有の拡張 (Expand file share)」**を選択します。 [ファイル共有のサイズを拡大] パネルには、ファイル共有の現在のサイズ(GB単位)と、それが関連付けられているプロファイルが表示されます。 あるいは、ファイル共有サイズ情報の横にある編集アイコンをクリックすることもできます。
-
ファイル共有プロファイルに許可されている最大値に基づいて、より大きなファイル共有サイズを入力します。 デフォルトは、現在のサイズ + 1 GB です。
-
地域に応じて生成される注文の要約で、新たに見積もられた月額料金を確認します。
-
問題がなければ、**「保存して続行 (Save and continue)」**をクリックします。
新しいファイル・ストレージ割り振りは数分後に使用可能になります。 要件が変更された場合は、ファイル共有サイズが増やされてファイル共有の状態が stable になったときに、再度容量を増やすことができます。
ファイル共有の容量を拡張した後、その容量を縮小することはできません。
CLI からのファイル共有の拡張
CLI からファイル共有の容量を増やすには、 --size オプションを指定して share-update コマンドを使用し、ファイル共有の新しいサイズを GB 単位で指定します。
-
ibmcloud is shares コマンドを使用して地域内のファイル共有をリストすることで、CLI から共有を見つけます。
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
-
ibmcloud is share コマンドを使用して、変更するファイル共有の詳細を表示します。
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
ibmcloud is share-update コマンドを実行して、ファイル共有の容量を増やします。
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
コマンド・オプションについて詳しくは、「 ibmcloud is share-update my-file-share」を参照してください。
API によるファイル共有容量の拡張
VPC API を呼び出すことで、既存のファイル共有を拡張できます。 PATCH /shares/{id} 要求を行い、サイズを増やすファイル共有の ID を指定します。
この要求の例では、5 IOPS/GB プロファイルに対して、容量が 50 GB のファイル共有を 2500 GB に拡張しています。
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"size": 2500
}'
容量が増やされている間、ファイル共有の状況は updating と表示されます。 更新中は、現在の容量が表示されます。
{
"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,
.
.
.
}
ファイル共有の拡張が完了すると、新しい値が表示され、状況が 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,
.
.
.
}