7.21　ホストグループまたはiSCSIターゲットを作成する

メモ

HUS VMの場合、iSCSIターゲットを作成できません。

実行権限

ストレージ管理者（プロビジョニング）

リクエストライン

POST ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/host-groups

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

なし。

ボディ

ホストグループを作成する場合のコード例を次に示します。

{
  "portId": "CL1-A",
  "hostGroupName": "My_REST_API_HOST",
  "hostModeOptions": [12,33],
  "hostMode": "AIX"
}

iSCSIターゲットを作成する場合のコード例を次に示します。

{
  "portId": "CL1-A",
  "hostGroupName": "My_REST_API_HOST",
  "iscsiName": "iqn.20150908iscsi"
}

属性	型	説明
portId	string	（必須）ポート番号
hostGroupNumber	int	（任意）ホストグループ番号 0～254の10進数で指定します。省略した場合、自動で設定されます。 iSCSIポートの場合、ターゲットIDと呼びます。
hostGroupName	string	（必須）ホストグループ名またはiSCSIターゲット名 ホストグループを作成する場合 ホストグループ名を1～64文字で指定します。 iSCSIターゲットを作成する場合 iSCSIターゲットの名称を1～32文字で指定します。ターゲットIDが0のiSCSIターゲットのデフォルトの名称は、iSCSIターゲットの名称には指定できません。 次の文字が使用できます。 半角英数字 次の半角記号 . @ _ : \ - ハイフン（-）は先頭には指定できません。 同一ポート中に同じホストグループ名またはiSCSIターゲットの名称を2つ以上作成することはできません。
iscsiName	string	（任意）iSCSIネーム iSCSIターゲットを作成する場合に指定します。省略した場合、自動で設定されます。 iqn形式またはeui形式で指定してください。 iqn形式 5～223文字の値を指定します。使用できる文字は次のとおりです。 半角英数字（小文字）、ハイフン（-）、ピリオド（.）、コロン（:） 指定例：iqn.rest.example.of.iqn.form eui形式 eui.に続けて16進数で指定します。全体で20文字の値を指定してください。 指定例：eui.0900ABDC32598D26
hostMode	string	（任意）ホストモード 指定できる値を次に示します。 HP-UX、SOLARIS、AIX、WIN、LINUX/IRIX、TRU64、OVMS、NETWARE、VMWARE、VMWARE_EX、WIN_EX VSPの場合、次の値も指定できます。 UVM 省略した場合、LINUX/IRIXが設定されます。
hostModeOptions	int[]	（任意）ホストモードオプション設定用の番号 指定できる番号については、マニュアルオープンシステム構築ガイド、またはシステム構築ガイドを参照してください。 複数指定する場合は、コンマで区切ります。 この属性を指定する場合、hostModeも必ず指定します。
isQuickCreating	boolean	（任意）hostGroupNumberを指定してホストグループを作成する場合で、ホストグループが作成済みかどうかのチェックを省略するときにtrueを指定します。trueを指定した場合、指定したhostGroupNumberにすでにホストグループまたはiSCSIターゲットがあるときには上書きします。 true：作成済みかどうかをチェックしない false：作成済みかどうかをチェックする 省略した場合、falseが設定されます。 hostGroupNumberが指定されていない場合、この属性は無視されます。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。

属性	説明
affectedResources	作成したホストグループまたはiSCSIターゲットのURL

ステータスコード

この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

 curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X POST --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/host-groups