16.7 外部ストレージシステムのポートの一覧を取得する
- メモ
-
-
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