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

レスポンスメッセージ

ボディ

属性	型	説明
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

16.3 外部ボリュームを作成する

16.3　外部ボリュームを作成する