ボリュームの変更
変更を提案
PDF
使用することができます `ModifyVolume`既存のボリュームの設定を変更する方法。一度に 1 つのボリュームに変更を加えることができ、変更はすぐに反映されます。
ボリュームを変更するときに QoS 値を指定しないと、変更前と同じ値のままになります。新しく作成されたボリュームのデフォルトのQoS値を取得するには、 `GetDefaultQoS`方法。
レプリケートされるボリュームのサイズを増やす必要がある場合は、レプリケーション エラーを防ぐために次の順序で実行してください。
-
replicationTarget アクセスを使用してボリュームのサイズを増やします。
-
読み取り/書き込みアクセスを持つソースまたはボリュームのサイズを増やします。
ターゲット ボリュームとソース ボリュームの両方が同じサイズであることを確認します。
|
アクセス ステータスをロックまたはレプリケーション ターゲットに変更すると、既存のすべての iSCSI 接続が終了します。 |
パラメータ
このメソッドには次の入力パラメータがあります。
| Name | 説明 | タイプ | デフォルト値 | 必須 |
|---|---|---|---|---|
volumeID |
変更するボリュームのボリュームID。 |
integer |
なし |
はい |
アクセス |
ボリュームへのアクセスが許可されました。有効な値は次のとおりです。
|
string |
なし |
いいえ |
accountID |
ボリュームが再割り当てされるアカウント ID。何も指定されていない場合は、以前のアカウント名が使用されます。 |
integer |
なし |
いいえ |
QoSポリシーに関連付ける |
指定された QoS ポリシーにボリュームを関連付けます。有効な値は次のとおりです。
|
ブーリアン |
なし |
いいえ |
attributes |
JSON オブジェクト形式の名前と値のペアのリスト。 |
JSONオブジェクト |
なし |
いいえ |
作成時間 |
新しいボリュームの作成日として設定する ISO 8601 日付文字列。 setCreateTime が true に設定されている場合は必須です。 |
ISO 8601文字列 |
なし |
いいえ |
Iopsの再バランスのために動かない |
実際の IOPS で負荷分散するときにボリュームが移動しないようにします。この設定はElement 12.8以降で利用可能で、"実際のIOPSでのボリューム負荷バランス"が有効になります。有効な値は次のとおりです。
注: 高可用性（ノード障害）のバランス調整は、 |
ブーリアン |
false |
いいえ |
SnapMirrorReplication を有効にする |
ボリュームをSnapMirrorエンドポイントでのレプリケーションに使用できるかどうかを決定します。有効な値は次のとおりです。
|
ブーリアン |
false |
いいえ |
fifoサイズ |
ボリュームでサポートされる先入れ先出し (FIFO) スナップショットの最大数を指定します。 FIFO スナップショットと非 FIFO スナップショットはどちらも、ボリューム上の使用可能なスナップショット スロットの同じプールを使用することに注意してください。このオプションを使用して、使用可能なスナップショット スロットの FIFO スナップショットの消費を制限します。この値を現在の FIFO スナップショット数より小さく変更することはできないことに注意してください。 |
integer |
なし |
いいえ |
最小Fifoサイズ |
先入れ先出し (FIFO) スナップショット専用に予約されているスナップショット スロットの数を指定します。 FIFO スナップショットと非 FIFO スナップショットは同じプールを共有するため、minFifoSize パラメータは、可能な非 FIFO スナップショットの合計数を同じ量だけ削減します。この値は、現在の非 FIFO スナップショット数と競合するように変更することはできないことに注意してください。 |
integer |
なし |
いいえ |
モード |
ボリュームレプリケーションモード。有効な値は次のとおりです。
|
string |
なし |
いいえ |
qos |
このボリュームの新しいサービス品質設定。指定しない場合は、QoS 設定は変更されません。有効な値は次のとおりです。
|
なし |
いいえ |
|
qosポリシーID |
指定されたボリュームに QoS 設定を適用するポリシーの ID。このパラメータは qos パラメータと相互に排他的です。 |
integer |
なし |
いいえ |
作成時間の設定 |
ボリューム作成の記録日を変更するには、true に設定します。 |
ブーリアン |
なし |
いいえ |
合計サイズ |
ボリュームの新しいサイズ（バイト単位）。 1000000000 は 1GB に相当します。サイズは最も近いメガバイトに切り上げられます。このパラメータはボリュームのサイズを増やすためにのみ使用できます。 |
integer |
なし |
いいえ |
戻り値
このメソッドの戻り値は次のとおりです。
| Name | 説明 | タイプ |
|---|---|---|
音量 |
新しく変更されたボリュームに関する情報を含むオブジェクト。 |
リクエスト例
このメソッドのリクエストは次の例のようになります。
{
"method": "ModifyVolume",
"params": {
"volumeID": 319,
"access": "readWrite",
"dontMoveForIopsRebalance": false
},
"id": 1
}
応答例
このメソッドは、次の例のような応答を返します。
{
"id": 1,
"result": {
"volume": {
"access": "readWrite",
"accountID":22,
"attributes": {},
"blockSize": 4096,
"createTime": "2024-04-01T19:39:40Z",
"currentProtectionScheme": "doubleHelix",
"deleteTime": "",
"dontMoveForIopsRebalance": false,
"enable512e": false,
"enableSnapMirrorReplication": false,
"fifoSize": 24,
"iqn": "iqn.2010-01.com.solidfire:3eeu.suite40.319",
"lastAccessTime": "2024-04-02T12:41:34Z",
"lastAccessTimeIO": "2024-04-01T20:41:19Z",
"minFifoSize": 0,
"name": "suite40",
"previousProtectionScheme": null,
"purgeTime": "",
"qos": {
"burstIOPS": 27000,
"burstTime": 60,
"curve": {
"1048576": 15000,
"131072": 1950,
"16384": 270,
"262144": 3900,
"32768": 500, "4096": 100,
"524288": 7600,
"65536": 1000,
"8192": 160
},
"maxIOPS": 27000,
"minIOPS": 500
},
"qosPolicyID": null,
"scsiEUIDeviceID": "336565750000013ff47acc0100000000",
"scsiNAADeviceID": "6f47acc100000000336565750000013f",
"sliceCount": 1,
"status": "active",
"totalSize": 1000000716800,
"virtualVolumeID": null,
"volumeAccessGroups": [
22
],
"volumeConsistencyGroupUUID": "3003109e-6e75-444c-8cee-470d641a09c3",
"volumeID": 319,
"volumePairs": [],
"volumeUUID": "78203136-b0eb-454b-9f67-2c867ec7d7bb"
}
}
}
バージョン以降の新機能
9.6