ファイル共有容量の拡張

ダウンタイムやデータ移行を伴わずに、 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に達することがあります。
  • ファイル共有の拡張後に、そのサイズを減らすことはできません。

コンソールでのファイル共有容量の拡張

コンソールでファイル共有の容量を拡張するには、以下の手順に従ってください:

  1. IBM Cloud コンソールで、 ナビゲーション メニューアイコン> インフラストラクチャVPC アイコン> ストレージ > ファイル ストレージ共有をクリックします。

  2. 「VPC のファイル共有 (File Shares for VPC)」リスト・ページには、そのゾーンで作成されたすべてのファイル共有が表示されます。 ファイル共有の名前をクリックして、詳細ページを表示します。

  3. ファイル共有の詳細ページで、**「アクション」**メニューを展開します。

  4. **「ファイル共有の拡張 (Expand file share)」**を選択します。 [ファイル共有のサイズを拡大] パネルには、ファイル共有の現在のサイズ(GB単位)と、それが関連付けられているプロファイルが表示されます。 あるいは、ファイル共有サイズ情報の横にある編集アイコンをクリックすることもできます。

  5. ファイル共有プロファイルに許可されている最大値に基づいて、より大きなファイル共有サイズを入力します。 デフォルトは、現在のサイズ + 1 GB です。

  6. 地域に応じて生成される注文の要約で、新たに見積もられた月額料金を確認します。

  7. 問題がなければ、**「保存して続行 (Save and continue)」**をクリックします。

新しいファイル・ストレージ割り振りは数分後に使用可能になります。 要件が変更された場合は、ファイル共有サイズが増やされてファイル共有の状態が stable になったときに、再度容量を増やすことができます。

ファイル共有の容量を拡張した後、その容量を縮小することはできません。

CLI からのファイル共有の拡張

CLI からファイル共有の容量を増やすには、 --size オプションを指定して share-update コマンドを使用し、ファイル共有の新しいサイズを GB 単位で指定します。

  1. 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
    
  2. 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
  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,
  .
  .
  .
}

Terraform を使用したファイル共有の拡張

ファイル共有の容量を増やすには、 ibm_is_share リソースを使用します。 以下の例を適用すると、共有容量が 300 GB に更新されます。

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

引数および属性について詳しくは、 ibm_is_shareを参照してください。

次のステップ

ファイル共有のマウントと使用: