16.7　外部ストレージシステムのポートの一覧を取得する : Hitachi Command Suite Configuration Manager REST API リファレンスガイド

メモ

iSCSIポートの場合に、対象のiSCSIポートに接続できないiSCSIターゲットが登録されていると、ネットワークや外部ストレージシステムに負荷がかかり情報取得に失敗するおそれがあります。iSCSIネームの登録後は必ずログインテストを実行し、ログインできることを確認してください。
ローカルストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP Fx00 モデルの場合、外部接続用のポートを、外部ストレージシステムからローカルストレージシステムに対するI/Oパスの終点として使用しているとき、I/Oパスが切断されるおそれがあります。外部パスとして使用できる経路を使用してください。外部パスに関する詳細については、マニュアルUniversal Volume Managerユーザガイドを参照してください。

実行権限

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

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/external-storage-ports

リクエストメッセージ

オブジェクトID: なし。

クエリパラメータ

パラメータ	型	フィルタ条件
portId	string	（必須）ローカルストレージシステム側のポート番号

ボディ: なし。

レスポンスメッセージ

ボディ

ファイバーチャネルポートの場合のコード例を次に示します。

{
  "data" : [ {
    "externalWwn" : "50060e80222fd141",
    "portId" : "CL7-A",
    "externalSerialNumber" : "477777",
    "externalStorageInfo" : "HITACHI VSP Gx00",
    "externalPathMode" : "Multi",
    "externalIsUsed" : false
  } ]
}

iSCSIポートの場合のコード例を次に示します。

{
  "data" : [ {
    "portId" : "CL2-D",
    "externalSerialNumber" : "477777",
    "externalStorageInfo" : "HITACHI VSP Gx00",
    "externalPathMode" : "Multi",
    "externalIsUsed" : true,
    "iscsiIpAddress" : "192.0.1.100",
    "iscsiName" : "iqn.rest.example.of.iscsi1",
    "virtualPortId" : 0
  } ]
}

属性	型	説明
portId	string	ローカルストレージシステム側のポート番号
externalWwn	string	外部ストレージシステム側のポートのWWN ファイバーチャネルポートの場合に表示されます。
iscsiIpAddress	string	外部ストレージシステム側のiSCSIターゲットのIPアドレス iSCSIポートの場合に表示されます。
iscsiName	string	外部ストレージシステム側のiSCSIターゲットのiSCSIネーム iSCSIポートの場合に表示されます。
virtualPortId	int	仮想ポートID iSCSIポートで、仮想ポートモードが有効な場合に表示されます。
externalSerialNumber	string	外部ストレージシステムのシリアル番号
externalStorageInfo	string	外部ストレージシステムのVENDOR情報およびプロダクトID VENDOR情報とプロダクトIDをスペースで連結した形式で取得します。
externalPathMode	string	外部ストレージシステム側のポートの外部パスのパスモード `Multi`：Multiモード `Single`：Singleモード `APLB`：APLBモード
externalIsUsed	boolean	ローカルストレージシステムに外部接続している外部ストレージシステムのポートを外部ボリュームのマッピングに使用しているかどうかが表示されます。 `true`：使用している `false`：使用していない

ステータスコード

この操作のリクエストに対するステータスコードについては、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/886000123457/external-storage-ports?portId=CL7-A

16.7 外部ストレージシステムのポートの一覧を取得する

16.7　外部ストレージシステムのポートの一覧を取得する