7.29　iSCSIネームを取得する : Hitachi Command Suite Configuration Manager REST API リファレンスガイド

メモ: このAPIは、HUS VMの場合は使用できません。

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID: なし。

クエリパラメータ

パラメータ	型	フィルタ条件
portId	string	（必須）ポート番号
hostGroupNumber	int	（任意）iSCSIターゲットのターゲットID このパラメータ、`hostGroupName`パラメータ、または`hostGroupNumberList`パラメータのどれか1つを必ず指定してください。
hostGroupName	string	（任意）iSCSIターゲットの名称このパラメータ、`hostGroupNumber`パラメータ、または`hostGroupNumberList`パラメータのどれか1つを必ず指定してください。
hostGroupNumberList	string	（任意）iSCSIターゲットのターゲットID ストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に指定できます。このパラメータを指定すると、高速に情報を取得できます。複数指定する場合は、コンマで区切ります。このパラメータ、`hostGroupNumber`パラメータ、または`hostGroupName`パラメータのどれか1つを必ず指定してください。
displayHostGroupName	boolean	（任意）`hostGroupNumberList`パラメータを指定した場合にiSCSIターゲット名（`hostGroupName`属性の値）を取得するかどうかストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に指定できます。 `false`を指定すると、`true`を指定する場合よりも取得する処理が速くなります。 `true`：iSCSIターゲット名を取得する `false`：iSCSIターゲット名を取得しない `hostGroupNumberList`パラメータが指定されていない場合にこのパラメータを指定しても無視されます。省略した場合、`true`が指定されたと見なされます。

ボディ: なし。

レスポンスメッセージ

ボディ

{
  "data": [
    {
      "hostIscsiId": "CL1-D,1,iqn.1994-05.com.redhat%3A496799ba93",
      "portId": "CL1-D",
      "hostGroupNumber": 1,
      "hostGroupName": "1D-G00",
      "iscsiName": "iqn.1994-05.com.redhat:496799ba93",
      "iscsiNickname": "a_a"
    },
    {
      "hostIscsiId": "CL1-D,1,iqn.1994-05.com.redhat%3Aa7526e46aac.target",
      "portId": "CL1-D",
      "hostGroupNumber": 1,
      "hostGroupName": "1D-G00",
      "iscsiName": "iqn.1994-05.com.redhat:a7526e46aac.target",
      "iscsiNickname": "a_a"
    }
  ]
}

属性	型	説明
hostIscsiId	string	iSCSIネームのオブジェクトID
portId	string	ポート番号
hostGroupNumber	int	iSCSIターゲットのターゲットID
hostGroupName	string	iSCSIターゲットの名称クエリパラメータに`hostGroupNumberList`パラメータを指定し、かつ、`displayHostGroupName`パラメータに`false`を指定した場合は取得されません。
iscsiName	string	iSCSIターゲットに登録されているHBA（iSCSIイニシエータ）のiSCSIネーム
iscsiNickname	string	iSCSIのニックネーム

ステータスコード

この操作のリクエストに対するステータスコードについては、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/836000123456/host-iscsis?portId=CL1-D&hostGroupNumber=1"

7.29 iSCSIネームを取得する

7.29　iSCSIネームを取得する