Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


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

ポートのホストグループ番号またはiSCSIターゲットのターゲットIDを指定して情報を取得します。

実行権限

ストレージ管理者(参照)

リクエストライン

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