7.39 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、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:サポートしていない
- openSystem(boolean)
ステータスコード
この操作のリクエストに対するステータスコードについては、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"