16.5 外部パリティグループの情報を取得する
外部パリティグループの情報の一覧を取得します。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/simple/v1/objects/external-parity-groups
リクエストメッセージ
- オブジェクトID
- なし。
- クエリパラメータ
-
1回のリクエストで取得できる外部パリティグループの情報は最大で200個です。201個以上の外部パリティグループの情報を取得する場合は、countパラメータとstartIndexパラメータを組み合わせて複数回に分けてAPIを実行してください。countパラメータを指定することで取得する外部パリティグループの情報をフィルタリングすることもできます。
パラメータ
型
フィルタ条件
startIndex
int
(任意)取得を開始する外部パリティグループのインデックス番号を0~65535の値で指定します。
count
int
(任意)取得する外部パリティグループの情報の個数を1~200の値で指定します。
省略した場合、200が指定されたと見なされます。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
{ "data": [ { "id": "1-500", "status": "Normal", "externalPathGroupId": 500, "externalPath": [ { "portId": "CL5-A", "portProtocol": "FC", "externalPortWwn": "50060e8012000c60", "lun": 1754, "status": "Normal" } ], "index": 2073 }, { "id": "9-1200", "status": "Normal", "externalPathGroupId": 1200, "externalPath": [ { "portId": "CL1-B", "portProtocol": "iSCSI", "externalPortIpAddress": "10.1.2.122", "externalPortIscsiName": "iqn.1994-04.jp.co.hitachi:rsd.h8m.t.00012.2d011", "externalTcpPortNumber": 3260, "lun": 1200, "virtualPortNumber": 1, "status": "Normal" } ], "index": 2274 } ], "count": 2, "totalCount": 2, "hasNext": false }
属性
型
説明
id
string
外部パリティグループID
status
string
外部パリティグループの状態
- Normal:正常
- Checking:外部パスの状態を確認中
- Cache Destaging:キャッシュ内のデータをボリュームに書き込み中
- Disconnect:外部パスが未接続
- Blockade:外部パスが閉塞
- Warning:外部パスの一部に問題がある
- Unknown:不明
externalPathGroupId
int
外部パスグループID
externalPath
object[]
外部パリティグループ内の外部パスの情報が、外部パスごとに出力されます。
- portId(string)
外部接続用のポートID
- portProtocol(string)
ポートのプロトコル
- FC
- iSCSI
- externalPortWwn(string)
外部ストレージシステムのポートのWWN
iSCSIポートの場合、この属性は出力されません。
- externalPortIpAddress(string)
外部ストレージシステムのポートのIPアドレス
IPv4またはIPv6形式で出力されます。
FCポートの場合、この属性は出力されません。
- externalPortIscsiName(string)
外部ストレージシステムのポートのiSCSIターゲット名
FCポートの場合、この属性は出力されません。
- externalTcpPortNumber(int)
外部ストレージシステムのポートのTCPポート番号
FCポートの場合、この属性は出力されません。
- virtualPortNumber(int)
外部接続用のポートの仮想ポート番号
次の場合、この属性は出力されません。
- FCポートの場合
- iSCSIポートの場合で、仮想ポートが無効のとき
- lun(int)
外部ストレージシステムのポートに割り当てられているLUN
外部パスの状態が不明(Unknown)の場合、この属性は出力されません。
- status(string)
外部パスの状態
- Normal:正常
- Disconnect:未接続
- Temporary Blockade:ポートが閉塞(一時閉塞)
- Blockade:閉塞
- Unknown:不明
index
int
外部パリティグループのインデックス番号
ステータスコード
この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X GET https://192.0.2.100/ConfigurationManager/simple/v1/objects/external-parity-groups