カスタム・プロファイルまたは dp2 プロファイルの IOPS の調整

CLI から、 share-update コマンドに --iops プロパティを指定して、カスタムプロファイルまたは dp2 プロファイルの新しいIOPSサイズを設定します。 指定するIOPSは、ファイル共有のサイズに対応した範囲内である必要があります。 詳細については、dp2 または カスタムIOPSプロファイル を参照してください。

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。

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
   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. ibmcloud is share コマンドを使用して、変更するファイル共有の詳細を表示します。

   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
   Source snapshot              -
   

3. ibmcloud is share-update コマンドを使用して、ファイル共有の IOPS を増減します。

   ibmcloud is share-update my-file-share --iops 2000
   

   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)                     1000
   IOPS                         2000
   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 my-file-share」を参照してください。

別の IOPS ティア・プロファイルを指定して IOPS を調整する

これらの手順は、ゾーンファイル共有のベータリリースで使用された旧世代のファイル共有プロファイル（汎用、5-iops、10-iops、またはカスタム）用です。 2026年5月6日をもって、これらのシェアプロファイルは廃止されます。 最新の機能を利用するには、共有の IOPS プロファイルを dp2 に変更する必要があります。

CLI から、--profile プロパティーを指定して ibmcloud is share-update コマンドを使用し、IOPS ティア・プロファイルの名前または href を指定します。

次の例では、3 IOPS/GB のプロファイルを 5 IOPS/GB のプロファイルに変更します。 この場合、ファイル共有は、上位のプロファイルに移動するために 9,600 GB を超えることはできません。

ibmcloud is share-update my-file-share --profile tier-5iops

Updating file share my-file-share under account Test Account as user user@mycompany.com...
ID                           ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Lifecycle state              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-1
Profile                      tier-5iops
Size(GB)                     100
IOPS                         3000
User Tags                    docs:test
Encryption                   provider_managed
Mount targets                ID                          Name   VPC ID   VPC Name
                             No mount targets found.
Resource group               ID                                     Name
                             7f1645c5-8afa-4a7e-860d-3df563e0aa8d   Default
Created                      2023-02-26T20:01:18+05:30
Snapshot count               0
Snapshot size                0
Source snapshot              -

コマンド・オプションについて詳しくは、「 ibmcloud is share-update my-file-share」を参照してください。

dp2またはカスタムプロファイルのIOPSを調整する

PATCH /shares 要求を行い、 iops プロパティーを指定して、カスタム pr dp2 プロファイルの許容範囲内で IOPS を調整します。

同じ PATCH /shares 要求でファイル共有の名前を更新して IOPS を調整することはできません。 2 つの PATCH /shares 要求を行ってください。

次の例は、100～499のカスタムプロファイルに基づいて、100 GBのファイル共有のIOPSが100から3,000に増加したことを示しています。 このカスタム帯域の IOPS 範囲は 100 IOPS から 6,000 IOPS です。 利用可能なIOPS範囲の詳細については、ファイル・ストレージ・プロファイルの概要 を参照してください。

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

IOPSの調整が行われている間、ファイル共有の状態は「 updating 」と表示されます。 インスタンスを再始動するまで、現在の IOPS が表示されます。 以下の例では、IOPS値を100から調整している。

{
   "created_at": "2023-08-08T22:58:49.000Z",
   "crn": "crn:[...]",
   "encryption": "provider_managed",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "id": "r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "iops": 100,
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

IOPS の拡張が完了したら、インスタンスを再始動します。 新しい値が表示され、ファイル共有の状態は「 stable 」となります。

{
  "created_at": "2023-08-08T22:58:49.000Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86",
  "id": "a0c07083-f411-446c-9316-7b08d6448c86",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "my-share-updated",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-3iops",
    "name": "custom",
    "resource_type": "share_profile"
  },
  "access_control_mode": "security-group",
  "allowed_transit_encryption_modes": ["none", "user-managed"],
  "replication_role": "none",
  "replication_status": "none",
  "replication_status_reasons": [],
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 4800,
  "mount_targets": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86/mount_targets/1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "name": "my-mount-target",
      "resource_type": "share_target",
      "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/r006-12bb28fc-856d-4902-813b-dc065d1ed084",
        "id": "12bb28fc-856d-4902-813b-dc065d1ed084",
        "name": "my-vpc",
        "resource_type": "vpc"
      }
    }
  ],
  "snapshot_count": 10,
  "snapshot_size": 10,
  "user_tags": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1",
    "resource_type": "zone"
  }
}

別の IOPS ティア・プロファイルを指定して IOPS を調整する

これらの手順は、ゾーンファイル共有のベータリリースで使用された旧世代のファイル共有プロファイル（汎用、5-iops、10-iops、またはカスタム）用です。 2026年5月6日をもって、これらのシェアプロファイルは廃止されます。 最新の機能を利用するには、共有の IOPS プロファイルを dp2 に変更する必要があります。

PATCH /shares 要求を行い、profile プロパティーを指定して、IOPS ティア・プロファイルの名前または href を指定します。

次の例では、3 IOPS/GB のプロファイルを 5 IOPS/GB のプロファイルに変更します。 この場合、ファイル共有は、上位のプロファイルに移動するために 9,600 GB を超えることはできません。

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2023-07-18&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "profile": "5iops-tier"
    }'

カスタム・プロファイルまたは dp2 プロファイルの IOPS の調整

ファイル共有のパフォーマンス・レベルを変更するには、 ibm_is_share リソースを使用し、必要な IOPS 値を指定します。 IOPS 値を指定する場合は、その値がファイル共有のサイズのパフォーマンス範囲内にあることを確認してください。 詳しくは、 dp2 ファイル・ストレージ・プロファイル を参照してください。

以下の例を適用すると、共有パフォーマンスが 5000 IOPS に更新されます。

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

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

別の IOPS ティア・プロファイルを指定して IOPS を調整する

IOPS ティア・プロファイルを持つファイル共有のパフォーマンス・レベルを変更するには、 ibm_is_share リソースを使用して、別の IOPS ティアを指定します。 以下の例を適用すると、共有パフォーマンスが 5000 IOPS に更新されます。

resource "ibm_is_share" "example" {
  name    = "my-share"
  size    = 220
  profile = "tier-5iops"
  zone    = "us-south-2"
}

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