Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


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