16.3 外部ボリュームを作成する
ストレージシステムに外部パリティグループを作成して、外部パリティグループに外部接続したストレージシステムのボリュームを作成(マッピング)します。同時に外部パスグループと外部パスも作成されます。作成したボリュームを外部ボリュームと呼びます。
実行権限
- メモ
-
- 外部ボリュームの容量が4194304MiB(4TiB)を超える場合、4194304MiB(4TiB)の外部ボリュームとして作成されます。
- iSCSIで接続する場合は、あらかじめ外部ストレージシステムのiSCSIターゲットの情報を、外部接続用のiSCSIポート(ローカルポート)に登録してください。
ストレージ管理者(プロビジョニング)
リクエストライン
POST <ベースURL>/simple/v1/objects/external-volumes
リクエストメッセージ
- オブジェクトID
- なし。
- クエリパラメータ
- なし。
- ボディ
-
外部ボリュームを作成する例を次に示します。
- FCの場合
{ "externalParityGroupId": "8-501", "externalPathGroupId": 501, "portId": "CL5-A", "externalPortWwn": "50060e8012000c60", "lun": 501 }
- iSCSIの場合
{ "externalParityGroupId": "9-1025", "externalPathGroupId": 1025, "portId": "CL1-B", "externalPortIpAddress": "10.1.2.122", "externalPortIscsiName": "iqn.1994-04.jp.co.hitachi:rsd.h8m.t.00012.2d00b", "lun": 1025 }
属性
型
説明
externalParityGroupId
string
(必須)外部パリティグループID
使用されていない外部パリティグループIDを指定してください。
「X-Y」形式で指定します。
Xに指定できる値は1~16384までの整数です。
Yに指定できる値は1~4096までの整数です。
例:1-1
externalPathGroupId
int
(必須)外部パスグループID
使用されていない外部パスグループIDを指定してください。
0~63231までの整数で指定します。
portId
string
(必須)外部接続用のポートID
externalPortWwn
string
(任意)外部ストレージシステムのポートのWWN
FCポートの場合は、この属性を必ず指定してください。
iSCSIポートの場合で、この属性を指定したときは指定した値は無視されます。
externalPortIpAddress
string
(任意)外部ストレージシステムのポートのIPアドレス
IPv4またはIPv6のIPアドレスを指定します。
iSCSIポートの場合は、この属性を必ず指定してください。
FCポートの場合で、この属性を指定したときは指定した値は無視されます。
externalPortIscsiName
string
(任意)外部ストレージシステムのポートのiSCSIターゲット名
iSCSIポートの場合は、この属性を必ず指定してください。
FCポートの場合で、この属性を指定したときは指定した値は無視されます。
lun
int
(必須)外部ストレージシステムのポートに割り当てられているLUN
- FCの場合
レスポンスメッセージ
- ボディ
-
属性
型
説明
statusResource
string
作成した外部ボリュームの実行結果の問い合わせに使用するURL
- メモ
-
- 非同期処理のAPIのステータス情報を取得するAPIを実行して、実行結果のステータス情報を参照することもできます。詳細は非同期処理のAPIのステータス情報を取得するAPIの説明を参照してください。
- 外部パリティグループや外部パスグループが正しく作成されているかどうかは、外部パリティグループの情報を取得するAPI 、および外部パスグループの情報を取得するAPI を実行して確認してください。
ステータスコード
この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/external-volumes