ModifyVolume の追加
変更を提案
PDF
「 modifyVolume 」メソッドを使用すると、既存のボリュームの設定を変更できます。一度に 1 つのボリュームを変更できます。変更はすぐに反映されます。
ボリュームを変更するときに QoS 値を指定しない場合、変更前と同じ値が適用されます。GetDefaultQoS メソッドを実行すると、新しく作成したボリュームのデフォルトの QoS 値を取得できます。
レプリケート中のボリュームのサイズを拡張する必要がある場合は、レプリケーションエラーを回避するために次の手順で実行します。
-
replicationTarget アクセスが許可されたボリュームのサイズを拡張します。
-
ソース、つまり readWrite アクセスが許可されたボリュームのサイズを拡張します。
ターゲットボリュームとソースボリュームを必ず同じサイズにしてください。
|
アクセスステータスを locked または replicationTarget に変更すると、すべての既存の iSCSI 接続が終了します。 |
パラメータ
このメソッドの入力パラメータは次のとおりです。
| 名前 | 説明 | を入力します | デフォルト値 | 必須 |
|---|---|---|---|---|
ボリューム ID |
変更するボリュームの ID 。 |
整数 |
なし |
はい。 |
にアクセスします |
ボリュームに許可するアクセス。有効な値は次のとおり
|
文字列 |
なし |
いいえ |
アカウント ID |
ボリュームを再割り当てするアカウント ID 。指定しない場合は、以前のアカウント名が使用されます。 |
整数 |
なし |
いいえ |
associateWithQoSPolicy |
指定した QoS ポリシーにボリュームを関連付けます。有効な値は次のとおり
|
ブール値 |
なし |
いいえ |
属性（ Attributes ） |
JSON オブジェクト形式の名前と値のペアのリスト。 |
JSON オブジェクト |
なし |
いいえ |
CreateTime をクリックします |
新しいボリューム作成日として設定する ISO 8601 形式の日付文字列。setCreateTime を true に設定した場合は必須です。 |
ISO 8601 形式の文字列 |
なし |
いいえ |
dontMoveforIopsRebalance |
実際のIOPSでロードバランシングを行う際にボリュームを移動しないようにします。この設定はElement 12.8以降で使用でき、が有効な場合にのみ有効です。"VolumeLoadBalanceOnActualIOPS"有効な値：
注：高可用性（ノード障害）のバランスは、および `dontMoveforIopsRebalance`よりも優先され `VolumeLoadBalanceOnActualIOPS`ます。 |
ブール値 |
いいえ |
いいえ |
enableSnapMirrorReplication |
ボリュームを SnapMirror エンドポイントでのレプリケーションに使用できるかどうかを指定します。有効な値は次のとおり
|
ブール値 |
いいえ |
いいえ |
50 サイズ |
ボリュームでサポートされる FIFO （ First-In First-Out ）スナップショットの最大数を指定します。FIFO スナップショットと非 FIFO スナップショットはどちらも、ボリューム上で使用可能なスナップショットスロットの同じプールを使用することに注意してください。このオプションを使用して、使用可能なスナップショットスロットの FIFO スナップショットの消費を制限します。この値を現在の FIFO スナップショットカウントよりも小さく変更することはできません。 |
整数 |
なし |
いいえ |
minFifoSize |
FIFO （ First-In First-Out ）スナップショットだけに予約されているスナップショットスロットの数を指定します。FIFO スナップショットと非 FIFO スナップショットは同じプールを共有するため、 minFifoSize パラメータは、可能な非 FIFO スナップショットの合計数を同じ量だけ減らします。この値は、現在の FIFO 以外のスナップショット数と競合するように変更することはできません。 |
整数 |
なし |
いいえ |
モード |
ボリュームのレプリケーションモード。有効な値は次のとおり
|
文字列 |
なし |
いいえ |
QoS |
このボリュームの新しい QoS 設定。指定しない場合、 QoS 設定は変更されません。有効な値は次のとおり
|
なし |
いいえ |
|
qosPolicyID |
指定したボリュームに適用する QoS 設定が定義されたポリシーの ID 。このパラメータは、 qos パラメータと同時に指定することはできません。 |
整数 |
なし |
いいえ |
setCreateTime |
true に設定すると、記録されているボリューム作成日が変更されます。 |
ブール値 |
なし |
いいえ |
合計サイズ |
ボリュームの新しいサイズ（バイト）。1 、 000 、 000 、 000 は 1GB に相当します。サイズは最も近い MB 単位に切り上げられます。このパラメータは、ボリュームのサイズを拡張する場合にのみ使用できます。 |
整数 |
なし |
いいえ |
戻り値
このメソッドの戻り値は次のとおりです。
| 名前 | 説明 | を入力します |
|---|---|---|
ボリューム |
変更されたボリュームの情報を含むオブジェクト。 |
要求例
このメソッドの要求例を次に示します。
{
"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