7.39　LUパスの情報を取得する : Hitachi Command Suite Configuration Manager REST API リファレンスガイド

メモ: 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、G900、VSP 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の設定が有効かどうかクエリパラメータで`lunOption`に`ALUA`を指定した場合だけ取得されます。 `true`：有効 `false`：無効
asymmetricAccessState	string	ALUA のパスの優先度クエリパラメータで`lunOption`に`ALUA`を指定した場合だけ取得されます。 `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"

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

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