CreateVolumeAccessGroup
CreateVolumeAccessGroup を使用すると、新しいボリュームアクセスグループを作成できます。ボリュームアクセスグループを作成するときは、名前を指定する必要があります。必要に応じて、イニシエータとボリュームを入力することもできます。
ボリュームアクセスグループに追加したイニシエータ IQN は、 CHAP 認証なしでグループ内のすべてのボリュームにアクセスできます。
クローンボリュームには、ソースボリュームのボリュームアクセスグループメンバーシップは継承されません。 |
ボリュームアクセスグループを作成する際は、次の点に注意してください。
-
ボリュームアクセスグループには、最大 64 個のイニシエータ IQN を含めることができます。
-
1 つのイニシエータは 1 つのボリュームアクセスグループにのみ属することができます。
-
ボリュームアクセスグループには、最大 2 、 000 個のボリュームを含めることができます。
-
各ボリュームアクセスグループは、最大4つのボリュームアクセスグループに属することができます。
パラメータ
このメソッドの入力パラメータは次のとおりです。
名前 | 説明 | を入力します | デフォルト値 | 必須 |
---|---|---|---|---|
イニシエータ |
ボリュームアクセスグループに含めるイニシエータの ID または名前( IQN および WWPN )のリスト。イニシエータ名のリストを渡した場合、存在しないイニシエータは作成されます。イニシエータ ID のリストを渡した場合、存在しないイニシエータにはエラーが返されます。イニシエータ名を渡すことは推奨されていません。可能な場合はイニシエータ ID を使用し |
整数の配列または文字列の配列(非推奨) |
いいえ |
|
名前 |
ボリュームアクセスグループの名前。固有である必要はありませんが、一意にすることを推奨します1~64 文字で指定します。 |
文字列 |
なし |
はい。 |
個のボリューム |
ボリュームアクセスグループに含めるボリューム ID のリスト。 |
整数の配列 |
いいえ |
|
属性( Attributes ) |
JSON オブジェクト形式の名前と値のペアのリスト。 |
JSON オブジェクト |
{ } |
いいえ |
戻り値
このメソッドの戻り値は次のとおりです。
名前 |
説明 |
を入力します |
volumeAccessGroup の場合 |
新たに作成されたボリュームアクセスグループの情報を含むオブジェクト。 |
|
ボリュームアクセスグループ ID |
新たに作成されたボリュームアクセスグループの ID 。 |
整数 |
要求例
このメソッドの要求例を次に示します。
{ "method": "CreateVolumeAccessGroup", "params": { "name": "myaccessgroup", "initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"], "volumes": [327], "attributes": {} } }
応答例
このメソッドの応答例を次に示します。
{ "id": null, "result": { "volumeAccessGroup": { "attributes": {}, "deletedVolumes": [], "initiatorIDs": [ 95 ], "initiators": [ "iqn.1993-08.org.debian: 01: a31b1d799d5c" ], "name": "myaccessgroup", "volumeAccessGroupID": 96, "volumes": [ 327 ] }, "volumeAccessGroupID": 96 } }
新規導入バージョン
9.6