Hitachi

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

3.3　特定のストレージシステムの情報を取得する

ストレージデバイスIDで指定したストレージシステムについて、詳細な情報を取得します。

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID

ストレージシステムの情報取得で取得したstorageDeviceIdの値を指定します。

属性

型

説明

storageDeviceId

string

（必須）ストレージデバイスID
クエリパラメータ

パラメータ

型

フィルタ条件

detailInfoType

string

（任意）取得する詳細情報のタイプ

  • version

    ストレージシステム、コントローラ1、コントローラ2のマイクロコードの詳細な情報を追加します。

ストレージシステムがVirtual Storage PlatformまたはHUS VMの場合は指定できません。
ボディ

なし。

レスポンスメッセージ

ボディ

VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合

VSP G900の出力例を次に示します。

{
  "storageDeviceId" : "886000123456",
  "model" : "VSP G900",
  "serialNumber" : 123456,
  "svpIp" : "192.0.2.100",
  "mappWebServerHttpsPort" : 443,
  "rmiPort" : 1099,
  "ctl1Ip" : "192.0.10.10",
  "ctl2Ip" : "192.0.10.11",
  "dkcMicroVersion" : "88-02-00/20",
  "communicationModes" : [ {
    "communicationMode" : "lanConnectionMode"
  } ],
  "isSecure" : true,
  "lanConnectionProtocol" : "DTLS SVP",
  "targetCtl" : "CTL1",
  "usesSvp" : true
}

属性

型

説明

storageDeviceId

string

ストレージデバイスID

model

string

ストレージシステムのモデル名

serialNumber

int

ストレージシステムのシリアル番号

usesSvp

boolean

SVPと連携するかどうか

  • true：連携する
  • false：連携しない

svpIp

string

SVPのIPアドレス

usesSvp属性がtrueの場合に表示されます。

rmiPort

int

Configuration Manager REST APIサーバとストレージシステム間のRMI通信で使用するポート番号

usesSvp属性がtrueの場合に表示されます。

mappWebServerHttpsPort

int

SVPがHTTPS通信で使用するポート番号

usesSvp属性がtrueの場合に表示されます。

ctl1Ip

string

ストレージシステムのコントローラ1のIPアドレス

ctl2Ip

string

ストレージシステムのコントローラ2のIPアドレス

targetCtl

string

REST APIが操作対象とするコントローラ

  • CTL1：コントローラ1
  • CTL2：コントローラ2

dkcMicroVersion

string

ストレージシステムのマイクロコードのバージョン

communicationModes

object[]

通信モードの配列

REST APIサーバとストレージシステムの通信モードについて次の属性が表示されます。

  • communicationMode（string）

    通信モード

    • fcConnectionMode
    • lanConnectionMode

isSecure

boolean

REST APIサーバとストレージシステム間のSSL通信の設定

  • true：SSL通信が有効

lanConnectionProtocol

string

REST APIサーバとストレージシステム間のSSL通信で使用する暗号化通信方式

  • DTLS SVP

usesSvp属性がtrueの場合に表示されます。

VSP 5000 シリーズ、VSP G100、G200、G400、G600、G800、VSP G1000、VSP G1500、VSP F400、F600、F800、VSP F1500、Virtual Storage Platform、Unified Storage VMの場合

VSP G400の出力例を次に示します。

{
  "storageDeviceId" : "834000123456",
  "model" : "VSP G400",
  "serialNumber" : 123456,
  "svpIp" : "192.0.2.100",
  "mappWebServerHttpsPort":443,
  "rmiPort" : 1099,
  "ctl1Ip": "192.0.10.10",
  "ctl2Ip": "192.0.10.11",
  "dkcMicroVersion" : "83-02-01/96",
  "communicationModes": [
    {
      "communicationMode": "proxyMode",
      "proxies": [
        {
          "proxyIp": "192.0.2.101",
          "proxyPort": 2010
        },
        {
          "proxyIp": "192.0.2.102",
          "proxyPort": 2011
        }
      ]
    },
    {
      "communicationMode": "lanConnectionMode"
    }
  ],
  "isSecure": false
}

属性

型

説明

storageDeviceId

string

ストレージデバイスID

model

string

ストレージシステムのモデル名

serialNumber

int

ストレージシステムのシリアル番号

svpIp

string

SVPのIPアドレス

rmiPort

int

Configuration Manager REST APIサーバとストレージシステム間のRMI通信で使用するポート番号

このポートは、セッションの生成やユーザ管理のAPIで使用されます。

mappWebServerHttpsPort

int

SVPがHTTPS通信で使用するポート番号

このポートは、REST APIサーバとストレージシステム間でSSL通信をする場合に使用されます。

VSP G100、G200、G400、G600、G800、VSP F400、F600、F800の場合に表示されます。

ctl1Ip

string

ストレージシステムのコントローラ1のIPアドレス

VSP G100、G200、G400、G600、G800、VSP F400、F600、F800の場合に表示されます。

ctl2Ip

string

ストレージシステムのコントローラ2のIPアドレス

VSP G100、G200、G400、G600、G800、VSP F400、F600、F800の場合に表示されます。

dkcMicroVersion

string

ストレージシステムのマイクロコードのバージョン

communicationModes

object[]

通信モードの配列

配列の先頭要素から順番に優先して通信をします。

REST APIサーバとストレージシステムの通信モードについて次の属性が表示されます。

  • communicationMode（string）

    通信モード

    • proxyMode
    • fcConnectionMode
    • lanConnectionMode

  • proxies（object[]）

    中継用サーバの配列

    communicationMode属性がproxyModeの場合、次の属性が表示されます。

    • proxyIp（string）

      中継用サーバのIPアドレス

    • proxyPort（int）

      中継用サーバのポート番号

isSecure

boolean

REST APIサーバとストレージシステム間のSSL通信の設定

  • true：SSL通信が有効
  • false：SSL通信が無効

lanConnectionProtocol

string

REST APIサーバとストレージシステム間のSSL通信で使用する暗号化通信方式

isSecure属性がtrueの場合に表示されます。

VSP G100、G200、G400、G600、G800、VSP F400、F600、F800の場合に表示されます。

クエリパラメータでdetailInfoTypeにversionを指定して実行すると、ストレージシステムのマイクロコードの詳細情報も取得されます。

{
  "storageDeviceId": "886000123456",
  "model": "VSP G900",
  "serialNumber": 123456,
  "ctl1Ip" : "192.0.10.10",
  "ctl2Ip" : "192.0.10.11",
  "dkcMicroVersion": "88-01-01/82",
  "detailDkcMicroVersion": "88-01-01-60/82",
  "ctl1MicroVersion" : "88-01-01/81",
  "ctl2MicroVersion" : "88-01-01/81",
  "communicationModes": [
    {
      "communicationMode": "lanConnectionMode"
    }
  ],
  "isSecure": true
}

属性

型

説明

detailDkcMicroVersion

string

ストレージシステムのマイクロコードのバージョン

モデル識別情報を含みます。

ctl1MicroVersion

string

コントローラ1のGUMのバージョン

VSP E シリーズ、VSP Gx00 モデルおよびVSP Fx00 モデルの場合に表示されます。

コントローラ1のGUMに障害が発生している場合は取得されません。

ctl2MicroVersion

string

コントローラ2のGUMのバージョン

VSP E シリーズ、VSP Gx00 モデルおよびVSP Fx00 モデルの場合に表示されます。

コントローラ2のGUMに障害が発生している場合は取得されません。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/834000123456

関連項目

ページの先頭へ

All Rights Reserved. Copyright© 2016, 2021, Hitachi, Ltd.