Block Storage for VPC ボリュームの IOPS の調整

開始前に

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

1. IBM Cloud にログインします。

   ibmcloud login --sso -a cloud.ibm.com
   

   このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。 ブラウザーでその URL にアクセスしてログインします。 成功すると、ワンタイム・パスコードが表示されます。 そのパスコードをコピーし、プロンプトに応答として貼り付けます。 認証に成功すると、アカウントを選択するように求めるプロンプトが出されます。 複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。 残りのプロンプトにすべて応答して、ログインを完了します。

カスタム・プロファイルの IOPS の調整

CLI から、 ibmcloud is volume-update コマンドに --iops オプションを指定して、カスタムプロファイルの新しい IOPS サイズを設定します。 選択する IOPS は、ボリュームのサイズの範囲内でなければなりません。 詳細については、カスタム・ボリューム・プロファイル を参照してください。

ibmcloud is volume-update VOLUME_ID --iops IOPS

この例では、100 から 499 のカスタム・プロファイルに基づいて、100 GB ボリュームの IOPS を 100 IOPS から 3,000 IOPS に増やします。 このカスタム帯域の IOPS 範囲は 100 IOPS から 6,000 IOPS です。

ibmcloud is volume-update 933c8781-f7f5-4a8f-8a2d-3bfc711788ee --iops 3000

Updating volume 933c8781-f7f5-4a8f-8a2d-3bfc711788ee under account Test Account as user test.user@ibm.com...
ID                                      0738-933c8781-f7f5-4a8f-8a2d-3bfc711788ee
Name                                    demo-volume-update
Capacity                                100
IOPS                                    3000
Profile                                 custom
Encryption Key                          -
Encryption                              provider managed
Status                                  available
Created                                 2021-08-23 10:09:28
Resource Group                          Default(c16d1edde3fd4a71a0130aed371405a0)
Zone                                    us-south-2
Resource Group                          Default(c16d1edde3fd4a71a0130aed371405a0)
Volume Attachment Instance Reference    Vdisk Name    Vdisk ID                                    Vdisk Type   Auto Delete
                                        Vdisk-data1   0738-fd146b1f-e1bb-4eab-ba78-3109e6bc3a2d   data         true
    									Instance Name   Instance ID
       									vsi-test1       0738-8b56da93-7990-4ccf-9dc5-5aee6a5f08f9

同じコマンドを使用して、 sdp プロファイルで作成されたボリュームの IOPS を調整できます。 新しいIOPS値は100-64,000の間である。

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

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

ibmcloud is volume-update VOLUME_ID --profile VOLUME_PROFILE_NAME

この例では、3 IOPS/GBのプロファイルを5 IOPS/GBのプロファイルに変更します。 この場合、ボリュームは 9,600 GB を超えて上位のプロファイルに移動することはできません。

ibmcloud is volume-update demo-volume-update --profile 5iops-tier

Updating volume demo-volume-update under account Test Account as user test.user@ibm.com...
ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   demo-volume-update
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                5iops-tier
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-06-29T16:14:59+00:00
Zone                                   us-east-1
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       data              0757_11f5db7f-35a1-4678-bcbd-c85204e09507   kj-test-ro      false         0757-4dfc4384-c4b5-497e-bab3-6415f9c4d44b   otp
Active                                 true
Busy                                   false
Tags                                   -

使用可能なコマンド・オプションについて詳しくは、「 ibmcloud is volume-update」を参照してください。

カスタムまたは定義されたパフォーマンスプロファイルでボリュームのIOPSを調整する

PATCH /volumes リクエストを発行し、 iops パラメータを指定して、カスタムボリュームプロファイルの範囲内でIOPSを調整します。

同じ PATCH /volumes 要求で、ボリュームの名前を更新して IOPS を調整することはできません。 2 つの PATCH /volumes 要求を行ってください。

この例では、100 から 499 のカスタム・プロファイルに基づいて、100 GB ボリュームの IOPS を 100 IOPS から 3,000 IOPS に増やします。 このカスタム帯域の IOPS 範囲は 100 IOPS から 6,000 IOPS です。

curl -X PATCH \
 "$vpc_api_endpoint/v1/volumes/$volume_id?version=2022-01-11&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "iops": 3000
    }'

IOPSの調整中は、ボリュームの状態が「 updating 」と表示されます。 インスタンスを再始動するまで、現在の IOPS が表示されます。 この例では、3 IOPS/GBのプロファイルについて、IOPSが100から3000に増加しています。

{
	"iops": 100,
	"created_at": "2022-01-11T09:46:43.000Z",
	"crn": "crn:v1:bluemix:public:is:us-south-1:a/<Acc id>::volume:<Volume ID>",
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

IOPS の拡張が完了したら、インスタンスを再始動します。 新しい値が表示され、ボリュームの状態は「 available 」となります。

{
	"capacity": 250,
	"created_at": "2022-01-11T09:46:43.000Z",
	"crn": "crn:[...]",
	"encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
    "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
	"iops": 3000,
	"name": "my-volume-1",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
		"name": "custom"
	},
    "resource_group": {
        "href": "https://resource-manager.bluemix.net/v1/resource_groups/83daf012-5920-4ba9-9689-cc0d2d2281fb",
        "id": "83daf012-5920-4ba9-9689-cc0d2d2281fb",
		"name": "Default"
	},
	"status": "available",
	"volume_attachments": [{
		"delete_volume_on_instance_delete": true,
		"device": {
			"id": "4cbb38bc-57d5-4121-a796-d5b10cf0810a"
		},
		"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/4cbb38bc-57d5-4121-a796-d5b10cf0810a",
		"id": "<4cbb38bc-57d5-4121-a796-d5b10cf0810aAttachment ID>",
		"instance": {
			"crn": "crn:[...]",
			"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5",
			"id": "8f06378c-ed0e-481e-b98c-9a6dfbee1ed5",
			"name": "my-instance-1"
		},
		"name": "my-volume-attachment-1",
		"type": "data"
	}],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
}

sdp プロファイルで作成されたボリュームの IOPS を調整する場合にも、同じ API リクエストを使用できます。 新しいIOPS値は100-64,000の間である。 48,000IOPS以上を達成するには、 第3世代インスタンス・プロファイルを 持つ仮想サーバー・インスタンスにボリュームをアタッチする必要があります。

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

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

この例では、3 IOPS/GBのプロファイルを5 IOPS/GBのプロファイルに変更します。 この場合、ボリュームは 9,600 GB を超えて上位のプロファイルに移動することはできません。

curl -X PATCH \
 "$vpc_api_endpoint/v1/volumes/$volume_id?version=2022-01-11&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "profile": "5iops-tier"
    }'

カスタム・プロファイルの IOPS の調整

ボリュームの IOPS を変更するには、 ibm_is_volume リソースを使用します。 以下の例を適用すると、ボリューム IOPS が 24,000 に更新されます。

resource "ibm_is_volume" "storage" {
  name    = "demo-volume-update"
  size    = 8000
  iops    = 24000
  zone    = "us-south-2"
}

階層化プロファイルのIOPSを調整する

パフォーマンス層を使用して作成されたボリュームの IOPS を変更するには、 ibm_is_volume リソースを使用して別の層を指定します。 以下の例を適用すると、ボリューム・プロファイルが 5iops-tier に更新されます。

resource "ibm_is_volume" "storage" {
  name    = "demo-volume-update"
  size    = 8000
  profile = "5iops-tier"
  zone    = "us-south-2"
}

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