12.3.3　特定のリモート接続の情報を取得する

実行権限

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

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/remotepath-groups/＜オブジェクトID＞

リクエストメッセージ

オブジェクトID

リモート接続の情報取得で取得したremotepathGroupIdの値を指定します。次のように属性値を連結した形式でも指定できます。

＜remoteSerialNumber＞,＜remoteStorageTypeId＞,＜pathGroupId＞

属性	型	説明
remoteSerialNumber	string	（必須）リモートストレージシステムのシリアル番号
remoteStorageTypeId	string	（必須）リモートストレージシステムのモデルを示すID 指定できる値を次に示します。 R7：Virtual Storage Platform R8：VSP G1000、VSP G1500またはVSP F1500 R9：VSP 5000 シリーズ M7：HUS VM M8：VSP E シリーズ、VSP Gx00 モデルまたはVSP Fx00 モデル
pathGroupId	int	（必須）パスグループID

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ

リモートストレージシステムの情報がREST APIサーバに登録されていない場合の出力例を次に示します。

{
  "remotepathGroupId": "492015,M8,255",
  "remoteSerialNumber": "492015",
  "remoteStorageTypeId": "M8",
  "pathGroupId": 255,
  "remotePaths": [
    {
      "cuType": "REMOTE",
      "portType": "ISCSI",
      "pathNumber": 0,
      "localPortId": "CL3-B",
      "remotePortId": "CL2-C",
      "pathStatus": "ERR_03"
    }
  ]
}

リモートストレージシステムの情報がREST APIサーバに登録されている場合の出力例を次に示します。

{
  "remotepathGroupId": "492015,M8,255",
  "remoteStorageDeviceId": "834000492015",
  "remoteSerialNumber": "492015",
  "remoteStorageModel": "VSP G400",
  "remoteStorageTypeId": "M8",
  "pathGroupId": 255,
  "remotePaths": [
    {
      "cuType": "REMOTE",
      "portType": "ISCSI",
      "pathNumber": 0,
      "localPortId": "CL3-B",
      "remotePortId": "CL2-C",
      "pathStatus": "ERR_03"
    }
  ]
}

属性	型	説明
remotepathGroupId	string	リモート接続のオブジェクトID
remoteStorageDeviceId	string	リモートストレージシステムのストレージデバイスID リモートストレージシステムの情報がREST APIサーバに登録されている場合に表示されます。
remoteSerialNumber	string	リモートストレージシステムのシリアル番号
remoteStorageModel	string	リモートストレージシステムのモデル種別 リモートストレージシステムの情報がREST APIサーバに登録されている場合に表示されます。
remoteStorageTypeId	string	リモートストレージシステムのモデルを示すID R7：Virtual Storage Platform R8：VSP G1000、VSP G1500またはVSP F1500 R9：VSP 5000 シリーズ M7：HUS VM M8：VSP E シリーズ、VSP Gx00 モデルまたはVSP Fx00 モデル
pathGroupId	int	パスグループID
remotePaths	objects[]	次の属性がリモートパスごとに表示されます。 cuType（string） CU 種別 REMOTE：ローカルストレージシステムからリモートストレージシステムにリモートパスを設定している場合 LOCAL：リモートストレージシステムからローカルストレージシステムにリモートパスを設定している場合 portType（string） リモートパスのポートの種別 FIBRE：ファイバーチャネルポート ESCON：ESCONポート ISCSI：iSCSIポート pathNumber（int） パス番号 localPortId（string） MCUのポート番号 remotePortId（string） RCUのポート番号 pathStatus（string） パスの状態 NML_01：正常状態 ERR_02：初期化失敗状態 ERR_03：通信タイムアウト状態 ERR_04：論理閉塞状態 ERR_05：リソース不足状態 ERR_06：シリアル番号不適合状態 ERR_10：無効なポート状態 ERR_80：RCU ポート番号不適合状態 ERR_81：RCU ポートタイプ不適合状態 ERR_82：通信失敗状態 IN_PRG：パスが作成中または削除中の状態

ステータスコード

この操作のリクエストに対するステータスコードについては、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/remotepath-groups/492015,M8,255