Host情報の取得

GET /host/{host_id}

概要説明

Hostの情報を取得します。

注意

FC Host、iSCSI Hostの情報のみ応答します。

リクエスト例

  • Host ID 2 のFC Hostについて、情報を取得する場合の例です。

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/host/2"

レスポンス例

{
  "host": {
    "host_id": 65792,
    "host_href": "/api/v1/host/65792",
    "type": "iSCSI",
    "number": 256,
    "name": "HBA#1",
    "iscsi_name": "iqn.1991-05.com.microsoft",
    "alias_name": "IQN-DXL",
    "ip_version": "IPv4",
    "ip_address": "192.168.1.10",
    "chap_user": "host_user1",
    "host_response_name": "Default",
    "is_shared_host_exist": false
  }
}

Parameters

PATH PARAMETERS

host_id

(required)

integer

Host ID。

QUERY PARAMETERS

fields

Array of strings

表示したいParameter。

指定したParameter名(Response Body Parameter)の情報のみを抜き出して取得します。

指定方法の詳細は、表示する項目の絞り込みを参照してください。

Responses

正常に取得できた場合、HTTPステータスコードが200 (OK)となりレスポンスボディを応答します。

RESPONSE BODY

host

object

host_id

integer

Host ID。
host_href

string

Host ResourceへのLink。
type

string

Hostタイプ。
項目 説明
FC FC Host
iSCSI iSCSI Host
number

integer

Host Number。

ETERNUS Web GUI またはETERNUS CLIで使われるHostの識別子です。
name

string

Host名。
status

string

ステータス。
項目 説明
Unused 未使用のHostです。
Normal 接続中のVolumeがすべてNormalです。
Maintenance 接続中のVolumeにMaintenanceのものが存在、かつErrorまたはWarningのVolumeが存在しません。
Warning 接続中のVolumeにWarningのものが存在、かつErrorのVolumeが存在しません。
Error 接続中のVolumeにErrorのVolumeが存在します。
wwn

string

FC HostのWWN。

FC以外の場合は応答しません。
iscsi_name

string

iSCSI HostのiSCSI Name。

iSCSI以外の場合は応答しません。
alias_name

string

iSCSI Nameに対応するAlias Name。

iSCSI以外の場合は応答しません。

設定されていない場合は空文字を応答します。
ip_version

string

iSCSI HostのIP形式。

iSCSI以外の場合は応答しません。
項目 説明
IPv4 IPv4形式
IPv6 IPv6形式
ip_address

string

iSCSI HostのIPアドレス。

iSCSI以外の場合は応答しません。

設定されていない場合は空文字を応答します。

この場合、任意のIPアドレスからのアクセスを許可します。
chap_user

string

CHAP認証のユーザー名。

iSCSI以外の場合は応答しません。

設定されていない場合は空文字を応答します。
host_response_name

string

Hostに割り当てられているHost Response Name。
is_shared_host_exist

boolean

同じLUN Groupを共有しているHostがあるかどうか。

trueの場合、同じLUN Groupを共有しているHostが存在します。
maximum_hlun_count

integer

接続可能な最大Volume数。

Host Responseで許容された最大HLUN数を応答します。

LUN AddressingがFlat Space Addressingの場合、4096を応答します。

LUN AddressingがPeripheral Device Addressing、かつLUN数拡張モードが有効の場合、4096を応答します。

LUN AddressingがPeripheral Device Addressing、かつLUN数拡張モードが無効の場合、256を応答します。