Hitachi

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


7.39 LUパスの情報を取得する

ポートのホストグループまたはiSCSIターゲットに定義されているLUパスの情報を取得します。
メモ

Namespaceを使用する構成の場合、01-64-03/XX以降のバージョンのRAID Managerをご利用ください。これより前のバージョンでは、Namespaceが設定されたLDEVに関連するパスの情報(運用上使用しない情報)が取得されるおそれがあります。

実行権限

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

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/luns

リクエストメッセージ

オブジェクトID
なし。
クエリパラメータ

パラメータ

フィルタ条件

portId

string

(必須)ポート番号

hostGroupNumber

int

(必須)ホストグループ番号(iSCSIターゲットの場合はターゲットID)

このパラメータまたはhostGroupNumberListパラメータのどちらか一方を必ず指定してください。

isBasicLunInformation

boolean

(任意)基本情報だけを取得するかどうかを指定します。

  • true:基本情報だけを取得する(ホストリザーブの状態は取得しない)
  • false:すべての項目を取得する

省略した場合、falseが指定されたと見なされます。

lunOption

string

(任意)取得する情報を指定します。
  • ALUA:ALUAの設定情報を取得する

hostGroupNumberListと同時に指定した場合、このパラメータは無視されます。

hostGroupNumberList

string

(任意)ホストグループ番号(iSCSIターゲットの場合はターゲットID)

ストレージシステムがVSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP F350、F370、F700、F900の場合に指定できます。

このパラメータを指定すると、高速に情報を取得できます。その場合、hostModeOptions属性の値は取得されません。

複数指定する場合は、コンマで区切ります。

このパラメータまたはhostGroupNumberパラメータのどちらか一方を必ず指定してください。

ボディ

なし。

レスポンスメッセージ

ボディ

基本情報だけを取得した場合の出力例を次に示します。

{
  "data": [
    {
      "lunId": "CL1-A,1,1",
      "portId": "CL1-A",
      "hostGroupNumber": 1,
      "hostMode": "LINUX/IRIX",
      "lun": 1,
      "ldevId": 1,
      "isCommandDevice": false
    },
    {
      "lunId": "CL1-A,1,2",
      "portId": "CL1-A",
      "hostGroupNumber": 1,
      "hostMode": "LINUX/IRIX",
      "lun": 2,
      "ldevId": 2,
      "isCommandDevice": false
    }
  ]
}

すべての項目を取得した場合の出力例を次に示します。

{
  "data": [
    {
      "lunId": "CL1-A,1,1",
      "portId": "CL1-A",
      "hostGroupNumber": 1,
      "hostMode": "LINUX/IRIX",
      "lun": 1,
      "ldevId": 1,
      "isCommandDevice": false,
      "luHostReserve": {
        "openSystem": false,
        "persistent": false,
        "pgrKey": false,
        "mainframe": false,
        "acaReserve": false
      }
    }
  ]
}

属性

説明

lunId

string

LUNのオブジェクトID

portId

string

ポート番号

hostGroupNumber

int

ポート上のホストグループ番号(iSCSIターゲットの場合はターゲットID)

hostMode

string

ホストグループのホストアダプタ設定用のホストモード

取得される値については、ホストグループまたはiSCSIターゲットの設定を変更するAPIの説明を参照してください。

lun

int

ホストグループと、マッピングされているLDEVの間のLUN番号

ldevId

int

LDEV番号

isCommandDevice

boolean

コマンドデバイスであるかどうかを取得します

luHostReserve

object

LUのホストリザーブの状態

isBasicLunInformationにfalseを指定した場合、リザーブ状態のときに、次の属性が表示されます。

  • openSystem(boolean)

    オープンシステムのリザーブ状態であるかを示します。

  • persistent(boolean)

    パーシステントリザーブ状態であるかを示します。

  • pgrKey(boolean)

    PGR Keyでのリザーブ状態であるかを示します。

  • mainframe(boolean)

    Mainframeのリザーブ状態であるかを示します。

  • acaReserve(boolean)

    ACAリザーブであるかを示します。

hostModeOptions

int[]

ホストグループのホストモードオプション設定用の番号

クエリパラメータにhostGroupNumberListを指定している場合は表示されません。

取得される番号については、マニュアルオープンシステム構築ガイド、またはシステム構築ガイドを参照してください。

isAluaEnabled

boolean

ALUAの設定が有効かどうか

クエリパラメータでlunOptionALUAを指定した場合だけ取得されます。

  • true:有効
  • false:無効

asymmetricAccessState

string

ALUA のパスの優先度

クエリパラメータでlunOptionALUAを指定した場合だけ取得されます。

  • Active/Optimized:優先する
  • Active/Non-Optimized:優先しない
  • Not Supported:サポートしていない

ステータスコード

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

すべての項目を取得する場合

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/luns?portId=CL1-A&hostGroupNumber=1"