日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

ModifyVolume の追加

04/18/2022 共同作成者

PDF

「 modifyVolume 」メソッドを使用すると、既存のボリュームの設定を変更できます。一度に 1 つのボリュームを変更できます。変更はすぐに反映されます。

ボリュームを変更するときに QoS 値を指定しない場合、変更前と同じ値が適用されます。GetDefaultQoS メソッドを実行すると、新しく作成したボリュームのデフォルトの QoS 値を取得できます。

レプリケート中のボリュームのサイズを拡張する必要がある場合は、レプリケーションエラーを回避するために次の手順で実行します。

replicationTarget アクセスが許可されたボリュームのサイズを拡張します。
ソース、つまり readWrite アクセスが許可されたボリュームのサイズを拡張します。

ターゲットボリュームとソースボリュームを必ず同じサイズにしてください。

アクセスステータスを locked または replicationTarget に変更すると、すべての既存の iSCSI 接続が終了します。

パラメータ

このメソッドの入力パラメータは次のとおりです。

名前説明を入力しますデフォルト値必須

名前	説明	を入力します	デフォルト値	必須
ボリューム ID	変更するボリュームの ID 。	整数	なし	はい。
にアクセスします	ボリュームに許可するアクセス。有効な値は次のとおり `re adOnly` ：読み取り操作のみが許可されます。「 readWrite 」：読み取りと書き込みが可能です。 'locked] ：読み取りや書き込みは許可されません。指定しない場合、アクセス値は変更されません。「リプリケーションターゲット」：ペアリングされたボリュームセットのターゲットボリュームとしてボリュームを指定します。ボリュームがペアリングされていない場合、アクセスステータスは locked になります。値を指定しない場合、アクセス値は変更されません。「 napMirrorTarget 」： SnapMirror レプリケーションのターゲットボリュームとしてボリュームを指定します。	文字列	なし	いいえ
アカウント ID	ボリュームを再割り当てするアカウント ID 。指定しない場合は、以前のアカウント名が使用されます。	整数	なし	いいえ
associateWithQoSPolicy	指定した QoS ポリシーにボリュームを関連付けます。有効な値は次のとおり `true` ： QoSPolicy パラメータで指定された QoS ポリシーにボリュームを関連付けます。 `false` ： QoSPolicy パラメータで指定された QoS ポリシーにボリュームを関連付けないでください。false の場合、 QoSPolicy パラメータで QoS ポリシーを指定したかどうかに関係なく、既存のポリシーの関連付けが削除されます。	ブール値	なし	いいえ
属性（ Attributes ）	JSON オブジェクト形式の名前と値のペアのリスト。	JSON オブジェクト	なし	いいえ
CreateTime をクリックします	新しいボリューム作成日として設定する ISO 8601 形式の日付文字列。setCreateTime を true に設定した場合は必須です。	ISO 8601 形式の文字列	なし	いいえ
enableSnapMirrorReplication	ボリュームを SnapMirror エンドポイントでのレプリケーションに使用できるかどうかを指定します。有効な値は次のとおり「真」「偽」	ブール値	いいえ	いいえ
50 サイズ	ボリュームでサポートされる FIFO （ First-In First-Out ）スナップショットの最大数を指定します。FIFO スナップショットと非 FIFO スナップショットはどちらも、ボリューム上で使用可能なスナップショットスロットの同じプールを使用することに注意してください。このオプションを使用して、使用可能なスナップショットスロットの FIFO スナップショットの消費を制限します。この値を現在の FIFO スナップショットカウントよりも小さく変更することはできません。	整数	なし	いいえ
minFifoSize	FIFO （ First-In First-Out ）スナップショットだけに予約されているスナップショットスロットの数を指定します。FIFO スナップショットと非 FIFO スナップショットは同じプールを共有するため、 minFifoSize パラメータは、可能な非 FIFO スナップショットの合計数を同じ量だけ減らします。この値は、現在の FIFO 以外のスナップショット数と競合するように変更することはできません。	整数	なし	いいえ
モード	ボリュームのレプリケーションモード。有効な値は次のとおり「 asynch` 」 : ターゲットに書き込む前に、データがソースに格納されていることをシステムが確認するのを待ちます。「同期」：ソースからのデータ転送の確認応答を待機せずに、ターゲットへのデータの書き込みを開始します。	文字列	なし	いいえ
QoS	このボリュームの新しい QoS 設定。指定しない場合、 QoS 設定は変更されません。有効な値は次のとおり「 IOPS 」「最大軸 IOPS 」「 burstIOPS 」	QoS	なし	いいえ
qosPolicyID	指定したボリュームに適用する QoS 設定が定義されたポリシーの ID 。このパラメータは、 qos パラメータと同時に指定することはできません。	整数	なし	いいえ
setCreateTime	true に設定すると、記録されているボリューム作成日が変更されます。	ブール値	なし	いいえ
合計サイズ	ボリュームの新しいサイズ（バイト）。1 、 000 、 000 、 000 は 1GB に相当します。サイズは最も近い MB 単位に切り上げられます。このパラメータは、ボリュームのサイズを拡張する場合にのみ使用できます。	整数	なし	いいえ

ボリューム ID

変更するボリュームの ID 。

整数

なし

はい。

にアクセスします

ボリュームに許可するアクセス。有効な値は次のとおり

re adOnly ：読み取り操作のみが許可されます。
「 readWrite 」：読み取りと書き込みが可能です。
'locked] ：読み取りや書き込みは許可されません。指定しない場合、アクセス値は変更されません。
「リプリケーションターゲット」：ペアリングされたボリュームセットのターゲットボリュームとしてボリュームを指定します。ボリュームがペアリングされていない場合、アクセスステータスは locked になります。値を指定しない場合、アクセス値は変更されません。
「 napMirrorTarget 」： SnapMirror レプリケーションのターゲットボリュームとしてボリュームを指定します。

文字列

なし

いいえ

アカウント ID

ボリュームを再割り当てするアカウント ID 。指定しない場合は、以前のアカウント名が使用されます。

整数

なし

いいえ

associateWithQoSPolicy

指定した QoS ポリシーにボリュームを関連付けます。有効な値は次のとおり

true ： QoSPolicy パラメータで指定された QoS ポリシーにボリュームを関連付けます。
false ： QoSPolicy パラメータで指定された QoS ポリシーにボリュームを関連付けないでください。false の場合、 QoSPolicy パラメータで QoS ポリシーを指定したかどうかに関係なく、既存のポリシーの関連付けが削除されます。

ブール値

なし

いいえ

属性（ Attributes ）

JSON オブジェクト形式の名前と値のペアのリスト。

JSON オブジェクト

なし

いいえ

CreateTime をクリックします

新しいボリューム作成日として設定する ISO 8601 形式の日付文字列。setCreateTime を true に設定した場合は必須です。

ISO 8601 形式の文字列

なし

いいえ

enableSnapMirrorReplication

ボリュームを SnapMirror エンドポイントでのレプリケーションに使用できるかどうかを指定します。有効な値は次のとおり

「真」
「偽」

ブール値

いいえ

50 サイズ

ボリュームでサポートされる FIFO （ First-In First-Out ）スナップショットの最大数を指定します。FIFO スナップショットと非 FIFO スナップショットはどちらも、ボリューム上で使用可能なスナップショットスロットの同じプールを使用することに注意してください。このオプションを使用して、使用可能なスナップショットスロットの FIFO スナップショットの消費を制限します。この値を現在の FIFO スナップショットカウントよりも小さく変更することはできません。

整数

なし

いいえ

minFifoSize

FIFO （ First-In First-Out ）スナップショットだけに予約されているスナップショットスロットの数を指定します。FIFO スナップショットと非 FIFO スナップショットは同じプールを共有するため、 minFifoSize パラメータは、可能な非 FIFO スナップショットの合計数を同じ量だけ減らします。この値は、現在の FIFO 以外のスナップショット数と競合するように変更することはできません。

整数

なし

いいえ

モード

ボリュームのレプリケーションモード。有効な値は次のとおり

「 asynch` 」 : ターゲットに書き込む前に、データがソースに格納されていることをシステムが確認するのを待ちます。
「同期」：ソースからのデータ転送の確認応答を待機せずに、ターゲットへのデータの書き込みを開始します。

文字列

なし

いいえ

QoS

このボリュームの新しい QoS 設定。指定しない場合、 QoS 設定は変更されません。有効な値は次のとおり

「 IOPS 」
「最大軸 IOPS 」
「 burstIOPS 」

QoS

なし

いいえ

qosPolicyID

指定したボリュームに適用する QoS 設定が定義されたポリシーの ID 。このパラメータは、 qos パラメータと同時に指定することはできません。

整数

なし

いいえ

setCreateTime

true に設定すると、記録されているボリューム作成日が変更されます。

ブール値

なし

いいえ

合計サイズ

ボリュームの新しいサイズ（バイト）。1 、 000 、 000 、 000 は 1GB に相当します。サイズは最も近い MB 単位に切り上げられます。このパラメータは、ボリュームのサイズを拡張する場合にのみ使用できます。

整数

なし

いいえ

戻り値

このメソッドの戻り値は次のとおりです。

名前

説明

を入力します

ボリューム

変更されたボリュームの情報を含むオブジェクト。

ボリューム

要求例

このメソッドの要求例を次に示します。

{
  "method": "ModifyVolume",
  "params": {
     "volumeID": 5,
     "attributes": {
        "name1": "value1",
        "name2": "value2",
        "name3": "value3"
     },
     "qos": {
        "minIOPS": 60,
        "maxIOPS": 100,
        "burstIOPS": 150,
        "burstTime": 60
     },
      "access" :"readWrite"
     },
      "totalSize": 20000000000,
     "id": 1
}

応答例

このメソッドの応答例を次に示します。

{
  "id": 1,
  "result": {
      "volume": {
          "access": "readWrite",
          "accountID": 1,
          "attributes": {
              "name1": "value1",
              "name2": "value2",
              "name3": "value3"
          },
          "blockSize": 4096,
          "createTime": "2016-03-28T16:16:13Z",
          "deleteTime": "",
          "enable512e": true,
          "iqn": "iqn.2010-01.com.solidfire:jyay.1459181777648.5",
          "name": "1459181777648",
          "purgeTime": "",
          "qos": {
              "burstIOPS": 150,
              "burstTime": 60,
              "curve": {
                  "4096": 100,
                  "8192": 160,
                  "16384": 270,
                  "32768": 500,
                  "65536": 1000,
                  "131072": 1950,
                  "262144": 3900,
                  "524288": 7600,
                  "1048576": 15000
              },
              "maxIOPS": 100,
              "minIOPS": 60
          },
          "scsiEUIDeviceID": "6a79617900000005f47acc0100000000",
          "scsiNAADeviceID": "6f47acc1000000006a79617900000005",
          "sliceCount": 1,
          "status": "active",
          "totalSize": 1000341504,
          "virtualVolumeID": null,
          "volumeAccessGroups": [
              1
          ],
          "volumeID": 5,
          "volumePairs": []
      }
  }
}

新規導入バージョン

9.6

詳細については、こちらをご覧ください

GetDefaultQoS の設定

ModifyVolume の追加

Creating your file...

パラメータ

戻り値

要求例

応答例

新規導入バージョン

詳細については、こちらをご覧ください