Hitachi

Hitachi Storage Advisor Embedded ガイド 


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

外部パリティグループの情報の一覧を取得します。

実行権限

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

リクエストライン

GET <ベースURL>/simple/v1/objects/external-parity-groups

リクエストメッセージ

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

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

パラメータ

フィルタ条件

startIndex

int

(任意)取得を開始する外部パリティグループのインデックス番号を065535の値で指定します。

count

int

(任意)取得する外部パリティグループの情報の個数を1200の値で指定します。

省略した場合、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