7.19　特定のホストグループまたはiSCSIターゲットの情報を取得する

実行権限

ストレージ管理者（参照）

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/host-groups/＜オブジェクトID＞

リクエストメッセージ

オブジェクトID

ホストグループまたはiSCSIターゲットの情報取得で取得したhostGroupIdの値を指定します。次のように属性値を連結した形式でも指定できます。

＜portId＞,＜hostGroupNumber＞

属性	型	説明
portId	string	（必須）ポート番号
hostGroupNumber	int	（必須）ポート上のホストグループ番号（iSCSIターゲットの場合はターゲットID）

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ

ポート番号とホストグループ番号を指定した場合の出力例を次に示します。

{
  "hostGroupId": "CL1-A,0",
  "portId": "CL1-A",
  "hostGroupNumber": 0,
  "hostGroupName": "hostA",
  "hostMode": "WIN",
  "hostModeOptions": [
    1,
    2
  ]
}

iSCSIターゲットの場合、ポート番号とターゲットIDを指定したときの出力例を次に示します。

{
  "hostGroupId": "CL1-A,0",
  "portId": "CL1-A",
  "hostGroupNumber": 0,
  "hostGroupName": "hostA",
  "iscsiName": "iqn.rest.example.of.iqn.host",
  "authenticationMode": "CHAP",
  "iscsiTargetDirection": "S",
  "hostMode": "WIN",
  "hostModeOptions": [
    1,
    2
  ]
}

属性	型	説明
hostGroupId	string	ホストグループまたはiSCSIターゲットのオブジェクトID
portId	string	ポート番号
hostGroupNumber	int	ポート上のホストグループ番号（iSCSIターゲットの場合はターゲットID）
hostGroupName	string	ホストグループ名（iSCSIターゲットの場合はターゲットエイリアス名）
iscsiName	string	ポートのiSCSIターゲットのiSCSIネーム iSCSIポートの場合に取得します。
authenticationMode	string	iSCSIターゲットの認証モード iSCSIポートの場合に取得します。 CHAP：CHAP 認証モード NONE：無認証モード BOTH：CHAP 認証モードおよび無認証モードの両方
iscsiTargetDirection	string	iSCSIターゲットのCHAP認証の方向 iSCSIポートの場合に取得します。 S：単方向（iSCSIターゲットがiSCSIイニシエータを認証する） D：双方向（iSCSIターゲットとiSCSIイニシエータが双方向に認証する）
hostMode	string	ホストグループのホストアダプタ設定用のホストモード 取得される値については、ホストグループまたはiSCSIターゲットの設定を変更するAPIの説明を参照してください。
hostModeOptions	int[]	ホストグループのホストモードオプション設定用の番号 取得される番号については、マニュアルオープンシステム構築ガイド、またはシステム構築ガイドを参照してください。

ステータスコード

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

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/800000012345/host-groups/CL1-A,0