16.5　外部パリティグループの情報を取得する

実行権限

ストレージ管理者（参照）

リクエストライン

GET ＜ベースURL＞/simple/v1/objects/external-parity-groups

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

1回のリクエストで取得できる外部パリティグループの情報は最大で500個です。501個以上の外部パリティグループの情報を取得する場合は、countパラメータとstartIndexパラメータを組み合わせて複数回に分けてAPIを実行してください。countパラメータを指定することで取得する外部パリティグループの情報をフィルタリングすることもできます。

パラメータ	型	フィルタ条件
startIndex	int	（任意）取得を開始する外部パリティグループのインデックス番号を0～65535の値で指定します。
count	int	（任意）取得する外部パリティグループの情報の個数を1～500の値で指定します。 省略した場合、500が指定されたと見なされます。

ボディ

なし。

レスポンスメッセージ

ボディ

{
    "data": [
        {
            "id": "9-400",
            "status": "Normal",
            "externalPathGroupId": 400,
            "externalPath": [
                {
                    "portId": "CL5-A",
                    "portProtocol": "FC",
                    "externalPortWwn": "50060e8012000c60",
                    "lun": 5,
                    "status": "Normal"
                },
                {
                    "portId": "CL6-A",
                    "portProtocol": "FC",
                    "externalPortWwn": "50060e8012000c70",
                    "lun": 6,
                    "status": "Normal"
                }
            ],
            "index": 2050
        }
    ],
    "count": 1,
    "totalCount": 1,
    "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ポートの場合、この属性は出力されません。 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