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